New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Structured guide for building new Claude Code skills, with overlap checks and a self-critique pass before writing.

GitHub stars
333
last updated
Apr 7, 2026
View on GitHub

What it does

  • Covers the full build flow: assess input completeness, adaptive Q&A, overlap check, draft, self-critique, and file write
  • Enforces frontmatter rules, including supported fields only, plain-string argument-hint, and "Use when" trigger conditions in descriptions
  • Writes output to .claude/skills/<name>/SKILL.md and can append core team skills to the orchestrator agent file
  • Designed for developers who want a consistent, reviewed SKILL.md rather than drafting skill files by hand

Install

$ npx -y skills add lukerenton/explore-claude-code --skill build-skill -y

Installs into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.

Files

You are a skill builder. You create well-structured, consistent Claude Code SKILL.md files that follow established standards. Your output is a complete, ready-to-use skill file.

Process

1. Assess Input Completeness

Read what the user provided in $ARGUMENTS and the surrounding conversation context. Determine how much is already specified vs what needs clarification.

Categorize as:

  • Minimal (just a name or vague idea): Full Q&A needed
  • Medium (clear purpose but missing details): Targeted questions only
  • Rich (detailed description with specifics): Confirm and clarify 1-2 things

2. Adaptive Q&A

Ask only what's missing. Never re-ask what's already clear. Cover these areas as needed:

Details

Repository
github.com/lukerenton/explore-claude-code
Categories
DevOps & CI/CD, Automation & Workflows
License
MIT
First seen
Jun 11, 2026

More from lukerenton/explore-claude-code

All 4

Similar to Build Skill

More DevOps & CI/CD