About Zanat
Zanat is an MCP server in the Developer Tools category: mCP server for zanat - a skill hub for AI agents.
Install
claude mcp add zanat -- npx -y @iamramo/zanat-mcpnpx -y @iamramo/zanat-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (6)
add_skillAdd a skill, optionally pinned to a tag or SHA
Parameters not published.
get_skillGet the full content of a skill
Parameters not published.
list_skillsList added skills with version and pin status
Parameters not published.
remove_skillRemove an added skill
Parameters not published.
search_skillsSearch skills by name or content
Parameters not published.
update_skillUpdate one or all non-pinned skills
Parameters not published.
Ask AI
Ask AI about Zanat
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
What is Zanat?
Zanat manages AI agent skills: markdown files that tell an agent how to behave in a specific situation. Skills live in a Git repository, so they are versioned, shareable, and easy to keep in sync across machines and teams.
You search for skills, add the ones you want, and they land in ~/.agents/skills/ where any compatible agent can pick them up. When the hub updates, you pull and update, just like any other dependency.
Quick Start
npm install -g @iamramo/zanat-cli
zanat hub add # point it at your hub repository
zanat skill search # browse available skills
zanat skill add vercel.frontend.react-patterns
Commands
| Command | Description |
|---|---|
zanat hub add |
Add a new hub interactively |
zanat hub rm <name> |
Remove a hub |
zanat hub switch <name> |
Switch the active hub |
zanat hub list |
List all configured hubs |
zanat hub pull |
Pull latest changes from the hub |
zanat skill add [skill] |
Add a skill, or all hub skills if no name is given |
zanat skill add <skill> --pin=<ref> |
Add a skill pinned to a specific tag or commit |
zanat skill rm [skill] |
Remove a skill, or all added skills if no name is given |
zanat skill update [skill] |
Update one or all non-pinned skills |
zanat skill list |
List added skills with version info |
zanat skill search [query] |
Search available skills in the hub |
zanat show <skill> |
Show the full content of a skill |
zanat status |
Show hub and skills status |
See the CLI README for the full reference.
Version Tracking
Skills either track the hub branch by default or are pinned to a specific point in time.
zanat skill add vercel.frontend.react-patterns # tracks hub branch
zanat skill add vercel.frontend.react-patterns --pin=v1.2.0 # pinned to tag
zanat skill add vercel.frontend.react-patterns --pin=abc1234 # pinned to commit
Tracked skills update when you run zanat skill update. Pinned skills never auto-update. Re-add without --pin to resume tracking.
Writing Skills
A skill is a markdown file with a short YAML frontmatter header:
---
name: code-review
description: Reviews code for quality, correctness, and readability
---
# Code Review
When reviewing code, focus on...
The only required fields are name and description. Everything below the frontmatter is the instruction content the agent will read.
Store skills in a Git repository organized by namespace. The directory path becomes the skill's identifier:
hub/anthropic/code-review/SKILL.md → anthropic.code-review
hub/vercel/frontend/react/SKILL.md → vercel.frontend.react
See zanat-hub for examples.
MCP Server
Zanat ships a standalone MCP server so agents can manage skills programmatically: search, add, update, and remove without leaving the conversation.
npx @iamramo/zanat-mcp
Add it to your agent's MCP config:
{
"mcpServers": {
"zanat": {
"command": "npx",
"args": ["@iamramo/zanat-mcp"]
}
}
}
| Tool | Description |
|---|---|
search_skills |
Search skills by name or content |
list_skills |
List added skills with version and pin status |
get_skill |
Get the full content of a skill |
add_skill |
Add a skill, optionally pinned to a tag or SHA |
update_skill |
Update one or all non-pinned skills |
remove_skill |
Remove an added skill |
Packages
| Package | Description |
|---|---|
packages/cli |
CLI tool (zanat command) |
packages/core |
Shared core library |
packages/mcp |
MCP server |
Development
git clone git@github.com:iamramo/zanat.git
cd zanat
npm install
npm run build
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.