Claude Skills Library

<p align="center"><img src=".github/assets/hero.svg" width="100%" alt="Claude Skills Library hero banner"/></p>

<div align="center">

# Claude Skills Library

### 114 Agent Skills for every skills-aware runtime, and 7 enforcement packs for Claude Code

Skills teach an agent a domain. Packs make the agent go through the gate. This is the only public
library that ships both, with provenance pinned to commits, counts that check themselves in CI, and
hooks that block "done" until the evidence exists.

[![License: MIT](https://img.shields.io/badge/License-MIT-10b981.svg)](LICENSE)
[![Skills](https://img.shields.io/badge/skills-114-blue.svg)](docs/CATALOG.md)
[![Packs](https://img.shields.io/badge/packs-7-06b6d4.svg)](#packs-skills-that-enforce)
[![Runtimes](https://img.shields.io/badge/runtimes-6-blueviolet.svg)](#works-with-six-runtimes)
[![Validate](https://github.com/frankxai/claude-skills-library/actions/workflows/validate.yml/badge.svg)](https://github.com/frankxai/claude-skills-library/actions/workflows/validate.yml)
[![Pack tests](https://github.com/frankxai/claude-skills-library/actions/workflows/pack-tests.yml/badge.svg)](https://github.com/frankxai/claude-skills-library/actions/workflows/pack-tests.yml)
[![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

[**Install**](#install) · [**Packs**](#packs-skills-that-enforce) · [**Catalog**](docs/CATALOG.md) · [**Strategy**](docs/STRATEGY.md) · [**Contribute**](CONTRIBUTING.md) · [**FAQ**](#faq)

</div>

---

## Install

Three ways in. Pick one.

```text
# 1. Claude Code plugin — auto-updating, skills discovered on their own
/plugin marketplace add frankxai/claude-skills-library
/plugin install claude-skills-library@claude-skills-library
```

```bash
# 2. skills.sh — the top-level skills, or a curated lane
#    (the skills nested under anthropic/, creative/ and technical/ come via the plugin or a clone)
npx skills add frankxai/claude-skills-library
npx skills add frankxai/skills            # AI architects: MCP, orchestration, model routing
npx skills add frankxai/creator-skills    # creators: video, music, images, brand voice
```

```bash
# 3. Clone and copy only what you want
git clone https://github.com/frankxai/claude-skills-library.git ~/claude-skills-library
mkdir -p ~/.claude/skills
cp -r ~/claude-skills-library/free-skills/mcp-architecture ~/.claude/skills/   # one
cp -r ~/claude-skills-library/free-skills/* ~/.claude/skills/                  # all
```

Some skills are namespaced (`free-skills/anthropic/pdf`). Copy the folder that directly contains the
`SKILL.md`. Restart Claude Code and the skills are discovered.

**Then work.** Skills fire on their own from their `description`, or you name one:

```text
"Design an MCP server with the mcp-architecture skill."
"Review this PR with the github-code-review skill."
"Run the verification-quality skill before you call this done."
```

---

## What is here

Two layers. The first is what every skills repo has. The second is what none of the large ones ship.

| Layer | What it is | Where |
|---|---|---|
| **Skills** | 114 self-contained `SKILL.md` folders. Spec-validated frontmatter, trigger-rich descriptions, deep guidance in `references/` loaded only on use. | [`free-skills/`](free-skills) · [catalog](docs/CATALOG.md) |
| **Packs** | 7 installable contracts. Each bundles the skills for one kind of work with whatever enforcement it has: hooks, CI scripts, drift checks, or templates. The packs table below says which. | [`packs/`](packs) |

A skill is loaded when the task matches its description. That makes it *available*, not *mandatory*.
A pack adds what turns a suggestion into a default, and the mechanism differs by pack.
`web-excellence` installs three hooks: a `SessionStart` note, a `PreToolUse` reminder on the first UI
edit, and a `Stop` hook that blocks once if UI changed with no audit, each shipped with the test that
proves it cannot be satisfied by its own reminder text. `estate-guard` installs a `PreToolUse` gate
that denies the hard stops and a taint hook for fetched content. `routine-contract` ships a CI
workflow and a digest primitive that fails the run when nothing durable was written, for each routine
you wire to it.
`risk-classifier` ships a fail-closed classifier script for you to wire into CI. `agent-infrastructure`
installs skills and checks installed copies against canon. `film-excellence` installs a skill and
templates and is advisory.

---

## Packs: skills that enforce

Installed into 19 repositories across the FrankX, Starlight, and Arcanea estate as of 2026-10-09.
Re-run an installer to upgrade. `web-excellence`, `routine-contract` and `agent-infrastructure` move an installed skill that differs to `.claude/skills/.replaced/<name>`, keeping only the most recent set-aside copy; `estate-guard` and `film-excellence` overwrite their skill in place. In every case, commit or copy a customised skill before re-running. All but `risk-classifier` accept `--

... (truncated)