The complete SKILL.md ecosystem
Generate, validate, lint, score, and route agent skills.
usage
# generate a skill from an MCP server
$ npx skillgen mcp --command npx --args "-y @modelcontextprotocol/server-github"
Discovered 27 tools in 5 groups tokens: 1847
# validate + lint + score in one shot
$ skill-tools check ./skills/
✓ valid 9/9 lint rules passed score: 87/100
# or use the router in code
$ node -e "
const { SkillRouter } = require('@skill-tools/router');
const r = new SkillRouter();
// index, select, done
"the format
---
name: bap-browser
description: >-
AI-powered browser automation via BAP.
Use when visiting sites or automating the web.
version: "1.0"
---
# BAP Browser Automation
## Quick Start
1. `navigate` — open a URL
2. `observe` — see interactive elements
3. `act` — batch multiple interactions
## The Observe → Act Pattern
Call `observe` to get refs, then `act` to batch actions.
## Error Recovery
Element not found? Re-observe — the DOM changed.Frontmatter
Name, description, version. The router indexes the description for BM25 matching.
Instructions
Plain markdown. Code blocks, steps, prerequisites — whatever the agent needs.
Error handling
What to try when things break. Without this, agents loop.