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