ai-agent-skills

One installer. 191 skills. 28 categories. Zero borrowed credibility. Hermes Agent · Claude Code · Cursor · OpenCode · anything that reads SKILL.md

Quick start · Categories · Provenance · Conflicts · Sync strategy · Contributing · FAQ

---

🤔 What are agent skills?

Agent skills are instruction files that teach AI coding agents how to do specific tasks. Think of them like recipes — each SKILL.md file contains step-by-step procedures, best practices, and pitfalls for a particular workflow (debugging, code review, deploying, etc.).

When you give your AI agent access to these files, it can:

• Follow proven workflows instead of improvising
• Avoid common mistakes documented in the skill
• Use the right tools and commands for each task
• Work more consistently across sessions

No code to install, no dependencies. Skills are just markdown files your agent reads. Drop them in a folder, point your agent at it, done.

Which agents support this?

Any agent that reads markdown instruction files:

• Hermes Agent — ~/.hermes/skills/
• Claude Code — ~/.claude/skills/
• Cursor — ~/.cursor/skills/
• OpenCode, Windsurf, Cline — configure your skills directory
• Any custom agent — just point it at the folder

---

🎬 Demo

---

⚡ The 30-second pitch

   ┌─ obra/superpowers ─────┐
   ├─ mattpocock/skills ────┤      191 SKILL.md files
   ├─ addyosmani/agent-… ──→│  →   one-command installer  →   ~/.hermes/skills/
   ├─ kepano/obsidian-skills┤      validation CI                ~/.claude/skills/
   ├─ original (Hermes/Nous)┤      REST API (:5555)             ~/.cursor/skills/
   └─ community + adapted ──┘      attribution metadata

Derivative work, full attribution. Most skill content was authored by other people in their public repos. The value-add here is the aggregation, categorization, conflict detection, validation tooling, attribution metadata, and a portable installer. The named upstream authors did not contribute to or endorse this repo — see NOTICE and per-skill source_url: frontmatter.

[!IMPORTANT] Want the canonical version of one author's skills? Install directly from their repo. Links in NOTICE.

---

📦 Quick start

AgentCommand

🜲 Hermes Agent

git clone --recurse-submodules https://github.com/kevinnft/ai-agent-skills.git
cd ai-agent-skills && ./scripts/install.sh

🟧 Claude Code

git clone --recurse-submodules https://github.com/kevinnft/ai-agent-skills.git
cd ai-agent-skills && ./scripts/install.sh --agent claude --preset developer

🟦 Cursor

git clone --recurse-submodules https://github.com/kevinnft/ai-agent-skills.git
cd ai-agent-skills && ./scripts/install.sh --agent cursor --preset developer

🟪 Anything else

./scripts/install.sh --agent custom --target /path/to/your/agent/skills --preset minimal

🐍 Windows (no WSL)

git clone --recurse-submodules https://github.com/kevinnft/ai-agent-skills.git
cd ai-agent-skills && python scripts/install.py

Installer flags

./scripts/install.sh --list                  # browse all categories
./scripts/install.sh --list-presets          # browse curated starter packs
./scripts/install.sh --preset developer      # 5-category dev bundle (~92 skills)
./scripts/install.sh --preset minimal        # just superpowers (14 skills)
./scripts/install.sh --category superpowers  # install one category
./scripts/install.sh --dry-run --preset full # preview without copying
./scripts/install.sh --validate              # lint frontmatter
./scripts/install.sh --help

Curated starter packs

Preset	Categories	Approx size
developer	superpowers, software-development, addyosmani, mattpocock, github	~92
researcher	research, mlops, data-science, note-taking	~29
content-creator	creative, media, social-media, productivity	~37
devops	devops, github, mcp, autonomous-ai-agents	~24
agentic	superpowers, autonomous-ai-agents, mcp, red-teaming	~20
minimal	superpowers	14

Uninstalling

./scripts/uninstall.sh --preset minimal       # remove a preset
./scripts/uninstall.sh --category creative    # remove one category
./scripts/uninstall.sh --all --dry-run        # preview a full wipe
./scripts/uninstall.sh --help

A timestamped backup is created before each removal unless you pass --no-backup.

Tip: start with one preset. --preset minimal is the smallest meaningful slice. If you like the way the agentic loop feels, scale up with --preset developer or another category. Prefer the installer over raw cp -r so duplicate names and submodules are handled correctly.

Dual-use / red-team skills

A small number of skills document security research or dual-use workflows (notably red-teaming/godmode). They are opt-in:

• Not required for normal coding/research presets (minimal, developer, researcher, content-creator, devops)
• Included only via --category red-teaming or --preset agentic
• Review the skill body before enabling, and only use against systems you own or are authorized to test

See SECURITY.md for reporting and dual-use guidance.

---

🎯 Categories

Counts verified at every release with find skills -name SKILL.md after git submodule update --init.

🛠️ Engineering — 80

• 🔵 addyosmani/ — 22   production engineering
• 🟣 mattpocock/ — 28   TypeScript & workflows
• 🟢 superpowers/ — 14   agentic patterns
• 🟡 software-development/ — 16   mixed

🎨 Creative — 22

Diagrams · ASCII art · p5.js · ComfyUI · DESIGN.md tokens · pixel art · Manim · TouchDesigner · Excalidraw

🤖 MLOps —