my curated agent skills library
# Add to your Claude Code skills
git clone https://github.com/MoizIbnYousaf/Ai-Agent-Skillsai-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:
frontend or workflowUse skills.sh for the broad ecosystem.
Use ai-agent-skills when you want a smaller library with shelves, provenance, and notes.
install <owner>/<repo>--format json, --fields, pagination, and safer non-interactive outputsync as the main refresh verb, and stronger installed-state visibility across the CLI and TUII 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.
Each skill here is either a house copy or a cataloged upstream pick.
No comments yet. Be the first to share your thoughts!
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.
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
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
# 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:
~/.claude/skills/.agents/skills/Legacy agent-specific targets still work through --agent <name>.
# 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 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.
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:
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 TUInpx ai-agent-skills list --collection my-picks for a cross-shelf starter stacknpx ai-agent-skills install --collection swift-agent-skills -p for an installable curated packnpx ai-agent-skills curate review for the curator cleanup queueThe 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 | 46 | Brand, strategy, copy, distribution, creative,