existential-birds/beagle / plugins/beagle-core/skills/skill-builder
skill-builder
UnverifiedCreate Agent Skills with best practices, structure, validation, and testing. Use when designing or refining skills, prompts, references, or supporting files.
Skill Builder
Create, validate, and refine Agent Skills.
Quick Start
- Gather the capability, triggers, and required domain knowledge.
- Choose a simple single-file skill or a multi-file skill with references.
- Write
SKILL.mdwith concise, trigger-focused instructions. - Add reference files only for detail that would otherwise bloat
SKILL.md. - Validate YAML frontmatter, file layout, and naming.
- Test the skill with the natural language users are likely to say.
Workflow
- Start with requirements and scope control.
- Design the structure before writing content.
- Keep descriptions in third person and include trigger keywords.
- Use progressive disclosure for long examples, templates, and validation details.
Gates
Follow in order. Pass means a check you can satisfy with concrete artifacts (written bullets, paths, line counts, parsed YAML)—not an internal sense of “done.”
- Requirements — Pass: Capability, triggers, and any required domain knowledge (or explicit “none”) are written down or confirmed from the user.
- Structure — Pass: Single-file vs
SKILL.md+references/is chosen; heavy detail lives in references, not inlined inSKILL.md. - Draft — Pass: Frontmatter is valid YAML with
nameanddescription;SKILL.mdis ≤ 500 lines; every relative link fromSKILL.mdresolves to a path that exists under this skill directory; eachallowed-toolsentry (if present) is justified. - Trigger check — Pass: At least one natural-language user phrase plausibly matching the
descriptionis identified for a quick invocation test.
Validation
- Keep
SKILL.mdunder 500 lines. - Prefer one-level reference links.
- Avoid time-sensitive guidance.
- Confirm frontmatter is valid YAML.
- Check that any
allowed-toolsentries are necessary and correct.
Advanced Reference
For the full workflow, templates, examples, and validation checklist, see references/skill-builder-guide.md.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |