Claude Code Skills

A categorized collection of installable skills for Claude Code.

9 categories · 67 canonical installable units · symlink installer · 9 git submodules · MIT for original skills

简体中文 · English

Note

Current state. This repository is the category tree, installer, and governance layer for the skills; each skill is a SKILL.md package with optional scripts, templates, and references. Packaging decisions live in GOVERNANCE.md, and the retired ai-coding-skills repository is kept under archive/ai-coding-skills/.

✨ Features

• Nine categories. Skills are grouped into productivity, development, documents, research, ai-collaboration, product-management, security, design, and system.
• Symlink installer. ./install.sh links every directory that contains a SKILL.md into ~/.claude/skills; skill files stay in the clone instead of being copied.
• Two install profiles. The default profile installs every installable unit, including 22 compatibility wrappers; --canonical-only skips those wrappers and keeps the smallest supported surface.
• Category routers. Six category roots ship a toolkit SKILL.md that maps a user intent to a skill and its templates.
• Submodule tracking. Nine repositories are tracked as git submodules, so their skills keep their own release history and licenses.
• Self-contained skills. Each skill keeps its instructions and support files in one directory; no shared runtime is required to install a skill.
• Install hygiene. The installer skips an existing real directory at a target path and removes stale symlinks that point into the repository but no longer resolve.
• Governance in-repo. GOVERNANCE.md defines the installable-unit rule, submodule retention criteria, compatibility-wrapper policy, and source-repo retirement checklist.
• Archive retained. archive/ai-coding-skills/ preserves 23 skills from the former ai-coding-skills repository; they are not part of the install surface.
• No build step. There is no build or compile step; installation needs only git and bash.

🧠 Architecture

flowchart LR
    subgraph repo["claude-code-skills"]
        Routers["Category routers\n6 x SKILL.md"]
        Bundled["Bundled skills\nSKILL.md + scripts + templates"]
        Submodules["Upstream submodules\n9 repositories"]
        Archive["archive/ai-coding-skills\nnot installed"]
    end

    Installer["install.sh"]
    Links["~/.claude/skills\nsymlinks"]
    Claude["Claude Code"]

    Routers --> Installer
    Bundled --> Installer
    Submodules --> Installer
    Installer -->|ln -s| Links
    Links --> Claude

Loading

install.sh walks each category directory, counts directories that contain SKILL.md, and links the toolkit router plus those skills into ~/.claude/skills. --canonical-only applies the wrapper list in is_compat_skill before linking. Submodule packs whose SKILL.md sits below their root are left in the tree but are not flattened into the install surface. Claude Code reads the linked directories from ~/.claude/skills.

The repository layout is documented in docs/catalog.md, which also holds the full per-category skill tables and the compatibility-wrapper list.

🚀 Quick start

Requirements: Claude Code, git, and bash. Network access is needed to initialize the nine submodules. The installer writes symlinks to ~/.claude/skills.

git clone --recurse-submodules https://github.com/LeoLin990405/claude-code-skills.git
cd claude-code-skills
./install.sh

Install one category, or skip the legacy wrappers:

./install.sh productivity              # one category only
./install.sh --canonical-only          # smallest supported surface
./install.sh --list                    # category counts and missing submodules
./install.sh --help

To link a single skill without the installer:

git clone --recurse-submodules https://github.com/LeoLin990405/claude-code-skills.git
ln -s "$PWD/claude-code-skills/productivity/obsidian-cli" ~/.claude/skills/obsidian-cli

Update submodules after pulling:

git submodule update --remote --merge

Tip

./install.sh --list prints the per-category count and warns when submodule skills are not initialized. --canonical-only is the recommended profile for new installs; the default profile exists for backward compatibility.

🗂️ Categories

Counts match ./install.sh --canonical-only --list: toolkit routers are included, legacy compatibility wrappers are excluded, and nested external packs are not flattened into the default install surface.

	Category	Canonical units	Highlights
🗂️	Productivity	9	Obsidian CLI, NotebookLM, Google Workspace
💻	Development	12	D3.js, R Analytics, MCP, frontend
📄	Documents	7	PDF, DOCX, PPTX, XLSX, MinerU
🔬	Research	5	140+ scientific skills, STEM modeling, research workflows
🤖	AI Collaboration	5	Multi-AI Gateway, Agent Teams
📊	Product Management	17	Lenny's Podcast -- 86 actionable PM skills
🔒	Security	0 direct / 2 external packs	Trail of Bits (50+ skills), ffuf
🎨	Design	7	Canvas Art, Themes, GIF Creation
⚙️	System	5	Proxy, CDP, SVN, Internal Comms

Six category roots also expose a toolkit router SKILL.md migrated from the former claude-skills umbrella repository: ai-collaboration/ (coordination), productivity/ (knowledge), development/ (developer), documents/ (document), design/ (design), and product-management/ (PM). Compatibility wrappers remain in-repo for legacy installs; see docs/catalog.md for the full list.

🔗 Submodules

Nine repositories are linked as submodules. Most are upstream packs; r-analytics and mineru are self-owned skills that stay independently maintained. Some expose a root-level skill that install.sh can link directly; others are nested packs that stay available in-tree without being flattened into the install surface.

Pack	Repository	Category	Install surface
claude-d3js-skill	chrisvoncsefalvay/claude-d3js-skill	Development	root skill
playwright-skill	lackeyjb/playwright-skill	Development	nested pack
ios-simulator-skill	conorluddy/ios-simulator-skill	Development	nested pack
r-analytics	LeoLin990405/r-analytics-skill	Development	root skill
mineru	LeoLin990405/mineru-skill	Documents	root skill
superpowers	obra/superpowers	AI Collaboration	nested pack
trailofbits-security	trailofbits/skills	Security	nested pack
ffuf_claude_skill	jthack/ffuf_claude_skill	Security	nested pack
web-asset-generator	alonw0/web-asset-generator	Design	nested pack

Submodule governance updates in this repository:

• productivity/obsidian-cli is vendored to remove a self-owned submodule dependency.
• documents/mineru remains a self-owned submodule because it still has a standalone release surface: CLI script, examples, changelog, and contributing guide.
• development/r-analytics remains a self-owned submodule because it is still treated as an independent canonical repo.
• development/github-repo-design is vendored to remove a self-owned submodule dependency.
• research/aris was removed from the catalog after its source repository was archived.

📁 Repository layout

Path	Contents
productivity/	Obsidian, Google Workspace, NotebookLM, and knowledge-capture skills
development/	Frontend, MCP, skill-authoring, database, and testing skills
documents/	PDF, DOCX, PPTX, XLSX, and MinerU conversion skills
research/	Scientific skills, STEM modeling, history notes, blog writing, macro research
ai-collaboration/	Multi-AI gateway, agent teams, docs lookup, skill discovery
product-management/	Lenny's Podcast-derived PM skills and legacy pm-* wrappers
security/, design/, system/	Security packs, visual assets, and host tooling skills
docs/	Banner asset and the full skill catalog
archive/	Former ai-coding-skills repository, kept as historical source
install.sh	Symlink installer with category, profile, and list modes
GOVERNANCE.md, CONTRIBUTING.md	Packaging rules and contribution guide

🛠️ Development

The repository has no build step and no repository-level CI workflow or automated test suite; the installer is the only executable entry point. Inspect the surface before linking anything:

./install.sh --list
./install.sh --canonical-only --list

Test the installer against a scratch home if you do not want to touch your real Claude directory:

HOME=$(mktemp -d) ./install.sh --canonical-only

To add a skill, follow CONTRIBUTING.md and GOVERNANCE.md:

1. create <category>/<skill-name>/SKILL.md with name, description, and triggers frontmatter;
2. keep templates, scripts, and references inside the skill directory;
3. add the skill row to docs/catalog.md;
4. install it locally with ./install.sh <category> and test it in Claude Code;
5. open a pull request using the repository template.

🧭 Scope & limits

The repository packages and installs skills; it does not run, host, or validate them.

• Symlinks, not copies. Deleting or moving the clone leaves broken links in ~/.claude/skills; the next install.sh run prunes links that point into the repository and no longer resolve.
• Existing directories are skipped. If ~/.claude/skills/<name> is a real directory, the installer leaves it untouched instead of merging or overwriting it.
• Nested packs are not flattened. Six submodules are nested packs; security/ therefore has 0 direct installable units and its two packs must be used from their upstream layout.
• Submodule state changes the count. Without git submodule update --init --recursive, the three root-level submodule skills are missing and --canonical-only --list reports 64 instead of 67.
• Per-skill dependencies are not managed. Skills that call external services or APIs document their own requirements in their SKILL.md; the installer installs no packages.
• No automated validation. There is no CI workflow or test suite at the repository level, so skill behavior and licensing compliance are checked by the contributor.
• Mixed licensing. Root original skills are MIT, but bundled and submodule skills keep their own terms; see the license table below before redistributing.

🤝 Contributing

Issues and pull requests are welcome. Read CONTRIBUTING.md for the skill format and GOVERNANCE.md before adding a submodule, vendoring a source repo, or changing install-surface behavior.

The pull request template asks for the skill name, category, and type (bundled / submodule), plus confirmation that the directory contains a SKILL.md with valid frontmatter and was tested with ./install.sh. Keep one concern per skill and do not include unrelated changes.

If this collection is useful to you, consider leaving a ⭐ — it helps others find it.

📄 License & attribution

The repository's own code and original skills are released under the MIT License, copyright © 2025 LeoLin990405. There is no separate NOTICE file; third-party terms are kept inside the skill directories.

Scope	Terms
Original skills, install.sh, docs	MIT (LICENSE)
documents/docx, documents/pdf, documents/pptx, documents/xlsx	Anthropic terms in each skill's LICENSE.txt
Eleven bundled skills under design/, development/, system/	Apache-2.0 LICENSE.txt in each skill
research/claude-scientific-skills	MIT, copyright © 2025 K-Dense Inc. (LICENSE.md)
Nine submodules	Their upstream licenses; retained by each repository
archive/ai-coding-skills	MIT, copyright © 2026 LeoLin990405

Attribution: the product-management skills are derived from Lenny's Podcast; the scientific skills come from K-Dense; the four document-format skills and several design/development skills carry Anthropic's terms. Submodule repositories and links are listed in the submodule table.

⭐ Star history