MCP Server Builder
anthropics/skills
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
Use in the BuilderIO/skills repo whenever adding, updating, publishing, documenting, validating, or wiring a public skill.
Install Adding A Skill
$ npx skills add BuilderIO/skills --skill adding-a-skill -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install BuilderIO/skills adding-a-skill --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/BuilderIO/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/adding-a-skill .claude/skills/adding-a-skill && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "adding-a-skill" agent skill from https://github.com/BuilderIO/skills/tree/main/.agents/skills/adding-a-skill into .claude/skills/adding-a-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adding-a-skill", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/BuilderIO/skills/tree/main/.agents/skills/adding-a-skillType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add BuilderIO/skills --skill adding-a-skill -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install BuilderIO/skills adding-a-skill --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BuilderIO/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/adding-a-skill .agents/skills/adding-a-skill && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "adding-a-skill" agent skill from https://github.com/BuilderIO/skills/tree/main/.agents/skills/adding-a-skill into .agents/skills/adding-a-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adding-a-skill", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add BuilderIO/skills --skill adding-a-skill -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install BuilderIO/skills adding-a-skill --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BuilderIO/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/adding-a-skill .cursor/skills/adding-a-skill && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "adding-a-skill" agent skill from https://github.com/BuilderIO/skills/tree/main/.agents/skills/adding-a-skill into .cursor/skills/adding-a-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adding-a-skill", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/BuilderIO/skills.git --path .agents/skills/adding-a-skill--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add BuilderIO/skills --skill adding-a-skill -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install BuilderIO/skills adding-a-skill --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BuilderIO/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/adding-a-skill .gemini/skills/adding-a-skill && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "adding-a-skill" agent skill from https://github.com/BuilderIO/skills/tree/main/.agents/skills/adding-a-skill into .gemini/skills/adding-a-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adding-a-skill", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install BuilderIO/skills adding-a-skillInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add BuilderIO/skills --skill adding-a-skill -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/BuilderIO/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/adding-a-skill .github/skills/adding-a-skill && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "adding-a-skill" agent skill from https://github.com/BuilderIO/skills/tree/main/.agents/skills/adding-a-skill into .github/skills/adding-a-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adding-a-skill", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add BuilderIO/skills --skill adding-a-skill -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install BuilderIO/skills adding-a-skill --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/BuilderIO/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/adding-a-skill .opencode/skills/adding-a-skill && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "adding-a-skill" agent skill from https://github.com/BuilderIO/skills/tree/main/.agents/skills/adding-a-skill into .opencode/skills/adding-a-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adding-a-skill", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
adding-a-skill- GitHub stars
- 4.5k
- Token cost
- ~1.6k tokens
- SKILL.md length
- 616 words
- Files
- 2
- Skills in repo
- 25
- Repo updated
- First seen
- Licence
- MIT
At a glance
Use in the BuilderIO/skills repo whenever adding, updating, publishing, documenting, validating, or wiring a public skill.
- Works in 7 steps: Create or update skills//SKILL.md. → Add skills//README.md when the skill… → If the collection positioning changes,… → …
- Agent Workflows work in your project
- SKILL.md covers First Decide The Skill Kind, Plain Public Skill Checklist, @agent-native/skills Install… and Managed Instruction Blocks, plus 3 more sections
- Calls npm, npx and python3
What it does
Adding A Skill is an agent skill from BuilderIO/skills. Use in the BuilderIO/skills repo whenever adding, updating, publishing, documenting, validating, or wiring a public skill. Covers the repo-local skill files, root catalog docs, plugin metadata, @agent-native/skills dynamic install path, optional managed AGENTS/CLAUDE instruction blocks in ../agent-native/framework, and generated/synced Plan skill gotchas.
Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).
It sits in Agent Workflows. It works with Model Context Protocol. The licence is MIT.
When your agent uses it
- Agent Workflows work in your project
Example prompts
- “/adding-a-skill”
Requirements
- Python 3
- Node.js
Workflow steps
7 steps, taken from the first numbered list in SKILL.md.
- Create or update skills//SKILL.md.
- Add skills//README.md when the skill should appear in the
- If the collection positioning changes, update root README.md,
- Keep the skill concise. Put only essential agent instructions in SKILL.md;
- Validate with
- Smoke-test install discovery locally before claiming the CLI path works
- Run npm run check. If it fails on visual-plan / visual-recap sync while
What it can do on your machine
Read from SKILL.md and the folder at commit 530d9ee. 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
Shell commands in SKILL.md call:
npmnpxpython3nodepnpm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, npx and pnpm, which can reach the network depending on how they are called.
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
Adding A Skill loads about 1.6k tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 616 words of instructions outside code blocks.
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
The full file from BuilderIO/skills at commit 530d9ee, republished under its MIT licence (© BuilderIO). 616 words, ~1,562 tokens.
Download SKILL.mdSave it as
.claude/skills/adding-a-skill/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- adding-a-skill
- description
- Use in the BuilderIO/skills repo whenever adding, updating, publishing, documenting, validating, or wiring a public skill. Covers the repo-local skill files, root catalog docs, plugin metadata, @agent-native/skills dynamic install path, optional managed AGENTS/CLAUDE instruction blocks in ../agent-native/framework, and generated/synced Plan skill gotchas.
Adding A Skill
Use this for public skill work in this repo. Keep ordinary skill changes in
skills/<skill-name>/; keep repo-only guidance under .agents/skills/.
First Decide The Skill Kind
- Plain public skill: a normal folder under
skills/<name>/withSKILL.md. This is the common case.@agent-native/skillsdiscovers these dynamically fromBuilderIO/skills@main, so there is no framework registry to edit just to makenpx @agent-native/skills@latest add --skill <name>work. - Instruction-style skill: a plain skill that should optionally write an
always-on managed
AGENTS.md/CLAUDE.mdline when users pass--update-instructions. These need one extra framework change; see "Managed Instruction Blocks" below. - App-backed / MCP skill: a skill that registers a hosted/local MCP server
or uses framework-owned install behavior. These are not plain public skills;
inspect
../agent-native/framework/packages/core/src/cli/skills.tsand../agent-native/framework/packages/skills/src/built-in-apps.ts. - Plan skills:
visual-planandvisual-recaphave generated/synced copies between this repo and../agent-native/framework. Do not treat them like a standalone prose folder. - Rewind: its canonical
SKILL.mdis generated from Agent Native because the instructions and local Screen Memory tools share one privacy contract. Keep the human README here; usenpm run sync:agent-native-skillsfor the generated skill instead of editing it by hand.
Plain Public Skill Checklist
Create or update
skills/<skill-name>/SKILL.md.Add
skills/<skill-name>/README.mdwhen the skill should appear in the public catalog. This repo intentionally uses READMEs for public skill pages.If the collection positioning changes, update root
README.md,.codex-plugin/plugin.json,.claude-plugin/plugin.json, andpackage.jsondescriptions.Keep the skill concise. Put only essential agent instructions in
SKILL.md; avoid extra docs unless they directly support the skill.Validate with:
sh python3 /Users/steve/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/<skill-name>Smoke-test install discovery locally before claiming the CLI path works:
sh node ../agent-native/framework/packages/skills/dist/cli.js add --copy . --skill <skill-name> --client codex --scope project --dry-run --jsonRun
npm run check. If it fails onvisual-plan/visual-recapsync while the change is unrelated, report that specifically instead of rewriting those skills casually.
@agent-native/skills Install Path
For a plain public skill, the install path is dynamic:
../agent-native/framework/packages/skills/src/index.tssetsDEFAULT_SKILLS_SOURCE = "BuilderIO/skills".It materializes that repo, reads plugin manifests via
resolveSkillsRoot, and discovers everyskills/*/SKILL.mdthroughdiscoverSkills.Therefore a new folder under
skills/<name>/is enough for:sh npx @agent-native/skills@latest add --skill <name>
No @agent-native/core built-in registry change is needed unless the skill is
app-backed or needs custom install behavior.
Show full SKILL.md (276 more words)Show less
Managed Instruction Blocks
If the skill should affect AGENTS.md / CLAUDE.md through
--update-instructions, update the framework wrapper:
Add a concise line in
../agent-native/framework/packages/skills/src/index.tsinsideinstructionContentForSkill(skillName).Add or update tests in
../agent-native/framework/packages/skills/src/index.spec.ts.Run:
sh pnpm --filter @agent-native/skills test -- src/index.spec.ts --runInBand
Use this for durable behavior rules like quick-recap, efficient-fable,
stay-within-limits, and likely docs-first behavior such as
read-the-damn-docs.
App-Backed Or MCP Skills
If a skill needs hosted tools, auth, MCP registration, local-files mode, or special install flags, inspect the framework before editing:
../agent-native/framework/packages/core/src/cli/skills.ts../agent-native/framework/packages/skills/src/built-in-apps.ts../agent-native/framework/packages/skills/src/sync-with-core.spec.ts
Keep the core and standalone @agent-native/skills MCP descriptors in sync.
Agent Native Skill Sync Gotchas
visual-plan, visual-recap, and rewind are special:
- Framework contains canonical/generated copies and Plan marketplace bundles.
- This repo's
npm run checkcompares those copies and can fail for drift unrelated to a new plain skill. - When intentionally changing Plan skills, use the framework sync paths instead
of hand-editing generated copies. Search the framework for
sync-plan-marketplace,sync-workspace-skills, andskills.sync.spec.ts. - Rewind's
SKILL.mdis generated frompackages/core/src/cli/skills-content/rewind-skill.ts. Its public README is preserved as an overlay. The plain-copy installer cannot configure Rewind's local MCP connection; public setup docs must use@agent-native/skillsor@agent-native/core. - Plugin manifests that publish the whole
skills/directory must carry an always-on setup directive: invoking Rewind with Clips absent asks permission before opening the official install flow, never installs or enables capture silently, and keeps Rewind unavailable until Core configures the local MCP connection andscreen_memory_statussucceeds.
Final Reporting
When finishing a skill change, tell the user:
- Which skill files changed.
- Whether
@agent-native/skillsdynamic install discovery is enough. - Whether a framework managed-instruction change was added or intentionally left as a follow-up.
- Which validation commands passed or failed, including unrelated Plan sync failures.
© BuilderIO, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file in .agents/skills/adding-a-skill of BuilderIO/skills.
- SKILL.md
- agents/openai.yaml
Open the folder on GitHubat commit 530d9ee
Compare with similar skills
Adding A Skill 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 | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Adding A Skill this skillBuilderIO/skills | 4.5k | — | ~1.6k | Automated safety check: Pass | MIT | |
| MCP Server Builderanthropics/skills | 180k | 62 repos | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| MCP Server BuildershareAI-lab/learn-claude-code | 78k | 5 repos | ~1.2k | Automated safety check: Pass | MIT | |
| MCP Integration for Pluginsanthropics/claude-plugins-official | 37k | 11 repos | ~3.1k | Automated safety check: Pass | Apache-2.0 | |
| Fastmcp Client CLIPrefectHQ/fastmcp | 28k | 1 repos | ~823 | Automated safety check: Pass | Apache-2.0 | |
| MemPalace Memory SearchMemPalace/mempalace | 59k | — | ~1.4k | Automated safety check: Pass | MIT |
Similar skills
- Official
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
- Official
MCP Integration for Plugins
anthropics/claude-plugins-official
Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.
Fastmcp Client CLI
PrefectHQ/fastmcp
Query and invoke tools on MCP servers using fastmcp list and fastmcp call.
MemPalace Memory Search
MemPalace/mempalace
Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.
Crush Configuration
charmbracelet/crush
Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.
More from BuilderIO/skills
All 25 skills in this repoAgent Watchdog
BuilderIO/skills
A skill your agent uses when asked to watch, babysit, audit, review, compare, or fix another agent's work from a Codex session ID, Claude Code session/transcript, chat/thread link, PR, branch, log…
Plan Arbiter
BuilderIO/skills
A skill your agent uses when asked to compare, cross-review, merge, judge, choose, or arbitrate competing plans from multiple agents such as Codex and Claude Code; when given two or more proposed…
Plow Ahead
BuilderIO/skills
A skill your agent uses when the user explicitly wants autonomous progress without routine clarification stops: "plow ahead", "do not stop", "use your best judgment", "keep going until done"…
Read The Damn Docs
BuilderIO/skills
A skill your agent uses when implementing, integrating, upgrading, debugging, or answering anything involving third-party APIs, libraries, frameworks, CLIs, cloud services, model/provider SDKs…
Stay Within Limits
BuilderIO/skills
A skill your agent uses when long-running or parallel agent work must respect 5-hour and weekly usage limits by checking usage between waves, pausing near the cap, and resuming only when the window…
Efficient Fable
BuilderIO/skills
A skill your agent uses when running Claude Fable on codebase-heavy or token-heavy work and the user wants Fable to orchestrate research, coding, and testing while cheaper subagents do bounded heavy…
Related
Works with
Categories
Questions about Adding A Skill
What does Adding A Skill do?
Use in the BuilderIO/skills repo whenever adding, updating, publishing, documenting, validating, or wiring a public skill. Adding A Skill is an agent skill from BuilderIO/skills. Use in the BuilderIO/skills repo whenever adding, updating, publishing, documenting, validating, or wiring a public skill.
When should I use Adding A Skill?
Adding A Skill fits situations like: agent Workflows work in your project.
How do I install Adding A Skill in Claude Code?
Run `npx skills add BuilderIO/skills --skill adding-a-skill -a claude-code`. Or copy the skill folder (.agents/skills/adding-a-skill in BuilderIO/skills) into .claude/skills/adding-a-skill in your project. Claude Code loads it when a task matches its description.
How do I install Adding A Skill in Codex?
Run `npx skills add BuilderIO/skills --skill adding-a-skill -a codex`. Or copy the skill folder (.agents/skills/adding-a-skill in BuilderIO/skills) into .agents/skills/adding-a-skill in your project. Codex loads it when a task matches its description.
Can I use Adding A Skill 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 BuilderIO/skills --skill adding-a-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/adding-a-skill, .gemini/skills/adding-a-skill, .github/skills/adding-a-skill and .opencode/skills/adding-a-skill in your project.
What does Adding A Skill need to run?
Going by SKILL.md and its folder, Adding A Skill needs the command-line tools its instructions call (npm, npx, python3, node and pnpm). Our summary lists: Python 3; Node.js.
Does Adding A Skill access the network?
SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Adding A Skill 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 Adding A Skill use?
Adding A Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Adding A Skill use?
About 1.6k tokens (SKILL.md is roughly 6.2k 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 Adding A Skill?
Skills that share tags, products or a category with Adding A Skill: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 37k stars) and Fastmcp Client CLI (PrefectHQ/fastmcp, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Adding A Skill?
BuilderIO (a GitHub organization) maintains it in BuilderIO/skills, which has 4,528 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 7, 2026.
Source: BuilderIO/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.