skill-forge-buildlisted

# Skill Builder — Scaffold & Generate ## Process ### Step 1: Gather Inputs Determine what we're building from: - **Plan document**: Output from `/skill-forge plan` (preferred) - **Description**: Natural language description of the skill - **Existing skill**: Path to a skill to use as foundation If no plan exists, run a quick planning pass (ask 3 key questions): 1. What does the skill do? (1-2 sentences) 2. What commands should it have? (list) 3. Does it need scripts or external tools? (yes/no) ### Step 2: Generate Frontmatter The most critical step. The description field determines activation. **Framework for writing descriptions:** ``` [Capability statement] + [Detailed capabilities] + [Trigger phrases] ``` **Rules:** - Under 1024 characters total - No XML angle brackets (< >) - Include 5-10 trigger phrases users would say - Mention file types if relevant - Add negative triggers if risk of over-triggering **Use `references/description-guide.md` for the full framework.** ### Step 3: Write Main SKILL.md Structure the body following this template: ```markdown # [Skill Name] -- [Tagline] [1-2 sentence overview] ## Quick Reference | Command | What it does | |---------|-------------| | /name cmd1 | Description | | /name cmd2 | Description | ## Orchestration Logic [How commands route to sub-skills] [Decision trees for conditional routing] ## [Domain-Specific Section] [Core rules, thresholds, quality gates] ## Reference Files [List of on-demand reference files]