{
  "edition": {
    "edition": "2026-09-06-draft-01",
    "language": "en",
    "publicationState": "published",
    "sourceRevision": "a7e788eb4b151fd92c1f58153e015773e3a829af",
    "projectCount": 67,
    "documentCount": 94,
    "skillCount": 10,
    "archivePath": "library.zip",
    "archiveBytes": 181812,
    "releasedAt": "2026-09-08T05:03:11.129+00:00"
  },
  "access": {
    "released": true,
    "rehearsal": false
  },
  "project": "agent-capabilities/routine-to-skill.md",
  "markdown": "https://legion.tw/api/projects/packet.md/agent-capabilities/routine-to-skill.md?edition=2026-09-06-draft-01",
  "documents": [
    {
      "path": "agent-capabilities/README.md",
      "text": "# Tools, skills, and plugins for the agent\n\n[All project types](../README.md) · [Shared launch](../shared/launch.md)\n\nExtend the coding agent's own working environment. The [shared skill package](../shared/skills.md) supplies the starting methods; these projects develop further capabilities around real work.\n\n## Projects to build\n\n- [Turn a working routine into a skill](routine-to-skill.md)\n- [Give the agent tools for an application](application-tools.md)\n- [Let the agent consult another model's abilities](model-consultation.md)\n- [Give the agent a continuing project notebook](project-notebook.md)\n- [Give the agent an ongoing responsibility](ongoing-responsibility.md)\n- [Package an agent capability for someone else](share-agent-capability.md)\n\nThese are instructions for projects you can build with your coding agent.\n"
    },
    {
      "path": "agent-capabilities/routine-to-skill.md",
      "text": "# Turn a working routine into a skill\n\nTurn a useful routine the person and their coding agent have worked out together into an installed, reusable skill. Build it extremely well. The next session should benefit from what they already learned about doing this particular job. Follow the [shared launch](../shared/launch.md) and use the agent environment's current skill-authoring and installation capabilities.\n\nChoose a real routine with a result the person values: preparing their recurring report, handling a supplier's spreadsheet, or turning lesson notes into tomorrow's material. If the routine is still being discovered, work through it first and preserve the understanding that actually helped.\n\n## Recover why the routine works\n\nLook at a successful example and the decisions behind it. Learn what the person needs from the result, which source material matters, and which judgments made the work good. Separate the repeatable method from details belonging to that one occasion.\n\nFor a photo report, the useful knowledge may include why the recipient needs an overview before close-ups, how observations relate to images, and what makes the finished document ready to send. For an import, it may concern matching existing records while preserving information someone already added.\n\nUse that understanding to decide what belongs in the skill, what belongs in a reusable template or helper, and what the agent should discover from the current task. Preserve the original successful work as an example where it will help future use.\n\n## Give the skill a clear job\n\nWrite for the capable agent already working with the person. Explain the purpose, when the method applies, the useful working sequence, and the judgment behind consequential choices. Use positive direction and leave the agent room to adapt to the actual material.\n\nMake the skill's scope recognizable enough that it is invoked for relevant work. Keep application records, current assignments, and changing personal details in their owning project sources, with appropriate references from the skill.\n\nInclude supporting resources that genuinely reduce repeated work. A report template, a representative input, or an established deterministic conversion can be more useful than another paragraph of instructions. Make each resource's purpose apparent.\n\n## Install it where the agent can use it\n\nInspect the environment's supported skill mechanism and existing equivalents. Preserve useful installed guidance and the agent's established identity. Choose a suitable project-local or personal scope for this method and install it through the normal supported route.\n\nMake the skill discoverable in an actual subsequent session. Explain in plain language how the person can request it, where its editable source lives, and how it relates to the instructions already in their project.\n\nKeep machine-specific access and private material appropriately local. If the person later shares the method, those details should be easy to identify and replace with what belongs to the recipient.\n\n## Use it on another real example\n\nSave the first draft, then examine that fixed text in a later pass for clarity, scope, and unnecessary restrictions. Keep sound instructions as they are. Exercise the installed skill on another instance of the job, including a variation that requires judgment.\n\nCompare the result with the purpose of the routine. Did the agent retain what mattered? Did the person have to explain the same important decision again? Improve the skill where that experience reveals a real omission and preserve useful local adaptations.\n\nTeach how a skill carries a learned method into future work. Leave the person able to find it, refine it with their agent, and apply the same process when another successful routine emerges.\n"
    }
  ]
}