Agent Skills

Problem

Stuffing every workflow into one system prompt pushes context past tens of thousands of tokens and the agent still skips steps or blends procedures together. The alternative of dropping ad-hoc prompt files into the repository leaves the team with no clean way to version, review, or roll back individual procedures, and no clear story for how the agent decides which one applies to the current task.

Solution

Package each procedure as a markdown file (and optional companion resources) under a known directory. The agent loads relevant skills on demand based on the current task. Skills are author-time artefacts versioned with the agent.

When to use

• You have many distinct procedures and stuffing them all into the system prompt would bloat context.
• Procedures are author-time artefacts that benefit from versioning alongside the agent.
• The agent can reliably classify which procedure applies to the current task.