Build any custom AI agent skill, prompt, or tool from a plain-English description. One command, production-ready output.
skill-builder is fully compatible with the Agent Skills open standard, supporting major AI coding assistants and CLI agents: Claude Code, Cursor, Cline, Windsurf, Copilot, Gemini CLI, Codex, opencode, and 20+ others.
Instead of manually writing complex prompts, metadata, and hook templates for different agents, simply run:
/skill-builder "compress images before committing"🎯 Generates a fully scaffolded, production-ready repository:
image-compressor/
├── skills/
│ └── image-compressor/
│ ├── SKILL.md ← Complete, validated frontmatter & body
│ └── references/
│ └── compression-api.md ← Rich domain knowledge, loaded lazily
├── install.sh ← Installs instantly to all 5 standard agent paths
├── README.md ← Auto-generated, clear documentation
└── LICENSE ← Standard open-source license
Tip
The generated skill is immediately operational right after running bash install.sh. No manual configuration is required.
skill-builder runs natively inside your agent's environment. You can install it automatically or copy files manually.
Install as a plugin directly:
claude plugin install shihabshahrier/skill-builderClone the repository and run the unified installer to copy the skill to all agent config paths automatically:
git clone https://github.com/shihabshahrier/skill-builder.git
cd skill-builder
bash install.shIf you prefer manual placement, copy the skill directory to the corresponding discovery path:
- Claude Code:
mkdir -p ~/.claude/skills/skill-builder cp -r skills/skill-builder/. ~/.claude/skills/skill-builder/
- OpenAI Codex:
mkdir -p ~/.agents/skills/skill-builder cp -r skills/skill-builder/. ~/.agents/skills/skill-builder/
- Gemini CLI:
mkdir -p ~/.gemini/antigravity/skills/skill-builder cp -r skills/skill-builder/. ~/.gemini/antigravity/skills/skill-builder/
Verify your installation inside your agent shell:
# Inside Claude Code — ensures skill appears in the /help listing
/help
# Any Agent — run the command directly
/skill-builder "What does this skill do?"Generate structured skills, tools, workflows, or roles using plain-English prompts.
# Simple auto-detected generation
/skill-builder "scaffold a fastapi project"
# Force a specific skill type
/skill-builder "remind the model to write unit tests first" --type reference
# Generate a complete marketplace-ready repository scaffold
/skill-builder "make the model speak formally" --type mode --repoEnsure your existing skills adhere to best practices and spec compliance.
# Run the quality checklist against an existing skill
/skill-builder --audit skills/my-skill/SKILL.md
# Audit and automatically correct any non-compliant sections
/skill-builder --audit skills/my-skill/SKILL.md --fix| Flag | Default | Allowed Values | Description |
|---|---|---|---|
description |
Required | Plain-English string | High-level goal of what the skill/prompts/tools should do. (Omit only when using --audit) |
--type |
auto |
workflow, mode, tool, reference, agent |
Forces a specific classification (overrides automatic smart detection). |
--repo |
false |
None | Scaffolds a full publish-ready repo directory containing the skill, README, LICENSE, agent rules, and install script. |
--audit |
none |
Path to a SKILL.md |
Inspects and audits the target file for compliance, performance, structure, and token budgets. |
--fix |
false |
None | Works alongside --audit. Re-writes the file with fixes while leaving compliant sections untouched. |
skill-builder understands the nuances of various interactive paradigms:
| Category | Description | Example Prompt |
|---|---|---|
workflow |
Multi-step pipelined execution that outputs artifacts | "Scaffold a clean FastAPI + Tailwind project" |
mode |
Persistent behavioral instructions active on every turn | "Always output code using strictly functional programming" |
tool |
One-shot atomic transformation on target files/data | "Compress CSS files and format code before committing" |
reference |
Static, specialized domain knowledge loaded on demand | "Include our internal API conventions and schemas" |
agent |
A highly autonomous persona operating as a multi-role team | "Act as a senior DevOps firm deploying to AWS" |
The generated skill bundles are compatible with the industry's leading AI environments:
| Agent / Environment | Discovery Path |
|---|---|
| Claude Code | ~/.claude/skills/ |
| OpenAI Codex | ~/.agents/skills/ |
| opencode (SST) | ~/.config/opencode/skills/ (and standard fallbacks) |
| Gemini CLI | ~/.gemini/antigravity/skills/ |
| OpenClaw | ~/.openclaw/workspace/skills/ |
| Cursor | .cursor/rules/ (condensed .mdc file formats) |
| Windsurf | .windsurf/rules/ (system rules) |
| Cline | .clinerules/ (custom instruction instructions) |
| GitHub Copilot | .github/copilot-instructions.md |
| Generic Agents | AGENTS.md (root directory includes) |
skill-builder goes through a highly efficient, multi-phase compilation pipeline:
[ Plain-English Input ]
│
▼
0. Route CLI Flags ─────────► [ --audit ] ──► Phase A: Parse & Verify Target
│ │ (Fix & Output if requested)
1. Classify Type (Smart NLP) ▼
│ [ Quality Report ]
2. Gather Parameters (≤3 Qs)
│
3. Domain Research (Auto Web-search & extraction)
│
4. Generate SKILL.md (Strict standard validation)
│
5. Generate Domain References (Lazy-loaded tables & docs)
│
6. Generate Execution Hooks (Safe system-level JS handlers)
│
7. Scaffolding (Create repo structure if --repo is enabled)
│
▼
[ Done! Install & Test ]
- None!
skill-builderrelies purely on standard markdown templates, shell scripts, and native agent capabilities. - No bulky runtimes, no dependencies to build, and no external package manager overhead.
Contributions are highly welcome! To contribute:
- Review the CONTRIBUTING.md guidelines.
- Direct your changes exclusively to the skill source:
skills/skill-builder/SKILL.mdandskills/skill-builder/references/*.md.
This project is licensed under the MIT License.
📖 Project page: https://shihub.online/projects/skill-builder