Skill Builder MCP server

skill-builder

Publish and install AI skill prompts from the command line — or author them in the web editor with help from an AI drafting assistant.

npx @dmzagent/skill-builder install @author/skill-id

Getting started: installing skills

Browse the registry

Results print as a dense table right in your terminal:

npx @dmzagent/skill-builder list

Filter by category, author, type, tag, and sort order:

npx @dmzagent/skill-builder list --category "Developer Tools"
npx @dmzagent/skill-builder list --type meta          # only meta skills
npx @dmzagent/skill-builder list --author skillauthor
npx @dmzagent/skill-builder list --sort downloads
npx @dmzagent/skill-builder list --json               # machine-readable
npx @dmzagent/skill-builder list --web                # open the browser registry instead

Search and inspect

npx @dmzagent/skill-builder search "data pipeline"    # ranked by relevance
npx @dmzagent/skill-builder info @skillauthor/dialogue-flow
npx @dmzagent/skill-builder suggest dial              # autocomplete: skills, tags, authors

Wire up shell completion (skills, tags, and authors complete as you type):

npx @dmzagent/skill-builder completion >> ~/.bashrc

Install a skill

npx @dmzagent/skill-builder install dialogue-flow
npx @dmzagent/skill-builder install @skillauthor/dialogue-flow

Downloads dialogue-flow.md and dialogue-flow.json to the current directory. Use --output ./my-skills to change where files land.

Meta skills install their dependencies automatically. Installing a meta skill resolves its full dependency tree (deduped, cycle-safe) and installs every required skill alongside it. Use --no-deps to install just the meta skill.

npx @dmzagent/skill-builder install @skillauthor/my-bundle
# → resolves and installs my-bundle + every skill it depends on

Getting started: publishing skills

1. Create an account

npx @dmzagent/skill-builder register myhandle "My Name" me@email.com

You'll be prompted for a password. Or set SKILL_PASSWORD to skip the prompt:

SKILL_PASSWORD=hunter2 npx @dmzagent/skill-builder register myhandle "My Name" me@email.com

2. Log in

npx @dmzagent/skill-builder login me@email.com

Your auth token is printed on success. Set it as SKILL_TOKEN so subsequent commands can use it:

export SKILL_TOKEN=<token-from-login>

(Or pass --token $SKILL_TOKEN to each command.)

3. Publish a skill

From a markdown file:

npx @dmzagent/skill-builder publish ./my-skill.md

The CLI reads the filename as the skill id and the first heading as the name. You can also use a JSON manifest:

npx @dmzagent/skill-builder publish ./my-skill.json

4. Declare the capabilities a skill needs (optional)

A skill can declare what a model must be able to do to invoke it. The declaration lives on the spec, so it travels with the skill through the registry, the CLI, and MCP — an agent can tell whether it is able to run a skill before it spends a turn on it.

{
  "capabilities": [
    { "id": "vision", "level": "required", "note": "reads chart images" },
    { "id": "long-context", "level": "preferred" }
  ]
}

required capabilities gate execution: the registry refuses to run a skill on a runtime that cannot provide one, unless the caller explicitly forces a degraded run. preferred capabilities only weaken the result. Catalog ids:

vision · audio-input · file-input · structured-output · streaming
extended-reasoning · long-context · multilingual
tool-use · parallel-tool-calls · code-execution · web-search · file-system
computer-use · mcp-client
persistent-memory · citations

Shortened. The full README is on GitHub.