skill-factory

Overview

Unified skill for creating and maintaining Claude Code skills. Combines skill creation, detection from session patterns, and quality improvement into one workflow.

Required References

Before generating or auditing, read references/skill-authoring-guide.md for the complete authoring guide (anatomy, progressive disclosure, writing style, validation checklist).

For the original Anthropic skill-creator methodology, see references/skill-creator-original.md.

Mode Detection

• If input is a session transcript or "detect"/"extract" → Mode B (Detect)
• If input points to an existing skill directory or mentions "improve"/"audit" → Mode C (Improve)
• Otherwise → Mode A (Create)

---

Mode A: Create

Build a new skill from a description or requirements.

Step A1: Gather Requirements

Ask targeted questions (avoid overwhelming — 2-3 at a time):

1. What the skill does and when to use it
2. Concrete usage examples ("What would a user say to trigger this?")
3. Input parameters and expected output format
4. Step-by-step process

Step A2: Plan Resources

Analyze the workflow to identify reusable resources:

• Scripts — Code that would be rewritten each time (e.g., scripts/rotate_pdf.py)
• References — Knowledge rediscovered each time (e.g., references/schema.md)
• Assets — Boilerplate needed each time (e.g., assets/template/)

Step A3: Design

1. Define YAML frontmatter: name, description (with trigger phrases), allowed-tools, argument-hint
2. Break the workflow into numbered steps
3. Identify conditional steps and parallel execution points
4. Define what each step produces

Step A4: Generate

1. Create the skill directory: skills/<skill-name>/
2. Write SKILL.md with frontmatter and step instructions
3. Create reference/script/asset files as needed
4. Ensure instructions are clear enough for Claude to follow autonomously

CRITICAL: Follow the writing style in references/skill-authoring-guide.md — imperative form, third-person description, specific trigger phrases.