AI Agent Skills
My curated library of agent skills, plus the package to build your own.
The skills I actually keep around, organized the way I work.
17 house copies · 103 cataloged upstream
Picked, shelved, and maintained by hand.
Build your own library
·
For your agent
## Library
`ai-agent-skills` does two things.
It ships my curated library, and it gives you the CLI and TUI to build and manage your own.
It works with any Agent Skills-compatible agent.
The bundled library is organized the way I work:
- Start with a shelf like `frontend` or `workflow`
- Keep the set small enough to browse quickly
- Keep provenance visible
- Keep notes that explain why a skill is here
Use `skills.sh` for the broad ecosystem.
Use `ai-agent-skills` when you want a smaller library with shelves, provenance, and notes.
## What's New in 4.3.1
- Marketing pack synced to `marketing-cli@0.5.4` — 53 skills total, including the latest `cmo-remotion` and `remotion-best-practices` mirrors
- Renamed the upstream marketing pack source from `MoizIbnYousaf/mktg` to `MoizIbnYousaf/marketing-cli` across catalog metadata, install sources, and source URLs
- Bundled library now ships 115 cataloged skills (17 house copies, 98 cataloged upstream)
- Same private-library bootstrap, bulk import, and managed-workspace flow shipped in `4.3.0`
## What It Is Now
I launched this on December 17, 2025, before `skills.sh` existed and before the ecosystem had a clear default universal installer.
Originally this repo was that installer. It still does that.
What started as an installer is now a place to build and manage your own library of skills.
## How It Works
Each skill here is either a house copy or a cataloged upstream pick.
- `House copies`
Local folders under `skills//`.
These install fast, work offline, and ship with the npm package.
- `Cataloged upstream`
Metadata in `skills.json` with no local folder.
These stay upstream and install from the source repo when you ask for them.
Upstream work stays upstream. That keeps the library lean.
## For Your Agent
Tell your agent to build you a library. Paste this, or just point it at this repo — the protocol below has everything it needs.
Full protocol with curator decision framework: [FOR_YOUR_AGENT.md](./FOR_YOUR_AGENT.md)
### Paste this into your agent
```text
Set up a managed team skills library for me with `ai-agent-skills`.
Read the full agent protocol here before starting:
https://raw.githubusercontent.com/MoizIbnYousaf/Ai-Agent-Skills/main/FOR_YOUR_AGENT.md
Use the CLI with `npx`. Do not hand-edit `skills.json`, `README.md`, or `WORK_AREAS.md` if the command already exists.
1. Fetch and read FOR_YOUR_AGENT.md above — it has the full curator decision protocol.
2. Create a workspace with `npx ai-agent-skills init-library `.
3. Ask me at most 3 short questions: what kinds of work, small or broad, local draft or shared repo.
4. Map my stack to shelves: frontend, backend, mobile, workflow, agent-engineering.
5. Run a discovery loop: `list --area `, `search `, `collections`.
6. Add 3-8 skills with explicit `--area`, `--branch`, and `--why` on every mutation.
7. Run `npx ai-agent-skills build-docs` before finishing.
8. If I want it shared: `git init && git add . && git commit -m "Initialize skills library" && gh repo create`.
9. Tell me what you added, which shelves, and the install command for teammates.
```
The companion workflow skills (installed automatically when you use the library):
```
npx ai-agent-skills install install-from-remote-library
npx ai-agent-skills install curate-a-team-library
npx ai-agent-skills install share-a-library
npx ai-agent-skills install browse-and-evaluate
npx ai-agent-skills install update-installed-skills
npx ai-agent-skills install build-workspace-docs
npx ai-agent-skills install review-a-skill
npx ai-agent-skills install audit-library-health
npx ai-agent-skills install migrate-skills-between-libraries
```
## Quick Start
### Use the bundled library
```bash
# Open the terminal browser
npx ai-agent-skills
# List the shelves
npx ai-agent-skills list
# Install a skill from the library
npx ai-agent-skills install frontend-design
# Install the Swift hub to the default global targets
npx ai-agent-skills swift
# Install an entire curated pack
npx ai-agent-skills install --collection swift-agent-skills -p
# Install the mktg marketing pack
npx ai-agent-skills mktg
npx ai-agent-skills marketing-cli
# Install to the project shelf
npx ai-agent-skills install pdf -p
# Install all skills from an upstream repo to the default global targets
npx ai-agent-skills anthropics/skills
# Browse a repo before adding or installing from it
npx ai-agent-skills install openai/skills --list
```
Default install targets:
- Global: `~/.claude/skills/`
- Project: `.agents/skills/`
Legacy agent-specific targets still work through `--agent `.
### Start your own library
```bash
# Create a managed workspace
npx ai-agent-skills init-library my-library
cd my-library
# Add a bundled pick, install it, refresh it, and rebuild the docs
npx ai-agent-skills add frontend-design --area frontend --branch Implementation --why "I want this on my shelf."
npx ai-agent-skills install frontend-design -p
npx ai-agent-skills sync frontend-design -p
npx ai-agent-skills add anthropics/skills --skill webapp-testing --area workflow --branch Testing --why "I use this when I want browser-level checks in the workspace."
npx ai-agent-skills build-docs
# Or bootstrap an existing flat repo of skills in place
cd ~/projects/my-skills
npx ai-agent-skills init-library . --areas "mobile,workflow,agent-engineering" --import --auto-classify
npx ai-agent-skills browse
# Invalid private-only names are skipped and reported.
# Low-confidence imports fall back to workflow with a needs-curation label.
```
## Workspace Mode
Workspace mode is part of the normal flow now.
Start with a managed workspace, add a few skills, then keep your shelves current with `add`, `catalog`, `vendor`, `sync`, and `build-docs`.
```bash
npx ai-agent-skills init-library my-library
cd my-library
npx ai-agent-skills add frontend-design --area frontend --branch Implementation --why "I want this on my shelf."
npx ai-agent-skills install frontend-design -p
npx ai-agent-skills add anthropics/skills --skill webapp-testing --area workflow --branch Testing --why "I use this when I want browser-level checks in the workspace."
npx ai-agent-skills sync frontend-design -p
npx ai-agent-skills build-docs
# Bulk import an existing library after bootstrap
npx ai-agent-skills import --auto-classify
# Review the fallback bucket and fix shelf placement
npx ai-agent-skills list --area workflow
npx ai-agent-skills curate some-skill --area mobile --branch "Mobile / Testing" --why "Why it belongs."
```
Workflow guides:
- [Start a library](./docs/workflows/start-a-library.md)
- [Add an upstream skill](./docs/workflows/add-an-upstream-skill.md)
- [Make a house copy](./docs/workflows/make-a-house-copy.md)
- [Organize shelves](./docs/workflows/organize-shelves.md)
- [Refresh installed skills](./docs/workflows/refresh-installed-skills.md)
## Browse
Most browsing starts in one of two places:
| View | Why it exists | Start here |
| --- | --- | --- |
| Shelves | The main way to understand the library: start with the kind of work, then drill into the small set of picks on that shelf. | `npx ai-agent-skills list` |
| Sources | The provenance view: see which publishers feed which shelves and branches. | `npx ai-agent-skills info frontend-design` |
The other views are still useful, just more situational:
- `npx ai-agent-skills browse` for the TUI
- `npx ai-agent-skills list --collection my-picks` for a cross-shelf starter stack
- `npx ai-agent-skills install --collection swift-agent-skills -p` for an installable curated pack
- `npx ai-agent-skills curate review` for the curator cleanup queue
## Shelves
The shelves are the main structure.
| Shelf | Skills | What it covers |
| --- | --- | --- |
| Frontend | 10 | Interfaces, design systems, browser work, and product polish. |
| Backend | 5 | Systems, data, security, and runtime operations. |
| Mobile | 24 | Swift, SwiftUI, iOS, and Apple-platform development, with room for future React Native branches. |
| Workflow | 11 | Files, docs, planning, release work, and research-to-output flows. |
| Agent Engineering | 14 | MCP, skill-building, prompting discipline, and LLM application work. |
| Marketing | 56 | Brand, strategy, copy, distribution, creative, SEO, conversion, and growth work. |
The full map lives in [WORK_AREAS.md](./WORK_AREAS.md).
## Collections
Collections are smaller sets. Useful, but secondary to the shelves.
| Collection | Why it exists | Start here |
| --- | --- | --- |
| `my-picks` | A short starter stack. These are the skills I reach for first. | `frontend-design`, `mcp-builder`, `pdf` |
| `build-apps` | Frontend, UI, and design work for shipping polished apps. | `frontend-design`, `figma-implement-design`, `shadcn` |
| `swift-agent-skills` | The main Swift and Apple-platform set in this library. Install it all at once or pick from it. | `swiftui-pro`, `swiftui-ui-patterns`, `swiftui-design-principles` |
| `build-systems` | Backend, architecture, MCP, and security work. | `mcp-builder`, `backend-development`, `database-design` |
| `test-and-debug` | QA, debugging, CI cleanup, and observability. | `playwright`, `webapp-testing`, `gh-fix-ci` |
| `docs-and-research` | Docs, files, research, and writing work. | `pdf`, `doc-coauthoring`, `docx` |
| `mktg` | The full upstream marketing-cli playbook. Install the whole set at once or pick from it. | `cmo`, `brand-voice`, `positioning-angles` |
## Curating the catalog
Use `catalog` when you want to add an upstream skill without vendoring it.
In a managed workspace, start with `add`.
Use `catalog` and `vendor` when you want more control.
```bash
npx ai-agent-skills catalog openai/skills --list
npx ai-agent-skills catalog openai/skills --skill linear --area workflow --branch Linear
npx ai-agent-skills catalog openai/skills --skill security-best-practices --area backend --branch Security
npx ai-agent-skills catalog conorluddy/ios-simulator-skill --skill ios-simulator-skill --area mobile --branch "Swift / Tools" --collection swift-agent-skills
npx ai-agent-skills catalog shadcn-ui/ui --skill shadcn --area frontend --branch Components
```
It does not create a local copy.
It adds metadata and placement in the active library:
- which shelf it belongs on
- what branch it lives under
- why it earned a place
- how it should install later
For existing picks, use `curate` for quick edits:
```bash
npx ai-agent-skills curate frontend-design --branch Implementation
npx ai-agent-skills curate ios-simulator-skill --collection swift-agent-skills
npx ai-agent-skills curate ios-simulator-skill --remove-from-collection swift-agent-skills
npx ai-agent-skills curate frontend-design --why "A stronger note that matches how I actually use it."
npx ai-agent-skills curate review
```
When I want a local copy, I use `vendor`:
```bash
npx ai-agent-skills vendor --skill --area --branch --why "Why this deserves a local copy."
npx ai-agent-skills vendor --skill --area mobile --branch "Swift / Tools" --collection swift-agent-skills --why "Why this deserves a place in the Swift pack."
```
## Source Repos
Current upstream mix:
| Source repo | Skills |
| --- | --- |
| `MoizIbnYousaf/marketing-cli` | 56 |
| `anthropics/skills` | 11 |
| `MoizIbnYousaf/Ai-Agent-Skills` | 11 |
| `openai/skills` | 9 |
| `Dimillian/Skills` | 4 |
| `wshobson/agents` | 4 |
| `rgmez/apple-accessibility-skills` | 3 |
| `ComposioHQ/awesome-claude-skills` | 2 |
| `andrewgleave/skills` | 1 |
| `arjitj2/swiftui-design-principles` | 1 |
| `AvdLee/Core-Data-Agent-Skill` | 1 |
| `AvdLee/Swift-Concurrency-Agent-Skill` | 1 |
| `AvdLee/Swift-Testing-Agent-Skill` | 1 |
| `bocato/swift-testing-agent-skill` | 1 |
| `conorluddy/ios-simulator-skill` | 1 |
| `dadederk/iOS-Accessibility-Agent-Skill` | 1 |
| `efremidze/swift-architecture-skill` | 1 |
| `emilkowalski/skill` | 1 |
| `Erikote04/Swift-API-Design-Guidelines-Agent-Skill` | 1 |
| `ivan-magda/swift-security-skill` | 1 |
| `PasqualeVittoriosi/swift-accessibility-skill` | 1 |
| `raphaelsalaja/userinterface-wiki` | 1 |
| `shadcn-ui/ui` | 1 |
| `twostraws/Swift-Concurrency-Agent-Skill` | 1 |
| `twostraws/Swift-Testing-Agent-Skill` | 1 |
| `twostraws/SwiftData-Agent-Skill` | 1 |
| `twostraws/SwiftUI-Agent-Skill` | 1 |
| `vanab/swiftdata-agent-skill` | 1 |
The two biggest upstream publishers in this library are Anthropic and OpenAI.
I browse, pick, and shelve. I do not mirror everything they publish.
## Commands
```bash
# Browse
npx ai-agent-skills
npx ai-agent-skills browse
npx ai-agent-skills list
npx ai-agent-skills list --work-area frontend
npx ai-agent-skills collections
npx ai-agent-skills search frontend
npx ai-agent-skills info frontend-design
npx ai-agent-skills preview pdf
# Install
npx ai-agent-skills install
npx ai-agent-skills swift
npx ai-agent-skills mktg
npx ai-agent-skills marketing-cli
npx ai-agent-skills install -p
npx ai-agent-skills install --collection swift-agent-skills -p
npx ai-agent-skills install --collection mktg -p
npx ai-agent-skills
npx ai-agent-skills install
npx ai-agent-skills install @
npx ai-agent-skills install --skill
npx ai-agent-skills install --list
npx ai-agent-skills install ./local-path
npx ai-agent-skills install --dry-run
# Maintain
npx ai-agent-skills sync [name]
npx ai-agent-skills uninstall
npx ai-agent-skills check
npx ai-agent-skills doctor
npx ai-agent-skills validate [path]
# Curate
npx ai-agent-skills catalog --list
npx ai-agent-skills catalog --skill --area --branch --why ""
npx ai-agent-skills curate --branch ""
npx ai-agent-skills curate review
npx ai-agent-skills vendor --skill --area --branch --why ""
npx ai-agent-skills import [path] --auto-classify
```
## Testing
- `npm test`
Fast regression coverage for CLI behavior, schema rules, routing, and local install flows.
- `npm run test:live`
No-mock live verification. Clones the real upstream repos, captures raw `SKILL.md` frontmatter and file manifests, runs real install/sync/uninstall flows in isolated temp homes and projects, drives the TUI through a real PTY, and writes a report to `tmp/live-test-report.json`.
- `npm run test:live:quick`
A smaller live matrix for faster iteration with the same no-mock pipeline.
## Legacy Agent Support
Still supported through `--agent `:
- `claude`
- `cursor`
- `codex`
- `amp`
- `vscode`
- `copilot`
- `gemini`
- `goose`
- `opencode`
- `letta`
- `kilocode`
- `project`
## What I Care About
- Small shelves
- Clear provenance
- Notes that explain why something stays
- Upstream repos staying upstream
- A library that looks cared for
## Contributing
This is a curated library.
Read [CURATION.md](./CURATION.md) before opening a PR.
## Related
- [WORK_AREAS.md](./WORK_AREAS.md)
- [CURATION.md](./CURATION.md)
- [CONTRIBUTING.md](./CONTRIBUTING.md)
- [Agent Skills specification](https://agentskills.io)