skill-builder

Orchestrates the lifecycle of building, improving, and polishing Claude Code skills.

6|1|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/jl-cmd/claude-dev-env --skill skill-builder-jl-cmd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-builder
Source: https://github.com/jl-cmd/claude-dev-env/tree/main/skill-archive/skill-builder
Command: npx skills add https://github.com/jl-cmd/claude-dev-env --skill skill-builder-jl-cmd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing effective agent skills is error-prone: descriptions become story prose that weakens skill selection, deterministic steps get left as prose, and multi-capability monoliths ignore modularity. This Skill enforces proven authoring best practices through a structured classify-scaffold-write-audit lifecycle. ## Core Features & Use Cases - Lifecycle workflows: Dedicated step-by-step flows for creating new skills, improving existing ones via observation, and final polish passes on descriptions and structure. - Best-practice enforcement: Reference specifications cover the 9-type skill taxonomy, progressive disclosure, description trigger catalogs, modularity and sub-skill composition, and deterministic element extraction to scripts. - Delegated authoring and self-audit: Orchestrates the skill-writer-agent for drafting and runs a mandatory task-seeded self-audit checklist before delivery. - Use Case: When asked to build a new skill for a deployment workflow, it classifies the skill type, scaffolds the folder structure, gathers a gap analysis with composition plan, delegates writing, and audits the result against every best-practice rule. ## Quick Start Ask the agent to build a new skill for a task or domain you want to capture, and it will route through the new-skill workflow end to end.

Frequently Asked Questions about skill-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Claude Code skill?▼

Invoke the skill-builder skill with a one-sentence description of the capability. It classifies the skill into one of 9 types, scaffolds the folder structure, gathers a gap analysis, delegates writing to the skill-writer-agent, and self-audits before delivery.

How to write a good skill description for skill selection?▼

Write a trigger catalog, not a story: a short capability stem of 5-20 words plus a concrete Triggers list of phrases, slash commands, and file types. Keep it third person, under 1024 characters, with no narrative or benefits language.

What are the types of agent skills?▼

Skills cluster into 9 types: Library and API Reference, Product Verification, Data Fetching and Analysis, Business Process Automation, Code Scaffolding, Code Quality and Review, CI/CD and Deployment, Runbooks, and Infrastructure Operations. The type determines the recommended folder structure.

When should a skill be split into multiple skills?▼

Split when the description needs an unrelated 'and', when process branches never share gotchas or scripts, or when typical tasks only need half the package. Multi-step workflows become a thin orchestrator skill that invokes named peer sub-skills.

Why should deterministic steps be scripts instead of prose?▼

Deterministic steps produce the same output from the same inputs and are machine-checkable, so they belong in scripts, templates, or task-seed lists rather than markdown instructions. Prose-only mechanical sequences fail the self-audit because agents may skip or misinterpret them.