Beagle skill-builder

Create Claude Code skills with best practices, structure, validation, and testing. Use when designing or refining skills, prompts, references, or supporting files.

install

source · Clone the upstream repo

git clone https://github.com/existential-birds/beagle

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/existential-birds/beagle "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/beagle-core/skills/skill-builder" ~/.claude/skills/existential-birds-beagle-skill-builder && rm -rf "$T"

manifest: plugins/beagle-core/skills/skill-builder/SKILL.md

source content

Skill Builder

Create, validate, and refine Claude Code 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.md
```
with 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.

Validation

Keep
```
SKILL.md
```
under 500 lines.
Prefer one-level reference links.
Avoid time-sensitive guidance.
Confirm frontmatter is valid YAML.
Check that any
```
allowed-tools
```
entries are necessary and correct.

Advanced Reference

For the full workflow, templates, examples, and validation checklist, see references/skill-builder-guide.md.