SKM — Skills Manager

Install, update, and manage skills for AI agents from multiple sources.

Install

pnpm install -g skm-cli

Quick Start

# Add a skill registry
skm registry add public https://github.com/panda850819/skm

# Install a skill
skm install gh-commit

# Install from a third-party GitHub registry
skm registry add vercel https://github.com/vercel-labs/agent-browser
skm install vercel:agent-browser

# Search and install from the skills.sh ecosystem
skm find browser

# Update all installed skills
skm update --all

What is SKM?

SKM is a package manager for Claude Code skills. It handles installing, versioning, and updating skill definitions from multiple registries — your own, third-party GitHub repos, or the skills.sh ecosystem.

Skills are installed as symlinks to ~/.claude/skills/, so they're always up to date with the source.

Commands

skm list                         # List installed skills
skm install <skill>              # Install from default registry
skm install <registry>:<skill>   # Install from specific registry
skm find <query>                 # Search skills.sh and install interactively
skm uninstall <skill>            # Remove skill
skm update --all                 # Update all skills
skm update <skill>               # Update single skill
skm registry add <name> <url>    # Add third-party GitHub registry
skm registry list                # List configured registries
skm info <skill>                 # Show version history
skm outdated                     # Check for updates
skm publish skills/<skill> --version X.Y.Z  # Publish with version tag

Skill Sources

SKM supports three skill sources:

Source	Version Format	Install Method
Own registry (tagged)	1.0.0	skm install <skill>
GitHub repo (untagged)	#abc1234	skm install <registry>:<skill>
skills.sh ecosystem	#latest	skm find <query>

Available Skills

Skill	Model	Description
done	sonnet	Session 結束：存 context MD、總結、存記憶、成長建議
reflect	sonnet	Mid-session 結構化自省：分析 pattern、對照基礎設施、產出成長建議
prefer-pnpm	haiku	強制使用 pnpm
gh-commit	sonnet	自動 commit（Conventional Commits）
gh-push	sonnet	推送到遠端
gh-issue	sonnet	建立 GitHub Issue
gh-pr	sonnet	建立 Pull Request
gh-release	sonnet	建立 GitHub Release + release notes
gh-tag	sonnet	建立 git tag
skill-creator	sonnet	建立新 skill
agent-browser	sonnet	AI-friendly 瀏覽器自動化
openspec	sonnet	OpenSpec 智能路由
opsx-team-apply	sonnet	OpenSpec 多 Agent 平行實作
peon-ping-toggle	haiku	Toggle peon-ping 音效通知
techdebt	sonnet	掃描技術債務
react-best-practices	sonnet	React/Next.js 最佳實踐
web-design-guidelines	sonnet	Web UI 設計規範
rust-tauri-practices	sonnet	Rust + Tauri 2 最佳實踐
research-before-code	sonnet	平台行為型 bug 先研究再寫 code
ui-ux-pro-max	sonnet	UI/UX 設計智能（50+ 風格、97 色盤、57 字型配對、9 技術棧）
ux-design-guide	sonnet	UX 設計流程參考 + Pencil MCP 整合
content-creator	sonnet	SEO 內容生成
marketing-psychology	opus	行銷心理學模型
rss	sonnet	RSS 管理
deepwiki	sonnet	Repo 文件生成
quant-analyst	opus	量化分析、回測、風險
midnight-compact	sonnet	Midnight Compact 智能合約開發
midnight-dapp	sonnet	Midnight DApp 開發（SDK/部署/錢包整合）
wallet-smoke-test	haiku	Midnight Wallet 手動 smoke test checklist
pdf	sonnet	PDF 處理工具（讀取/合併/拆分/OCR/表單/浮水印/加密）
contract-review	sonnet	合約審閱（NDA/SaaS/M&A，CUAD 41 風險分類）
nda-review	sonnet	NDA 逐條審閱（jurisdiction-agnostic）
vendor-due-diligence	sonnet	供應商盡職調查（GDPR/DORA/NIS2）
tech-contract-negotiation	sonnet	技術服務合約談判框架
api2cli	sonnet	將 API 文件轉為可用 CLI，並產生對應 Claude skill
summarize	haiku	URL/YouTube/檔案摘要

Directory Structure

skills/<skill>/      ← Skill source (SKILL.md + optional modules/)
cli/                 ← SKM CLI source (TypeScript, Commander.js)
registry.yaml        ← Skill metadata registry

Writing Your Own Skills

Each skill is a directory with a SKILL.md file containing YAML frontmatter:

---
name: my-skill
description: "Brief desc. Use when [triggers]. Triggers on \"keywords\"."
user-invocable: true
allowed-tools: Read, Write, Edit, Bash, Glob, Grep
---

# Your skill instructions here

Publish to your own registry:

skm publish skills/my-skill --version 1.0.0

License

MIT