skill-creator

Skill Creator

A skill for creating new skills and iteratively improving them.

At a high level, the process of creating a skill goes like this:

• Decide what you want the skill to do and roughly how it should do it
• Write a draft of the skill
• Create a few test prompts and run the agent with access to the skill on them
• Help the user evaluate the results both qualitatively and quantitatively
  • While the runs happen in the background, draft some quantitative evals if there aren't any. Explain them to the user.
  • Use bun run skills/skill-creator/eval-viewer/generate_review.ts to show the user the results, and let them review both qualitative and quantitative metrics
• Rewrite the skill based on feedback from the user's evaluation of the results
• Repeat until you're satisfied
• Expand the test set and try again at larger scale

Your job is to figure out where the user is in this process and help them progress through these stages.

OpenCode Skill Conventions

OpenCode skills follow the agentskills.io specification:

Frontmatter

• name (required): lowercase alphanumeric + single hyphens, 1-64 chars. Must match the directory name. Regex: ^[a-z0-9]+(-[a-z0-9]+)*$
• description (required): 1-1024 chars. Describe what it does AND when to trigger. Written in third person. Use the pattern "What it does. Use when [specific triggers]."
• compatibility (optional): e.g., opencode
• metadata (optional): string-to-string map for extra metadata

Discovery

OpenCode discovers skills from these locations:

• .opencode/skills/<name>/SKILL.md
• ~/.config/opencode/skills/<name>/SKILL.md
• .claude/skills/<name>/SKILL.md, ~/.claude/skills/<name>/SKILL.md
• .agents/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md
• Plugin-injected paths via config.skills.paths

Loading mechanism

Skills appear in the skill tool's <available_skills> block. The agent reads descriptions and invokes the skill tool to load a skill. After the iteration loop is complete and the skill is ready, offer to package it.