USE WHEN: user asks to create a skill, scaffold a new capability, codify expertise into reusable instructions, or says "create skill", "new skill", "make a skill". DO NOT USE WHEN: user wants to use existing skills, needs general help, or is asking about skill concepts rather than creating one.
View on GitHubmahidalhan/claude-hacks
skill-creator
January 22, 2026
Select agents to install to:
npx add-skill https://github.com/mahidalhan/claude-hacks/blob/main/skills/skill-creator/skills/skill-creator/SKILL.md -a claude-code --skill skill-creatorInstallation paths:
.claude/skills/skill-creator/This skill guides creation of exceptional Claude skills that avoid vague "be helpful" platitudes. Write deterministic instructions that produce consistent, high-quality outputs regardless of how many times they're invoked.
The user provides skill requirements: a domain to codify, an expertise to capture, a workflow to standardize, or a quality bar to enforce. They may include context about the target audience, existing patterns, or specific anti-patterns to avoid.
## Skill Thinking
Before writing any instructions, understand the expertise and commit to a DETERMINISTIC structure:
- **Domain**: What specific capability does this skill enable? What's the transformation from input to output?
- **Anti-patterns**: What does BAD output look like? Name it. ("AI slop", "tests as afterthought", "wall of boxes")
- **Quality Bar**: What separates excellent from mediocre? Be specific—vague quality is no quality.
- **Decision Points**: Where does the practitioner make choices? Codify the decision tree explicitly.
**CRITICAL**: Skills must be deterministic, not aspirational. Every instruction should constrain output. If two different Claude instances reading your skill could produce wildly different results, the skill has failed. Specificity over generality. Always.
Then write a skill file that is:
- Structured—follows the canonical 11-section format exactly
- Actionable—every sentence changes behavior, no filler
- Opinionated—takes strong positions, names anti-patterns explicitly
- Concise—40-45 lines total, ~5 bullet points per section
## Skill Excellence Guidelines
Focus on:
- **Frontmatter**: YAML header with `name` (kebab-case), `description` (when to use, what it produces), `license`. Description should contain trigger phrases ("when the user asks to...").
- **Thinking Section**: Four bullet points max. Each asks a strategic question. Format: `**Concept**: Question? Elaboration.` This forces planning before execution.
- **CRITICAL Callout**: One bold paragraph. States