$git clone https://github.com/MoizIbnYousaf/Ai-Agent-Skillsai-agent-skills does two things.
| 1 | <h1 align="center">AI Agent Skills</h1> |
| 2 | |
| 3 | <p align="center"> |
| 4 | <strong>My curated library of agent skills, plus the package to build your own.</strong> |
| 5 | </p> |
| 6 | |
| 7 | <p align="center"> |
| 8 | The skills I actually keep around, organized the way I work. |
| 9 | </p> |
| 10 | |
| 11 | <!-- GENERATED:library-stats:start --> |
| 12 | <p align="center"> |
| 13 | <a href="https://github.com/MoizIbnYousaf/Ai-Agent-Skills"><img alt="GitHub stars" src="https://img.shields.io/github/stars/MoizIbnYousaf/Ai-Agent-Skills?style=for-the-badge&label=stars&labelColor=313244&color=89b4fa&logo=github&logoColor=cdd6f4" /></a> |
| 14 | <a href="https://www.npmjs.com/package/ai-agent-skills"><img alt="npm version" src="https://img.shields.io/npm/v/ai-agent-skills?style=for-the-badge&label=version&labelColor=313244&color=b4befe&logo=npm&logoColor=cdd6f4" /></a> |
| 15 | <a href="https://www.npmjs.com/package/ai-agent-skills"><img alt="npm total downloads" src="https://img.shields.io/npm/dt/ai-agent-skills?style=for-the-badge&label=downloads&labelColor=313244&color=f5e0dc&logo=npm&logoColor=cdd6f4" /></a> |
| 16 | <a href="https://github.com/MoizIbnYousaf/Ai-Agent-Skills#shelves"><img alt="Library structure" src="https://img.shields.io/badge/library-120%20skills%20%C2%B7%206%20shelves-cba6f7?style=for-the-badge&labelColor=313244&logo=bookstack&logoColor=cdd6f4" /></a> |
| 17 | </p> |
| 18 | |
| 19 | <p align="center"><sub>17 house copies · 103 cataloged upstream</sub></p> |
| 20 | <!-- GENERATED:library-stats:end --> |
| 21 | |
| 22 | <p align="center"><em>Picked, shelved, and maintained by hand.</em></p> |
| 23 | |
| 24 | <p align="center"> |
| 25 | <a href="./docs/workflows/start-a-library.md"><strong>Build your own library</strong></a> |
| 26 | · |
| 27 | <a href="./FOR_YOUR_AGENT.md"><strong>For your agent</strong></a> |
| 28 | </p> |
| 29 | |
| 30 | ## Library |
| 31 | |
| 32 | `ai-agent-skills` does two things. |
| 33 | |
| 34 | It ships my curated library, and it gives you the CLI and TUI to build and manage your own. |
| 35 | It works with any Agent Skills-compatible agent. |
| 36 | |
| 37 | The bundled library is organized the way I work: |
| 38 | |
| 39 | - Start with a shelf like `frontend` or `workflow` |
| 40 | - Keep the set small enough to browse quickly |
| 41 | - Keep provenance visible |
| 42 | - Keep notes that explain why a skill is here |
| 43 | |
| 44 | Use `skills.sh` for the broad ecosystem. |
| 45 | Use `ai-agent-skills` when you want a smaller library with shelves, provenance, and notes. |
| 46 | |
| 47 | ## What's New in 4.3.1 |
| 48 | |
| 49 | - Marketing pack synced to `marketing-cli@0.5.4` — 53 skills total, including the latest `cmo-remotion` and `remotion-best-practices` mirrors |
| 50 | - Renamed the upstream marketing pack source from `MoizIbnYousaf/mktg` to `MoizIbnYousaf/marketing-cli` across catalog metadata, install sources, and source URLs |
| 51 | - Bundled library now ships 115 cataloged skills (17 house copies, 98 cataloged upstream) |
| 52 | - Same private-library bootstrap, bulk import, and managed-workspace flow shipped in `4.3.0` |
| 53 | |
| 54 | ## What It Is Now |
| 55 | |
| 56 | I launched this on December 17, 2025, before `skills.sh` existed and before the ecosystem had a clear default universal installer. |
| 57 | |
| 58 | Originally this repo was that installer. It still does that. |
| 59 | |
| 60 | What started as an installer is now a place to build and manage your own library of skills. |
| 61 | |
| 62 | ## How It Works |
| 63 | |
| 64 | Each skill here is either a house copy or a cataloged upstream pick. |
| 65 | |
| 66 | - `House copies` |
| 67 | Local folders under `skills/<name>/`. |
| 68 | These install fast, work offline, and ship with the npm package. |
| 69 | |
| 70 | - `Cataloged upstream` |
| 71 | Metadata in `skills.json` with no local folder. |
| 72 | These stay upstream and install from the source repo when you ask for them. |
| 73 | |
| 74 | Upstream work stays upstream. That keeps the library lean. |
| 75 | |
| 76 | ## For Your Agent |
| 77 | |
| 78 | Tell your agent to build you a library. Paste this, or just point it at this repo — the protocol below has everything it needs. |
| 79 | |
| 80 | Full protocol with curator decision framework: [FOR_YOUR_AGENT.md](./FOR_YOUR_AGENT.md) |
| 81 | |
| 82 | ### Paste this into your agent |
| 83 | |
| 84 | ```text |
| 85 | Set up a managed team skills library for me with `ai-agent-skills`. |
| 86 | |
| 87 | Read the full agent protocol here before starting: |
| 88 | https://raw.githubusercontent.com/MoizIbnYousaf/Ai-Agent-Skills/main/FOR_YOUR_AGENT.md |
| 89 | |
| 90 | Use the CLI with `npx`. Do not hand-edit `skills.json`, `RE |