Skip to content

skill-mcp v0.2.0

Latest
Latest

Choose a tag to compare

View all tags
@tsumon tsumon released this 07 Sep 02:59
v0.2.0
2e6aa9d

skill-mcp v0.2.0

Local stdio MCP that lists, suggests, and binds at most 3 local SKILL.md files. Token budget never raises the cap.

A — Mac / local attach

./scripts/install.sh builds the server and writes absolute-path Claude Desktop / Cursor mcp.json snippets (docs/output/…). Mac path: ~/Library/Application Support/Claude/claude_desktop_config.json.

B — 30-second demo

Install too many skills → suggest_skills (cap 3) → bind_skills → write_host_contract. See README EN/ZH.

C — Host contract actually takes effect

write_host_contract / node dist/index.js write-contract writes Claude CLAUDE.md and Cursor .cursor/rules/skill-mcp-contract.mdc in one shot. Generated files list only bound skills and forbid others.

D — Offline goldens in CI

.github/workflows/ci.yml runs npm test, npx tsc --noEmit, npm run build, and npm run eval on pull requests and main.

E — Optional binary

./scripts/pack.sh (bun compile) produces skill-mcp-linux-x64. Fallback: npm run build && node dist/index.js. See docs/PACKAGING.md.

F — Empty suggest

When nothing matches: This directory has no matching skill for that prompt. / 该目录下没有匹配该提示的技能。

G — Auto-uninstall (dry-run / --apply)

  • Default is dry-run: report idle and shadowed user-tier skills; never moves or deletes.
  • Real move only with CLI --apply or MCP { "apply": true }.
  • Destination: ~/.config/skill-mcp/archive/<timestamp>/ plus manifest.json. Recoverable. Never silent-deletes.
node dist/index.js archive-idle
node dist/index.js archive-idle --apply

H — Native skills bypass (toggle / restore / risk)

  • native-skills enable writes Claude skillOverrides name-only so the host listing does not dump every description.
  • native-skills restore (or { "enabled": false }) restores the previous ~/.claude/settings.json in one step.
  • Risk: routing fight with Claude Code native skills. Plugin skills are not covered. Restore immediately if routing feels wrong. Does not delete SKILL.md files.
node dist/index.js native-skills enable
node dist/index.js native-skills restore

Constraints held

stdio MCP only · max 3 · CJK ZH/JA/KO · read_skill opt-in · no store · no ranker retrain · no GIF in README

Assets 4
Loading