Agent skill

Skill Builder

by metaskills in metaskills/skill-builder

A skill your agent uses when creating new Claude Code skills from scratch, editing existing skills to improve their descriptions or structure, or converting Claude Code sub-agents to skills.

No licenceAuto-check passedAgent Workflows

Install Skill Builder

skills CLI
$ npx skills add metaskills/skill-builder --skill skill-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install metaskills/skill-builder skill-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-builder
GitHub stars
111
Token cost
~2.5k tokens
SKILL.md length
1,063 words
Files
8
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when creating new Claude Code skills from scratch, editing existing skills to improve their descriptions or structure, or converting Claude Code sub-agents to skills.

  • Works in 5 steps: Gather Requirements → Design the Skill → Leverage CLI and Node.js → …
  • Creating new Claude Code skills from scratch
  • SKILL.md covers Skill Structure, SKILL.md Format, Critical Requirements and Skill Locations, plus 12 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Skill Builder is an agent skill from metaskills/skill-builder. Use this skill when creating new Claude Code skills from scratch, editing existing skills to improve their descriptions or structure, or converting Claude Code sub-agents to skills. This includes designing skill workflows, writing SKILL.md files, organizing supporting files with intention-revealing names, and leveraging CLI tools and Node.js scripting.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files (for example `converting-sub-agents-to-skills.md`, `reference/editing-skills-guide.md` and `reference/metadata-requirements.md`).

It sits in Agent Workflows, covering Skill authoring and Subagents. It works with Node.js. The repository describes itself as: Claude Code Agent Skills Builder.

When your agent uses it

  • Creating new Claude Code skills from scratch
  • Editing existing skills to improve their descriptions
  • Converting Claude Code sub-agents to skills

Example prompts

  • “/skill-builder”

Requirements

  • Python 3
  • Node.js

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Gather Requirements
  2. Design the Skill
  3. Leverage CLI and Node.js
  4. Create the Skill
  5. Validate

What it can do on your machine

Read from SKILL.md and the folder at commit aed0345. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml and javascript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.claude.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Builder loads about 2.5k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 1,063 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,063 words (~2,462 tokens).

“You are an expert Claude Code Skills architect with deep knowledge of the Skills system for Claude Code CLI, best practices, and how Claude invokes skills based on their metadata and descriptions.”

— opening of SKILL.md by metaskills
name
skill-builder

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files in the repository root of metaskills/skill-builder.

  • SKILL.md
  • converting-sub-agents-to-skills.md
  • reference/editing-skills-guide.md
  • reference/metadata-requirements.md
  • reference/nodejs-and-cli-patterns.md
  • reference/skill-best-practices.md
  • reference/skill-structure-and-format.md
  • templates/skill-template.md

Open the folder on GitHubat commit aed0345

Compare with similar skills

Skill Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Builder this skillmetaskills/skill-builder111—~2.5kAutomated safety check: PassNone
Reflect on Session Learningscursor/plugins10k5 repos~1.2kAutomated safety check: PassNone
Harness Agent Team Designerrevfactory/harness9.1k—~4.5kAutomated safety check: PassApache-2.0
OpenAI Codex CLI Bridgetaracodlabs/aiden8491 repos~826Automated safety check: PassApache-2.0
Happycapy Skill Creatorhappycapy-ai/Happycapy-skills137—~627Automated safety check: PassMIT
Skillkit Helprfxlamia/skillkit102—~775Automated safety check: PassApache-2.0

Similar skills

  • Official

    Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.

    10k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Harness Agent Team Designer

    revfactory/harness

    Designs a project-specific agent harness: defines specialist agents, writes the skills they follow, picks an execution mode and model for each, and keeps the setup maintained.

    9.1k GitHub stars~4.5k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed
  • OpenAI Codex CLI Bridge

    taracodlabs/aiden

    Delegates code generation, editing and explanation tasks to the OpenAI Codex CLI, with commands for interactive, auto-edit, question-only and model-specific runs.

    849 GitHub starsUsed in 1 repo~826 tokens
    Agent WorkflowsAuto-check passed
  • Happycapy Skill Creator

    happycapy-ai/Happycapy-skills

    Automate HappyCapy skill creation by finding and adapting existing skills from anthropics/skills repository.

    137 GitHub stars~627 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Skillkit Help

    rfxlamia/skillkit

    Pre-build orientation for skill creators. An agent skill from rfxlamia/skillkit.

    102 GitHub stars~775 tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check passed
  • Writing Skills

    ed3dai/ed3d-plugins

    A skill your agent uses when creating new skills, editing existing skills, or verifying skills work before deployment - applies TDD to process documentation by testing with subagents before writing…

    250 GitHub starsUsed in 1 repo~1.3k tokens
    Agent WorkflowsAuto-check passed

Works with

Categories

Questions about Skill Builder

What does Skill Builder do?

A skill your agent uses when creating new Claude Code skills from scratch, editing existing skills to improve their descriptions or structure, or converting Claude Code sub-agents to skills. Skill Builder is an agent skill from metaskills/skill-builder. Use this skill when creating new Claude Code skills from scratch, editing existing skills to improve their descriptions or structure, or converting Claude Code sub-agents to skills.

When should I use Skill Builder?

Skill Builder fits situations like: creating new Claude Code skills from scratch; editing existing skills to improve their descriptions; converting Claude Code sub-agents to skills.

How do I install Skill Builder in Claude Code?

Run `npx skills add metaskills/skill-builder --skill skill-builder -a claude-code`. Or copy the skill folder (the metaskills/skill-builder repository) into .claude/skills/skill-builder in your project. Claude Code loads it when a task matches its description.

How do I install Skill Builder in Codex?

Run `npx skills add metaskills/skill-builder --skill skill-builder -a codex`. Or copy the skill folder (the metaskills/skill-builder repository) into .agents/skills/skill-builder in your project. Codex loads it when a task matches its description.

Can I use Skill Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add metaskills/skill-builder --skill skill-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-builder, .gemini/skills/skill-builder, .github/skills/skill-builder and .opencode/skills/skill-builder in your project.

What does Skill Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Skill Builder is instructions for the agent only. Our summary lists: Python 3; Node.js.

Does Skill Builder access the network?

SKILL.md names 1 domain. As links in the text: docs.claude.com. This is read from the text; nothing was executed.

Is Skill Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Builder use?

No licence was found for Skill Builder or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Skill Builder use?

About 2.5k tokens (SKILL.md is roughly 9.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skill Builder?

Skills that share tags, products or a category with Skill Builder: Reflect on Session Learnings (cursor/plugins, 10k stars), Harness Agent Team Designer (revfactory/harness, 9.1k stars), OpenAI Codex CLI Bridge (taracodlabs/aiden, 849 stars) and Happycapy Skill Creator (happycapy-ai/Happycapy-skills, 137 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Builder?

metaskills (a GitHub user) maintains it in metaskills/skill-builder, which has 111 GitHub stars. The repository was last updated on December 22, 2025.

Source: metaskills/skill-builder on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.