skill-builder

🛠️ skill-builder

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.

---

⚡ What it does

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.

---

📦 Installation

skill-builder runs natively inside your agent's environment. You can install it automatically or copy files manually.

1. Claude Code

Install as a plugin directly:

claude plugin install shihabshahrier/skill-builder

2. Multi-Agent Setup (opencode, Cursor, Windsurf, Cline, Codex, Gemini, OpenClaw)

Clone 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.sh

3. Manual Installation (Specific Agents)

If 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/
  

🔍 Verification

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?"

---

🚀 Usage Guide

🛠️ Build a New Skill

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 --repo

🔎 Audit & Repair Existing Skills

Ensure 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

---

⚙️ CLI Flags Reference

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.

---

🧩 Supported Skill Types

skill-builder understands the nuances of various interactive paradigms: