skill-creator

name	skill-creator
description	Use when creating, updating, pruning, or reviewing a SKILL.md so recurring workflows become concise, reusable agent skills.

Skill Creator

Use this skill to turn repeated work into a small, useful SKILL.md.

When To Create A Skill

Create or update a skill only when:

• The workflow repeats across projects.
• The agent needs domain-specific steps, tools, or constraints.
• The instructions are stable enough to reuse.
• The skill will be smaller and clearer than explaining the workflow every time.

Do not create a skill for one-off tasks or generic advice the agent already knows.

Required Shape

Every skill directory needs:

skill-name/
  SKILL.md

Every SKILL.md needs YAML frontmatter:

---
name: skill-name
description: Use when ...
---

The description is the trigger surface. Make it specific enough that the agent knows when to use the skill.

Writing Rules

• Keep the body concise.
• Put only essential workflow instructions in SKILL.md.
• Prefer checklists and decision rules over long background.
• Add scripts only when deterministic execution matters.
• Add references only when details are too large for the main file.
• Do not add extra docs like README.md inside a skill unless the platform requires it.

Review Checklist

Before finishing, check:

• The skill has name and description.
• The trigger is neither too broad nor too narrow.
• The workflow is actionable without extra context.
• The skill does not duplicate another existing skill.
• Examples do not include secrets, private URLs, or broad permissions.

Output

Report the skill path, trigger summary, and any assumptions or future pruning notes.