skill-builderCreate high-quality skills with modular structure, progressive disclosure, and token-efficient design.
Install via ClawdBot CLI:
clawdbot install ivangdavila/skill-builderOn first use, read setup.md for integration guidelines.
User wants to create or improve a skill. Agent guides structure, reviews content, and ensures quality.
If user wants project tracking, create folder in their home directory.
See memory-template.md for the template structure.
The agent does NOT create files automatically. Always ask user first.
Skills follow this structure:
skill-name/
├── SKILL.md # Core instructions (SHORT)
├── [topic].md # On-demand details
└── references/ # Heavy docs (optional)| Topic | File |
|-------|------|
| Setup process | setup.md |
| Tracking projects | memory-template.md |
| Patterns and examples | patterns.md |
Target 30-50 lines, max 80. Move details to auxiliary files. Every line must justify its token cost.
Level 1: Metadata (name + description) — always loaded
Level 2: SKILL.md body — when skill triggers
Level 3: Auxiliary files — on demandOne sentence, 15-25 words. Action verb first. Describes capabilities, not triggers.
| ❌ Wrong | ✅ Right |
|----------|----------|
| "Use when user needs PDFs" | "Process, merge, and extract PDF content" |
| "Helper for Docker" | "Build, deploy, and debug Docker containers" |
| "Git guide" | "Manage branches, resolve conflicts, and automate workflows" |
See patterns.md for more examples.
Every skill needs:
## When to Use — activation triggers## Core Rules — 3-7 numbered rulesIf content exceeds 20 lines or is only needed sometimes, split to separate file. Reference from Quick Reference table.
Information lives in ONE place. SKILL.md references files, doesn't duplicate content.
Read the skill as if you're an agent encountering it fresh. Is every instruction clear and necessary?
| Trap | Why it fails | Fix |
|------|--------------|-----|
| Explaining what X is | Models already know | Explain WHEN and HOW |
| "Use when..." in description | Wastes characters | Action verbs only |
| Keyword lists in description | Looks spammy | One clean sentence |
| Templates inline | Bloats SKILL.md | Separate file |
| Vague "observe" instructions | Gets flagged suspicious | Be specific about what data |
| Undeclared file creation | Security flag | Add Data Storage section |
Install with clawhub install if user confirms:
skill-manager — manage installed skillsskill-update — update existing skillsskill-test — test skills locallyclawhub star skill-builderclawhub syncGenerated Mar 1, 2026
A team building custom AI agents for clients needs to create modular, efficient skills to handle specific tasks like data processing or customer support. This skill helps them structure skill documentation, avoid redundancy, and ensure quality through progressive disclosure, reducing development time and token usage.
An educator designing interactive learning modules for AI platforms wants to package teaching tools as skills. This skill guides them in writing clear, concise instructions and splitting content into auxiliary files, making materials easy to update and scalable for different learning levels.
A consultant implementing AI-driven automation for businesses needs to create reusable skills for tasks like report generation or workflow management. This skill ensures skills are token-efficient, follow security protocols, and include proper metadata, facilitating integration into existing systems.
A maintainer of an open-source AI tool wants to add community-contributed skills with consistent quality. This skill provides rules for short core files and references to detailed docs, helping maintain a clean codebase and encouraging contributions without bloating the main repository.
Offer custom skill creation for businesses using this skill's guidelines, charging per project or on a subscription basis. Revenue comes from consulting fees and ongoing maintenance, leveraging the modular structure to deliver efficient, high-quality skills quickly.
Build a platform where users can buy and sell skills developed with this skill's standards, taking a commission on sales. Revenue is generated from transaction fees and premium listings, with quality ensured by adherence to the skill's rules like short descriptions and progressive disclosure.
Provide courses and certifications on skill building using this skill's methodology, targeting developers and teams. Revenue comes from course fees, certification exams, and corporate training packages, with content based on the skill's traps and examples to ensure practical learning.
💬 Integration Tip
Always ask users before creating files to avoid security flags, and reference auxiliary files like setup.md to keep the core SKILL.md short and token-efficient.
Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth. Use this skill when users want to...
Build, debug, and deploy websites using HTML, CSS, JavaScript, and modern frameworks following production best practices.
YouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Scaffold, test, document, and debug REST and GraphQL APIs. Use when the user needs to create API endpoints, write integration tests, generate OpenAPI specs, test with curl, mock APIs, or troubleshoot HTTP issues.
Search for jobs across LinkedIn, Indeed, Glassdoor, ZipRecruiter, Google Jobs, Bayt, Naukri, and BDJobs using the JobSpy MCP server.