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