Skip to content
Back to search

ai-agent-skills

Universal skill installer and package manager for AI coding agents. One command, 12+ runtimes. npx ai-agent-skills

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/moizibnyousaf-ai-agent-skills/badge.svg)](/listings/moizibnyousaf-ai-agent-skills)

HTML

<a href="/listings/moizibnyousaf-ai-agent-skills"><img src="/api/listings/moizibnyousaf-ai-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Use the bundled library

# 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 <name>`.

Start your own library

# 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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 433 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <h1 align="center">AI Agent Skills</h1>
  2. <p align="center">
  3. <strong>My curated library of agent skills, plus the package to build your own.</strong>
  4. </p>
  5. <p align="center">
  6. The skills I actually keep around, organized the way I work.
  7. </p>
  8. <!-- GENERATED:library-stats:start -->
  9. <p align="center">
  10. <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>
  11. <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>
  12. <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>
  13. <a href="https://github.com/MoizIbnYousaf/Ai-Agent-Skills#shelves"><img alt="Library structure" src="https://img.shields.io/badge/library-141%20skills%20%C2%B7%206%20shelves-cba6f7?style=for-the-badge&labelColor=313244&logo=bookstack&logoColor=cdd6f4" /></a>
  14. </p>
  15. <p align="center"><sub>18 house copies · 123 cataloged upstream</sub></p>
  16. <!-- GENERATED:library-stats:end -->
  17. <p align="center"><em>Picked, shelved, and maintained by hand.</em></p>
  18. <p align="center">
  19. <a href="./docs/workflows/start-a-library.md"><strong>Build your own library</strong></a>
  20. ·
  21. <a href="./FOR_YOUR_AGENT.md"><strong>For your agent</strong></a>
  22. </p>
  23. ## Library
  24. `ai-agent-skills` does two things.
  25. It ships my curated library, and it gives you the CLI and TUI to build and manage your own.
  26. It works with any Agent Skills-compatible agent.
  27. The bundled library is organized the way I work:
  28. - Start with a shelf like `frontend` or `workflow`
  29. - Keep the set small enough to browse quickly
  30. - Keep provenance visible
  31. - Keep notes that explain why a skill is here
  32. Use `skills.sh` for the broad ecosystem.
  33. Use `ai-agent-skills` when you want a smaller library with shelves, provenance, and notes.
  34. ## What's New in 4.3.1
  35. - Marketing pack synced to `marketing-cli@0.5.4` — 53 skills total, including the latest `cmo-remotion` and `remotion-best-practices` mirrors
  36. - Renamed the upstream marketing pack source from `MoizIbnYousaf/mktg` to `MoizIbnYousaf/marketing-cli` across catalog metadata, install sources, and source URLs
  37. - Bundled library now ships 115 cataloged skills (17 house copies, 98 cataloged upstream)
  38. - Same private-library bootstrap, bulk import, and managed-workspace flow shipped in `4.3.0`
  39. ## What It Is Now
  40. I launched this on December 17, 2025, before `skills.sh` existed and before the ecosystem had a clear default universal installer.
  41. Originally this repo was that installer. It still does that.
  42. What started as an installer is now a place to build and manage your own library of skills.
  43. ## How It Works
  44. Each skill here is either a house copy or a cataloged upstream pick.
  45. - `House copies`
  46. Local folders under `skills/<name>/`.
  47. These install fast, work offline, and ship with the npm package.
  48. - `Cataloged upstream`
  49. Metadata in `skills.json` with no local folder.
  50. These stay upstream and install from the source repo when you ask for them.
  51. Upstream work stays upstream. That keeps the library lean.
  52. ## For Your Agent
  53. Tell your agent to build you a library. Paste this, or just point it at this repo — the protocol below has everything it needs.
  54. Full protocol with curator decision framework: [FOR_YOUR_AGENT.md](./FOR_YOUR_AGENT.md)
  55. ### Paste this into your agent
  56. ```text
  57. Set up a managed team skills library for me with `ai-agent-skills`.
  58. Read the full agent protocol here before starting:
  59. https://raw.githubusercontent.com/MoizIbnYousaf/Ai-Agent-Skills/main/FOR_YOUR_AGENT.md
  60. Use the CLI with `npx`. Do not hand-edit `skills.json`, `README.md`, or `WORK_AREAS.md` if the command already exists.
  61. 1. Fetch and read FOR_YOUR_AGENT.md above — it has the full curator decision protocol.
  62. 2. Create a workspace with `npx ai-agent-skills init-library <name>`.
  63. 3. Ask me at most 3 short questions: what kinds of work, small or broad, local draft or shared repo.
  64. 4. Map my stack to shelves: frontend, backend, mobile, workflow, agent-engineering.
  65. 5. Run a discovery loop: `list --area <shelf>`, `search <query>`, `collections`.
  66. 6. Add 3-8 skills with explicit `--area`, `--branch`, and `--why` on every mutation.
  67. 7. Run `npx ai-agent-skills build-docs` before finishing.
  68. 8. If I want it shared: `git init && git add . && git commit -m "Initialize skills library" && gh repo create`.
  69. 9. Tell me what you added, which shelves, and the install command for teammates.
  70. ```
  71. The companion workflow skills (installed automatically when you use the library):
  72. ```
  73. npx ai-agent-skills install install-from-remote-library
  74. npx ai-agent-skills install curate-a-team-library
  75. npx ai-agent-skills install share-a-library
  76. npx ai-agent-skills install browse-and-evaluate
  77. npx ai-agent-skills install update-installed-skills
  78. npx ai-agent-skills install build-workspace-docs
  79. npx ai-agent-skills install review-a-skill
  80. npx ai-agent-skills install audit-library-health
  81. npx ai-agent-skills install migrate-skills-between-libraries
  82. ```
  83. ## Quick Start
  84. ### Use the bundled library
  85. ```bash
  86. # Open the terminal browser
  87. npx ai-agent-skills
  88. # List the shelves
  89. npx ai-agent-skills list
  90. # Install a skill from the library
  91. npx ai-agent-skills install frontend-design
  92. # Install the Swift hub to the default global targets
  93. npx ai-agent-skills swift
  94. # Install an entire curated pack
  95. npx ai-agent-skills install --collection swift-agent-skills -p
  96. # Install the mktg marketing pack
  97. npx ai-agent-skills mktg
  98. npx ai-agent-skills marketing-cli
  99. # Install to the project shelf
  100. npx ai-agent-skills install pdf -p
  101. # Install all skills from an upstream repo to the default global targets
  102. npx ai-agent-skills anthropics/skills
  103. # Browse a repo before adding or installing from it
  104. npx ai-agent-skills install openai/skills --list
  105. ```
  106. Default install targets:
  107. - Global: `~/.claude/skills/`
  108. - Project: `.agents/skills/`
  109. Legacy agent-specific targets still work through `--agent <name>`.
  110. ### Start your own library
  111. ```bash
  112. # Create a managed workspace
  113. npx ai-agent-skills init-library my-library
  114. cd my-library
  115. # Add a bundled pick, install it, refresh it, and rebuild the docs
  116. npx ai-agent-skills add frontend-design --area frontend --branch Implementation --why "I want this on my shelf."
  117. npx ai-agent-skills install frontend-design -p
  118. npx ai-agent-skills sync frontend-design -p
  119. 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."
  120. npx ai-agent-skills build-docs
  121. # Or bootstrap an existing flat repo of skills in place
  122. cd ~/projects/my-skills
  123. npx ai-agent-skills init-library . --areas "mobile,workflow,agent-engineering" --import --auto-classify
  124. npx ai-agent-skills browse
  125. # Invalid private-only names are skipped and reported.
  126. # Low-confidence imports fall back to workflow with a needs-curation label.
  127. ```
  128. ## Workspace Mode
  129. Workspace mode is part of the normal flow now.
  130. Start with a managed workspace, add a few skills, then keep your shelves current with `add`, `catalog`, `vendor`, `sync`, and `build-docs`.
  131. ```bash
  132. npx ai-agent-skills init-library my-library
  133. cd my-library
  134. npx ai-agent-skills add frontend-design --area frontend --branch Implementation --why "I want this on my shelf."
  135. npx ai-agent-skills install frontend-design -p
  136. 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."
  137. npx ai-agent-skills sync frontend-design -p
  138. npx ai-agent-skills build-docs
  139. # Bulk import an existing library after bootstrap
  140. npx ai-agent-skills import --auto-classify
  141. # Review the fallback bucket and fix shelf placement
  142. npx ai-agent-skills list --area workflow
  143. npx ai-agent-skills curate some-skill --area mobile --branch "Mobile / Testing" --why "Why it belongs."
  144. ```
  145. Workflow guides:
  146. - [Start a library](./docs/workflows/start-a-library.md)
  147. - [Add an upstream skill](./docs/workflows/add-an-upstream-skill.md)
  148. - [Make a house copy](./docs/workflows/make-a-house-copy.md)
  149. - [Organize shelves](./docs/workflows/organize-shelves.md)
  150. - [Refresh installed skills](./docs/workflows/refresh-installed-skills.md)
  151. ## Browse
  152. Most browsing starts in one of two places:
  153. | View | Why it exists | Start here |
  154. | --- | --- | --- |
  155. | 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` |
  156. | Sources | The provenance view: see which publishers feed which shelves and branches. | `npx ai-agent-skills info frontend-design` |
  157. The other views are still useful, just more situational:
  158. - `npx ai-agent-skills browse` for the TUI
  159. - `npx ai-agent-skills list --collection my-picks` for a cross-shelf starter stack
  160. - `npx ai-agent-skills install --collection swift-agent-skills -p` for an installable curated pack
  161. - `npx ai-agent-skills curate review` for the curator cleanup queue
  162. ## Shelves
  163. The shelves are the main structure.
  164. <!-- GENERATED:shelf-table:start -->
  165. | Shelf | Skills | What it covers |
  166. | --- | --- | --- |
  167. | Frontend | 10 | Interfaces, design systems, browser work, and product polish. |
  168. | Backend | 5 | Systems, data, security, and runtime operations. |
  169. | Mobile | 24 | Swift, SwiftUI, iOS, and Apple-platform development, with room for future React Native branches. |
  170. | Workflow | 12 | Files, docs, planning, release work, and research-to-output flows. |
  171. | Agent Engineering | 14 | MCP, skill-building, prompting discipline, and LLM application work. |
  172. | Marketing | 76 | Brand, strategy, copy, distribution, creative, SEO, conversion, and growth work. |
  173. <!-- GENERATED:shelf-table:end -->
  174. The full map lives in [WORK_AREAS.md](./WORK_AREAS.md).
  175. ## Collections
  176. Collections are smaller sets. Useful, but secondary to the shelves.
  177. <!-- GENERATED:collection-table:start -->
  178. | Collection | Why it exists | Start here |
  179. | --- | --- | --- |
  180. | `my-picks` | A short starter stack. These are the skills I reach for first. | `frontend-design`, `mcp-builder`, `pdf` |
  181. | `build-apps` | Frontend, UI, and design work for shipping polished apps. | `frontend-design`, `figma-implement-design`, `shadcn` |
  182. | `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` |
  183. | `build-systems` | Backend, architecture, MCP, and security work. | `mcp-builder`, `backend-development`, `database-design` |
  184. | `test-and-debug` | QA, debugging, CI cleanup, and observability. | `playwright`, `webapp-testing`, `gh-fix-ci` |
  185. | `docs-and-research` | Docs, files, research, and writing work. | `pdf`, `doc-coauthoring`, `docx` |
  186. | `mktg` | The full upstream marketing-cli playbook. Install the whole set at once or pick from it. | `cmo`, `brand-voice`, `positioning-angles` |
  187. <!-- GENERATED:collection-table:end -->
  188. ## Curating the catalog
  189. Use `catalog` when you want to add an upstream skill without vendoring it.
  190. In a managed workspace, start with `add`.
  191. Use `catalog` and `vendor` when you want more control.
  192. ```bash
  193. npx ai-agent-skills catalog openai/skills --list
  194. npx ai-agent-skills catalog openai/skills --skill linear --area workflow --branch Linear
  195. npx ai-agent-skills catalog openai/skills --skill security-best-practices --area backend --branch Security
  196. npx ai-agent-skills catalog conorluddy/ios-simulator-skill --skill ios-simulator-skill --area mobile --branch "Swift / Tools" --collection swift-agent-skills
  197. npx ai-agent-skills catalog shadcn-ui/ui --skill shadcn --area frontend --branch Components
  198. ```
  199. It does not create a local copy.
  200. It adds metadata and placement in the active library:
  201. - which shelf it belongs on
  202. - what branch it lives under
  203. - why it earned a place
  204. - how it should install later
  205. For existing picks, use `curate` for quick edits:
  206. ```bash
  207. npx ai-agent-skills curate frontend-design --branch Implementation
  208. npx ai-agent-skills curate ios-simulator-skill --collection swift-agent-skills
  209. npx ai-agent-skills curate ios-simulator-skill --remove-from-collection swift-agent-skills
  210. npx ai-agent-skills curate frontend-design --why "A stronger note that matches how I actually use it."
  211. npx ai-agent-skills curate review
  212. ```
  213. When I want a local copy, I use `vendor`:
  214. ```bash
  215. npx ai-agent-skills vendor <repo-or-path> --skill <name> --area <shelf> --branch <branch> --why "Why this deserves a local copy."
  216. npx ai-agent-skills vendor <repo-or-path> --skill <name> --area mobile --branch "Swift / Tools" --collection swift-agent-skills --why "Why this deserves a place in the Swift pack."
  217. ```
  218. ## Source Repos
  219. Current upstream mix:
  220. <!-- GENERATED:source-table:start -->
  221. | Source repo | Skills |
  222. | --- | --- |
  223. | `MoizIbnYousaf/marketing-cli` | 76 |
  224. | `anthropics/skills` | 11 |
  225. | `MoizIbnYousaf/Ai-Agent-Skills` | 11 |
  226. | `openai/skills` | 9 |
  227. | `Dimillian/Skills` | 4 |
  228. | `wshobson/agents` | 4 |
  229. | `rgmez/apple-accessibility-skills` | 3 |
  230. | `ComposioHQ/awesome-claude-skills` | 2 |
  231. | `andrewgleave/skills` | 1 |
  232. | `arjitj2/swiftui-design-principles` | 1 |
  233. | `AvdLee/Core-Data-Agent-Skill` | 1 |
  234. | `AvdLee/Swift-Concurrency-Agent-Skill` | 1 |
  235. | `AvdLee/Swift-Testing-Agent-Skill` | 1 |
  236. | `bocato/swift-testing-agent-skill` | 1 |
  237. | `conorluddy/ios-simulator-skill` | 1 |
  238. | `dadederk/iOS-Accessibility-Agent-Skill` | 1 |
  239. | `efremidze/swift-architecture-skill` | 1 |
  240. | `emilkowalski/skill` | 1 |
  241. | `Erikote04/Swift-API-Design-Guidelines-Agent-Skill` | 1 |
  242. | `ivan-magda/swift-security-skill` | 1 |
  243. | `PasqualeVittoriosi/swift-accessibility-skill` | 1 |
  244. | `raphaelsalaja/userinterface-wiki` | 1 |
  245. | `shadcn-ui/ui` | 1 |
  246. | `shersdk/skilldex` | 1 |
  247. | `twostraws/Swift-Concurrency-Agent-Skill` | 1 |
  248. | `twostraws/Swift-Testing-Agent-Skill` | 1 |
  249. | `twostraws/SwiftData-Agent-Skill` | 1 |
  250. | `twostraws/SwiftUI-Agent-Skill` | 1 |
  251. | `vanab/swiftdata-agent-skill` | 1 |
  252. <!-- GENERATED:source-table:end -->
  253. The two biggest upstream publishers in this library are Anthropic and OpenAI.
  254. I browse, pick, and shelve. I do not mirror everything they publish.
  255. ## Commands
  256. ```bash
  257. # Browse
  258. npx ai-agent-skills
  259. npx ai-agent-skills browse
  260. npx ai-agent-skills list
  261. npx ai-agent-skills list --work-area frontend
  262. npx ai-agent-skills collections
  263. npx ai-agent-skills search frontend
  264. npx ai-agent-skills info frontend-design
  265. npx ai-agent-skills preview pdf
  266. # Install
  267. npx ai-agent-skills install <skill-name>
  268. npx ai-agent-skills swift
  269. npx ai-agent-skills mktg
  270. npx ai-agent-skills marketing-cli
  271. npx ai-agent-skills install <skill-name> -p
  272. npx ai-agent-skills install --collection swift-agent-skills -p
  273. npx ai-agent-skills install --collection mktg -p
  274. npx ai-agent-skills <owner/repo>
  275. npx ai-agent-skills install <owner/repo>
  276. npx ai-agent-skills install <owner/repo>@<skill-name>
  277. npx ai-agent-skills install <owner/repo> --skill <name>
  278. npx ai-agent-skills install <owner/repo> --list
  279. npx ai-agent-skills install ./local-path
  280. npx ai-agent-skills install <skill-name> --dry-run
  281. # Maintain
  282. npx ai-agent-skills sync [name]
  283. npx ai-agent-skills uninstall <name>
  284. npx ai-agent-skills check
  285. npx ai-agent-skills doctor
  286. npx ai-agent-skills validate [path]
  287. # Curate
  288. npx ai-agent-skills catalog <owner/repo> --list
  289. npx ai-agent-skills catalog <owner/repo> --skill <name> --area <shelf> --branch <branch> --why "<editorial note>"
  290. npx ai-agent-skills curate <skill-name> --branch "<branch>"
  291. npx ai-agent-skills curate review
  292. npx ai-agent-skills vendor <repo-or-path> --skill <name> --area <shelf> --branch <branch> --why "<editorial note>"
  293. npx ai-agent-skills import [path] --auto-classify
  294. ```
  295. ## Testing
  296. - `npm test`
  297. Fast regression coverage for CLI behavior, schema rules, routing, and local install flows.
  298. - `npm run test:live`
  299. 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`.
  300. - `npm run test:live:quick`
  301. A smaller live matrix for faster iteration with the same no-mock pipeline.
  302. ## Legacy Agent Support
  303. Still supported through `--agent <name>`:
  304. - `claude`
  305. - `cursor`
  306. - `codex`
  307. - `amp`
  308. - `vscode`
  309. - `copilot`
  310. - `gemini`
  311. - `goose`
  312. - `opencode`
  313. - `letta`
  314. - `kilocode`
  315. - `project`
  316. ## What I Care About
  317. - Small shelves
  318. - Clear provenance
  319. - Notes that explain why something stays
  320. - Upstream repos staying upstream
  321. - A library that looks cared for
  322. ## Contributing
  323. This is a curated library.
  324. Read [CURATION.md](./CURATION.md) before opening a PR.
  325. ## Related
  326. - [WORK_AREAS.md](./WORK_AREAS.md)
  327. - [CURATION.md](./CURATION.md)
  328. - [CONTRIBUTING.md](./CONTRIBUTING.md)
  329. - [Agent Skills specification](https://agentskills.io)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.