Creating Agent Skills

Purpose

Create skills that another agent can reliably select and use. Keep each skill concise, task-focused, and grounded in the workflow it teaches.

Workflow

1. Clarify the target only when needed.

   • Infer the destination from the current repo or explicit path when possible.
   • Ask at most one question if the skill's trigger condition or destination is genuinely ambiguous.
   • Treat user-provided requirements, naming rules, and examples as authoritative.

2. Choose the name.

   • Use lowercase letters, meaningful digits, and hyphens.
   • Avoid leading, trailing, or consecutive hyphens.
   • Prefer short, action-oriented names such as <verb-ing>-<object>.
   • Avoid vague names like helper, utils, tools, assistant, general, data, files, and documents.
   • Keep the folder name exactly equal to the frontmatter name.