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.
Badge for your README
Markdown
[](/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
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)
- <h1 align="center">AI Agent Skills</h1>
- <p align="center">
- <strong>My curated library of agent skills, plus the package to build your own.</strong>
- </p>
- <p align="center">
- The skills I actually keep around, organized the way I work.
- </p>
- <!-- GENERATED:library-stats:start -->
- <p align="center">
- <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>
- <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>
- <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>
- <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>
- </p>
- <p align="center"><sub>18 house copies · 123 cataloged upstream</sub></p>
- <!-- GENERATED:library-stats:end -->
- <p align="center"><em>Picked, shelved, and maintained by hand.</em></p>
- <p align="center">
- <a href="./docs/workflows/start-a-library.md"><strong>Build your own library</strong></a>
- ·
- <a href="./FOR_YOUR_AGENT.md"><strong>For your agent</strong></a>
- </p>
- ## 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/<name>/`.
- 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 <name>`.
- 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 <shelf>`, `search <query>`, `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 <name>`.
- ### 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.
- <!-- GENERATED:shelf-table:start -->
- | 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 | 12 | Files, docs, planning, release work, and research-to-output flows. |
- | Agent Engineering | 14 | MCP, skill-building, prompting discipline, and LLM application work. |
- | Marketing | 76 | Brand, strategy, copy, distribution, creative, SEO, conversion, and growth work. |
- <!-- GENERATED:shelf-table:end -->
- The full map lives in [WORK_AREAS.md](./WORK_AREAS.md).
- ## Collections
- Collections are smaller sets. Useful, but secondary to the shelves.
- <!-- GENERATED:collection-table:start -->
- | 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` |
- <!-- GENERATED:collection-table:end -->
- ## 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 <repo-or-path> --skill <name> --area <shelf> --branch <branch> --why "Why this deserves a local copy."
- 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."
- ```
- ## Source Repos
- Current upstream mix:
- <!-- GENERATED:source-table:start -->
- | Source repo | Skills |
- | --- | --- |
- | `MoizIbnYousaf/marketing-cli` | 76 |
- | `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 |
- | `shersdk/skilldex` | 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 |
- <!-- GENERATED:source-table:end -->
- 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 <skill-name>
- npx ai-agent-skills swift
- npx ai-agent-skills mktg
- npx ai-agent-skills marketing-cli
- npx ai-agent-skills install <skill-name> -p
- npx ai-agent-skills install --collection swift-agent-skills -p
- npx ai-agent-skills install --collection mktg -p
- npx ai-agent-skills <owner/repo>
- npx ai-agent-skills install <owner/repo>
- npx ai-agent-skills install <owner/repo>@<skill-name>
- npx ai-agent-skills install <owner/repo> --skill <name>
- npx ai-agent-skills install <owner/repo> --list
- npx ai-agent-skills install ./local-path
- npx ai-agent-skills install <skill-name> --dry-run
- # Maintain
- npx ai-agent-skills sync [name]
- npx ai-agent-skills uninstall <name>
- npx ai-agent-skills check
- npx ai-agent-skills doctor
- npx ai-agent-skills validate [path]
- # Curate
- npx ai-agent-skills catalog <owner/repo> --list
- npx ai-agent-skills catalog <owner/repo> --skill <name> --area <shelf> --branch <branch> --why "<editorial note>"
- npx ai-agent-skills curate <skill-name> --branch "<branch>"
- npx ai-agent-skills curate review
- npx ai-agent-skills vendor <repo-or-path> --skill <name> --area <shelf> --branch <branch> --why "<editorial note>"
- 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 <name>`:
- - `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)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.