agent-skill-builder

# Agent Skill Builder Produce a ready-to-use skill from a plain-language request. Preserve the user's runtime, scope, and requested level of implementation. ## Select the mode Parse `$ARGUMENTS`; default to `new` when it contains a description. - `new <description>`: create or draft a skill. - `review <path>`: report actionable findings and run validation. Do not rewrite unless asked. - `migrate <path>`: convert a legacy `.claude/commands/*.md` file into a skill directory while preserving behavior. ## Establish the contract Infer what is already clear. Ask only when a missing choice would materially change the result. 1. Choose the runtime: - Claude Code (default): read [the Claude Code reference](references/claude-code-frontmatter.md). - Portable Agent Skills: read [the portable reference](references/portable-agent-skills.md) and omit Claude-only fields. 2. Read the host repository's applicable instruction files (`AGENTS.md`, `CLAUDE.md`, or equivalents) and inspect existing skills. Match local conventions and avoid duplicate capabilities. 3. Identify inputs, outputs, required resources, and the destination directory. 4. Classify the skill: - Reference: standing domain rules or conventions. - Task: a bounded workflow with a defined result and stopping condition. - Tool-backed: a task that benefits from repeatable scripts or narrowly scoped tool grants. ## Design decisions Include only fields and instructions that change behavior. - Name: lowercase le...