sinhoneyy/master-skills

npx skills add sinhoneyy/master-skills

---

✨ What is Master Skills

One source of truth for agent skills. Instead of juggling scattered, inconsistent collections, you get a single clean catalog — deduplicated, domain-organized, and indexed.

Master Skills is a standardized catalog of 2,658 AI-agent skills, sorted into 15 normalized domains. Every skill is runtime-agnostic — it works with Claude, Codex, Cursor, Antigravity, and anything else that loads SKILL.md skills. Each one has a stable id, version, domain, and slash trigger, all described in one authoritative manifest: skills_index.json.

---

⚡ Install — choose your tool

One command installs the skills into the path your host expects:

Filter what gets installed:

npx master-skills --claude --category security,backend   # only those domains
npx master-skills --cursor --risk safe,none              # only low-risk skills
npx master-skills --list                                 # show all categories
npx master-skills --path ./skills --dry-run              # preview, write nothing

Default tool paths are best-effort — if your host stores skills elsewhere, use --path.

Or clone and point your agent’s loader at skills/ directly. No build step, no dependencies. ✅

---

🧩 Install as a plugin (Claude · Codex · Antigravity)

Master Skills ships as one plugin with a manifest for each platform, so the same catalog installs everywhere:

Claude Code

/plugin marketplace add sinhoneyy/master-skills
/plugin install master-skills@master-skills

Codex — point Codex at the repo; it reads .codex-plugin/plugin.json (skills → ./skills/).

Antigravity — add the repo as a plugin source; it reads .agents/plugins/marketplace.json.

Themed bundles

Prefer a focused set over all 2,658? Install just the role bundle you need (Claude & Antigravity):

/plugin install master-skills-security-engineer@master-skills
/plugin install master-skills-frontend-designer@master-skills

The full master-skills plugin (all 2,658) remains installable on its own.

---

🗂 The 15 domains

Live counts always reflect skills_index.json → categories.

---

📦 The manifest

A single JSON document, skills_index.json, describes the entire library.

{
  "name": "master-skills",
  "schemaVersion": "1.0",
  "skill_count": 2658,
  "categories": { "integrations": 812, "general": 421, "backend": 233, "…": 0 },
  "skills": [
    {
      "id": "api-design-principles",
      "name": "API Design Principles",
      "version": "1.0.0",
      "description": "Guidelines for designing clean, consistent APIs…",
      "category": "backend",
      "trigger": "/api-design-principles",
      "path": "skills/api-design-principles"
    }
  ]
}

---

📁 Repository layout

master-skills/
├─ 📂 skills/                    # 2,658 skills, flat (domain lives in the manifest)
│   ├─ api-design-principles/SKILL.md
│   ├─ adversarial-reviewer/SKILL.md
│   └─ …
├─ 🧩 .claude-plugin/            # Claude Code plugin + marketplace manifest
├─ 🧩 .codex-plugin/             # Codex plugin manifest
├─ 🧩 .agents/plugins/           # Antigravity marketplace manifest
├─ 🗂️ skills_index.json          # the manifest (id, version, category, trigger, path)
├─ 📜 CREDITS.md                  # license/source notes + full upstream notices
└─ 📖 README.md

---

▶️ Using a skill

1.  Find it      →  search skills_index.json by id / trigger / category
2.  Open it      →  go to its "path", e.g. skills/api-design-principles/
3.  Invoke it    →  use its "trigger" (/api-design-principles) in your agent

Each skill keeps its full payload — SKILL.md, references, scripts, examples — exactly as published. Or just point your runtime’s skill loader at the whole skills/ directory.

---

❓ FAQ

---

🤝 Contributing

PRs are welcome! Good first contributions:

• ➕ Add new skills as skills//SKILL.md (set the domain via frontmatter)
• 🏷️ Improve domain classification so fewer skills land in general
• 🧪 Add manifest validation or search tooling

Once GitHub Actions is approved (when required for first-time fork contributors), CI validates the manifest and lints changed SKILL.md files. Lint results appear in the Actions job summary. Comments are not posted by CI.

---

📜 License

The Master Skills catalog tooling is MIT-licensed. The root package.json license field covers the catalog tooling; it does not relicense third-party skills. Bundled skills retain their own upstream terms. Consult each skill’s nested LICENSE/notice where present and the source attribution in CREDITS.md.

Source imports and compatibility

A new skill in the source index is not automatically an endorsement, published npm release, or proof that every agent host supports it. CI checks repository structure and, for supported imports, bundled examples plus an isolated local npm package/install smoke test. Host-specific behavior and external services require separate verification and any necessary user authorization. Fork PR lint results are always available in the GitHub Actions job summary. Lint reporting uses no PR-comment API or write token.