[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-MoizIbnYousaf--Ai-Agent-Skills":3,"tool-MoizIbnYousaf--Ai-Agent-Skills":64},[4,17,27,35,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,43,44,45,15,46,26,13,47],"数据工具","视频","插件","其他","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,46],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70626,"2026-04-05T22:51:36",[26,15,13,45],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":80,"owner_email":80,"owner_twitter":75,"owner_website":81,"owner_url":82,"languages":83,"stars":92,"forks":93,"last_commit_at":94,"license":95,"difficulty_score":23,"env_os":96,"env_gpu":97,"env_ram":97,"env_deps":98,"category_tags":104,"github_topics":105,"view_count":23,"oss_zip_url":80,"oss_zip_packed_at":80,"status":16,"created_at":113,"updated_at":114,"faqs":115,"releases":146},3636,"MoizIbnYousaf\u002FAi-Agent-Skills","Ai-Agent-Skills","my curated agent skills library ","Ai-Agent-Skills 是一个精心策划的 AI 智能体技能库，同时也提供了一套完整的命令行工具，帮助开发者构建和管理专属的技能集合。它解决了在快速迭代的 AI 生态中，技能资源分散、来源不明以及难以高效复用的痛点。通过引入“书架（Shelves）”概念，它将技能按场景（如前端开发、工作流自动化）分类整理，确保库内资源精简且易于浏览。\n\n该工具特别适合 AI 应用开发者、智能体架构师以及希望标准化团队技能资产的技术人员使用。其核心亮点在于独特的混合管理模式：既包含可离线快速安装的本地副本（House copies），也支持按需从上游仓库拉取的最新技能（Cataloged upstream），在保持轻量级的同时兼顾了灵活性与时效性。此外，它还内置了详细的来源追溯和使用笔记，让每个技能的选用理由清晰可见。配合全新的 CLI 和终端用户界面（TUI），用户可以轻松实现依赖感知安装、版本同步及库的初始化，是打造高质量、可维护 AI 智能体团队的得力助手。","\u003Ch1 align=\"center\">AI Agent Skills\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>My curated library of agent skills, plus the package to build your own.\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  The skills I actually keep around, organized the way I work.\n\u003C\u002Fp>\n\n\u003C!-- GENERATED:library-stats:start -->\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills\">\u003Cimg alt=\"GitHub stars\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FMoizIbnYousaf\u002FAi-Agent-Skills?style=for-the-badge&label=stars&labelColor=313244&color=89b4fa&logo=github&logoColor=cdd6f4\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fai-agent-skills\">\u003Cimg alt=\"npm version\" src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fai-agent-skills?style=for-the-badge&label=version&labelColor=313244&color=b4befe&logo=npm&logoColor=cdd6f4\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fai-agent-skills\">\u003Cimg alt=\"npm total downloads\" src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdt\u002Fai-agent-skills?style=for-the-badge&label=downloads&labelColor=313244&color=f5e0dc&logo=npm&logoColor=cdd6f4\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills#shelves\">\u003Cimg alt=\"Library structure\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flibrary-64%20skills%20%C2%B7%205%20shelves-cba6f7?style=for-the-badge&labelColor=313244&logo=bookstack&logoColor=cdd6f4\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Csub>17 house copies · 47 cataloged upstream\u003C\u002Fsub>\u003C\u002Fp>\n\u003C!-- GENERATED:library-stats:end -->\n\n\u003Cp align=\"center\">\u003Cem>Picked, shelved, and maintained by hand.\u003C\u002Fem>\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\".\u002Fdocs\u002Fworkflows\u002Fstart-a-library.md\">\u003Cstrong>Build your own library\u003C\u002Fstrong>\u003C\u002Fa>\n  ·\n  \u003Ca href=\".\u002FFOR_YOUR_AGENT.md\">\u003Cstrong>For your agent\u003C\u002Fstrong>\u003C\u002Fa>\n\u003C\u002Fp>\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.0.0\n\n- Managed library workspaces with `init-library`\n- `add \u003Csource>` for bringing bundled picks, upstream repo skills, or house copies into your own library\n- `sync [name]` as the main refresh command; `update` stays as an alias\n- Dependency-aware installs with `requires` and `--no-deps`\n- Installed status in both the CLI and TUI\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\u002F\u003Cname>\u002F`.\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](.\u002FFOR_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:\u002F\u002Fraw.githubusercontent.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills\u002Fmain\u002FFOR_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 \u003Cname>`.\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 \u003Cshelf>`, `search \u003Cquery>`, `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 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\u002Fskills\n\n# Browse a repo before adding or installing from it\nnpx ai-agent-skills install openai\u002Fskills --list\n```\n\nDefault install targets:\n\n- Global: `~\u002F.claude\u002Fskills\u002F`\n- Project: `.agents\u002Fskills\u002F`\n\nLegacy agent-specific targets still work through `--agent \u003Cname>`.\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\u002Fskills --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\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\u002Fskills --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\nWorkflow guides:\n\n- [Start a library](.\u002Fdocs\u002Fworkflows\u002Fstart-a-library.md)\n- [Add an upstream skill](.\u002Fdocs\u002Fworkflows\u002Fadd-an-upstream-skill.md)\n- [Make a house copy](.\u002Fdocs\u002Fworkflows\u002Fmake-a-house-copy.md)\n- [Organize shelves](.\u002Fdocs\u002Fworkflows\u002Forganize-shelves.md)\n- [Refresh installed skills](.\u002Fdocs\u002Fworkflows\u002Frefresh-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\u003C!-- 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\u003C!-- GENERATED:shelf-table:end -->\n\nThe full map lives in [WORK_AREAS.md](.\u002FWORK_AREAS.md).\n\n## Collections\n\nCollections are smaller sets. Useful, but secondary to the shelves.\n\n\u003C!-- 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`, `frontend-skill`, `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\u003C!-- 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\u002Fskills --list\nnpx ai-agent-skills catalog openai\u002Fskills --skill linear --area workflow --branch Linear\nnpx ai-agent-skills catalog openai\u002Fskills --skill security-best-practices --area backend --branch Security\nnpx ai-agent-skills catalog conorluddy\u002Fios-simulator-skill --skill ios-simulator-skill --area mobile --branch \"Swift \u002F Tools\" --collection swift-agent-skills\nnpx ai-agent-skills catalog shadcn-ui\u002Fui --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 \u003Crepo-or-path> --skill \u003Cname> --area \u003Cshelf> --branch \u003Cbranch> --why \"Why this deserves a local copy.\"\nnpx ai-agent-skills vendor \u003Crepo-or-path> --skill \u003Cname> --area mobile --branch \"Swift \u002F 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\u003C!-- GENERATED:source-table:start -->\n| Source repo | Skills |\n| --- | --- |\n| `anthropics\u002Fskills` | 11 |\n| `MoizIbnYousaf\u002FAi-Agent-Skills` | 11 |\n| `openai\u002Fskills` | 9 |\n| `Dimillian\u002FSkills` | 4 |\n| `wshobson\u002Fagents` | 4 |\n| `rgmez\u002Fapple-accessibility-skills` | 3 |\n| `ComposioHQ\u002Fawesome-claude-skills` | 2 |\n| `andrewgleave\u002Fskills` | 1 |\n| `arjitj2\u002Fswiftui-design-principles` | 1 |\n| `AvdLee\u002FCore-Data-Agent-Skill` | 1 |\n| `AvdLee\u002FSwift-Concurrency-Agent-Skill` | 1 |\n| `AvdLee\u002FSwift-Testing-Agent-Skill` | 1 |\n| `bocato\u002Fswift-testing-agent-skill` | 1 |\n| `conorluddy\u002Fios-simulator-skill` | 1 |\n| `dadederk\u002FiOS-Accessibility-Agent-Skill` | 1 |\n| `efremidze\u002Fswift-architecture-skill` | 1 |\n| `emilkowalski\u002Fskill` | 1 |\n| `Erikote04\u002FSwift-API-Design-Guidelines-Agent-Skill` | 1 |\n| `ivan-magda\u002Fswift-security-skill` | 1 |\n| `PasqualeVittoriosi\u002Fswift-accessibility-skill` | 1 |\n| `raphaelsalaja\u002Fuserinterface-wiki` | 1 |\n| `shadcn-ui\u002Fui` | 1 |\n| `twostraws\u002FSwift-Concurrency-Agent-Skill` | 1 |\n| `twostraws\u002FSwift-Testing-Agent-Skill` | 1 |\n| `twostraws\u002FSwiftData-Agent-Skill` | 1 |\n| `twostraws\u002FSwiftUI-Agent-Skill` | 1 |\n| `vanab\u002Fswiftdata-agent-skill` | 1 |\n\u003C!-- 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 \u003Cskill-name>\nnpx ai-agent-skills swift\nnpx ai-agent-skills install \u003Cskill-name> -p\nnpx ai-agent-skills install --collection swift-agent-skills -p\nnpx ai-agent-skills \u003Cowner\u002Frepo>\nnpx ai-agent-skills install \u003Cowner\u002Frepo>\nnpx ai-agent-skills install \u003Cowner\u002Frepo>@\u003Cskill-name>\nnpx ai-agent-skills install \u003Cowner\u002Frepo> --skill \u003Cname>\nnpx ai-agent-skills install \u003Cowner\u002Frepo> --list\nnpx ai-agent-skills install .\u002Flocal-path\nnpx ai-agent-skills install \u003Cskill-name> --dry-run\n\n# Maintain\nnpx ai-agent-skills sync [name]\nnpx ai-agent-skills uninstall \u003Cname>\nnpx ai-agent-skills check\nnpx ai-agent-skills doctor\nnpx ai-agent-skills validate [path]\n\n# Curate\nnpx ai-agent-skills catalog \u003Cowner\u002Frepo> --list\nnpx ai-agent-skills catalog \u003Cowner\u002Frepo> --skill \u003Cname> --area \u003Cshelf> --branch \u003Cbranch> --why \"\u003Ceditorial note>\"\nnpx ai-agent-skills curate \u003Cskill-name> --branch \"\u003Cbranch>\"\nnpx ai-agent-skills curate review\nnpx ai-agent-skills vendor \u003Crepo-or-path> --skill \u003Cname> --area \u003Cshelf> --branch \u003Cbranch> --why \"\u003Ceditorial note>\"\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\u002Fsync\u002Funinstall flows in isolated temp homes and projects, drives the TUI through a real PTY, and writes a report to `tmp\u002Flive-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 \u003Cname>`:\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](.\u002FCURATION.md) before opening a PR.\n\n## Related\n\n- [WORK_AREAS.md](.\u002FWORK_AREAS.md)\n- [CURATION.md](.\u002FCURATION.md)\n- [CONTRIBUTING.md](.\u002FCONTRIBUTING.md)\n- [Agent Skills specification](https:\u002F\u002Fagentskills.io)\n","\u003Ch1 align=\"center\">AI 代理技能库\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>我精心整理的代理技能库，以及用于构建您自己的包。\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  这是我实际使用的技能集合，按照我的工作方式组织。\n\u003C\u002Fp>\n\n\u003C!-- GENERATED:library-stats:start -->\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills\">\u003Cimg alt=\"GitHub 星标\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FMoizIbnYousaf\u002FAi-Agent-Skills?style=for-the-badge&label=stars&labelColor=313244&color=89b4fa&logo=github&logoColor=cdd6f4\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fai-agent-skills\">\u003Cimg alt=\"npm 版本\" src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fai-agent-skills?style=for-the-badge&label=version&labelColor=313244&color=b4befe&logo=npm&logoColor=cdd6f4\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fai-agent-skills\">\u003Cimg alt=\"npm 总下载量\" src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdt\u002Fai-agent-skills?style=for-the-badge&label=downloads&labelColor=313244&color=f5e0dc&logo=npm&logoColor=cdd6f4\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills#shelves\">\u003Cimg alt=\"库结构\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flibrary-64%20skills%20%C2%B7%205%20shelves-cba6f7?style=for-the-badge&labelColor=313244&logo=bookstack&logoColor=cdd6f4\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Csub>17 个本地副本 · 47 个已编目上游技能\u003C\u002Fsub>\u003C\u002Fp>\n\u003C!-- GENERATED:library-stats:end -->\n\n\u003Cp align=\"center\">\u003Cem>手工挑选、分类并维护。\u003C\u002Fem>\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\".\u002Fdocs\u002Fworkflows\u002Fstart-a-library.md\">\u003Cstrong>构建您自己的技能库\u003C\u002Fstrong>\u003C\u002Fa>\n  ·\n  \u003Ca href=\".\u002FFOR_YOUR_AGENT.md\">\u003Cstrong>为您的代理准备\u003C\u002Fstrong>\u003C\u002Fa>\n\u003C\u002Fp>\n\n## 技能库\n\n`ai-agent-skills` 提供两项功能。\n\n它不仅包含我精心整理的技能库，还提供了用于构建和管理您自己技能库的 CLI 和 TUI。该工具可与任何兼容 Agent Skills 的代理配合使用。\n\n随附的技能库按照我的工作方式组织：\n\n- 从 `frontend` 或 `workflow` 等架子开始\n- 保持技能集足够小，便于快速浏览\n- 保留清晰的来源信息\n- 添加注释，解释为何将某项技能放入其中\n\n如果您需要广泛的生态系统支持，请使用 `skills.sh`；而当您希望拥有一个包含架子、来源信息和注释的小型技能库时，则应选择 `ai-agent-skills`。\n\n## 4.0.0 版本的新特性\n\n- 使用 `init-library` 管理技能库工作空间\n- 新增 `add \u003Csource>` 命令，用于将内置精选、上游仓库中的技能或本地副本引入您的技能库\n- 将 `sync [name]` 设为主要的更新命令，`update` 仍作为别名保留\n- 具备依赖感知的安装功能，支持 `requires` 和 `--no-deps`\n- 在 CLI 和 TUI 中均可查看已安装状态\n\n## 当前状况\n\n我在 2025 年 12 月 17 日发布了此项目，当时 `skills.sh` 尚未出现，生态系统也尚未形成明确的默认通用安装程序。\n\n最初，这个仓库就是那个安装程序。如今它仍然承担这一职责。\n\n原本作为安装程序起步的项目，如今已成为构建和管理您个人技能库的场所。\n\n## 工作原理\n\n这里的每项技能要么是本地副本，要么是从上游仓库中精选并编目的版本。\n\n- `本地副本`\n  存放在 `skills\u002F\u003Cname>\u002F` 下的本地文件夹中。这些技能安装迅速，可在离线状态下使用，并随 npm 包一起分发。\n\n- `已编目上游`\n  存在于 `skills.json` 中的元数据，无本地文件夹。这些技能保留在上游，当您请求时会直接从源仓库安装。\n\n上游工作始终保留在上游，从而确保技能库的精简性。\n\n## 为您的代理准备\n\n请让您的代理为您构建一个技能库。您可以粘贴以下内容，或者直接指向此仓库——下方的协议包含了所需的一切。\n\n完整的协议及策展决策框架：[FOR_YOUR_AGENT.md](.\u002FFOR_YOUR_AGENT.md)\n\n### 将以下内容粘贴到您的代理中\n\n```text\n帮我用 `ai-agent-skills` 设置一个受管理的团队技能库。\n\n在开始之前，请先阅读完整的代理协议：\nhttps:\u002F\u002Fraw.githubusercontent.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills\u002Fmain\u002FFOR_YOUR_AGENT.md\n\n请使用 `npx` 命令行工具操作。如果已有相应命令，请勿手动编辑 `skills.json`、`README.md` 或 `WORK_AREAS.md`。\n\n1. 获取并阅读上述 FOR_YOUR_AGENT.md 文件——其中包含完整的策展决策协议。\n2. 使用 `npx ai-agent-skills init-library \u003Cname>` 创建一个工作空间。\n3. 向我提出最多三个简短的问题：您希望处理的工作类型是小型还是广泛？是本地草稿还是共享仓库？\n4. 将我的技术栈映射到各个架子上：前端、后端、移动端、工作流、代理工程。\n5. 运行发现循环：`list --area \u003Cshelf>`、`search \u003Cquery>`、`collections`。\n6. 每次添加技能时，都需明确指定 `--area`、`--branch` 和 `--why` 参数，每次添加 3 到 8 项技能。\n7. 完成前运行 `npx ai-agent-skills build-docs`。\n8. 如果我希望共享此库：`git init && git add . && git commit -m \"初始化技能库\" && gh repo create`。\n9. 告诉我您添加了哪些技能、它们属于哪个架子，以及队友可以用来安装的命令。\n```\n\n配套的工作流程技能（使用技能库时会自动安装）：\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## 快速入门\n\n### 使用内置技能库\n\n```bash\n# 打开终端浏览器\nnpx ai-agent-skills\n\n# 列出所有架子\nnpx ai-agent-skills list\n\n# 从技能库中安装一项技能\nnpx ai-agent-skills install frontend-design\n\n# 将 Swift 中心安装到默认全局目标\nnpx ai-agent-skills swift\n\n# 安装整个精选包\nnpx ai-agent-skills install --collection swift-agent-skills -p\n\n# 安装到项目架子上\nnpx ai-agent-skills install pdf -p\n\n# 将上游仓库中的所有技能安装到默认全局目标\nnpx ai-agent-skills anthropics\u002Fskills\n\n# 在添加或安装之前先浏览某个仓库\nnpx ai-agent-skills install openai\u002Fskills --list\n```\n\n默认安装目标：\n\n- 全局：`~\u002F.claude\u002Fskills\u002F`\n- 项目：`.agents\u002Fskills\u002F`\n\n通过 `--agent \u003Cname>` 参数，仍可使用旧版特定于代理的目标。\n\n### 开始构建您自己的技能库\n\n```bash\n# 创建一个受管理的工作空间\nnpx ai-agent-skills init-library my-library\ncd my-library\n\n# 添加一项内置精选技能，安装、刷新并重新构建文档\nnpx ai-agent-skills add frontend-design --area frontend --branch Implementation --why \"我想把它放在我的架子上。\"\nnpx ai-agent-skills install frontend-design -p\nnpx ai-agent-skills sync frontend-design -p\nnpx ai-agent-skills add anthropics\u002Fskills --skill webapp-testing --area workflow --branch Testing --why \"我在工作区需要进行浏览器级别的检查时会用到它。\"\nnpx ai-agent-skills build-docs\n```\n\n## 工作区模式\n\n工作区模式现在已成为正常流程的一部分。\n\n从一个受管的工作区开始，添加几个技能，然后使用 `add`、`catalog`、`vendor`、`sync` 和 `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\u002Fskills --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\n工作流指南：\n\n- [创建库](.\u002Fdocs\u002Fworkflows\u002Fstart-a-library.md)\n- [添加上游技能](.\u002Fdocs\u002Fworkflows\u002Fadd-an-upstream-skill.md)\n- [制作本地副本](.\u002Fdocs\u002Fworkflows\u002Fmake-a-house-copy.md)\n- [整理货架](.\u002Fdocs\u002Fworkflows\u002Forganize-shelves.md)\n- [刷新已安装的技能](.\u002Fdocs\u002Fworkflows\u002Frefresh-installed-skills.md)\n\n## 浏览\n\n大多数浏览操作都始于以下两个地方：\n\n| 视图 | 存在原因 | 从这里开始 |\n| --- | --- | --- |\n| 货架 | 理解库的主要方式：先从工作类型入手，再深入到该货架上的精选技能。 | `npx ai-agent-skills list` |\n| 来源 | 源头视图：查看哪些发布者为哪些货架和分支提供内容。 | `npx ai-agent-skills info frontend-design` |\n\n其他视图仍然有用，但更多是针对特定场景：\n\n- 使用 `npx ai-agent-skills browse` 进行 TUI 浏览\n- 使用 `npx ai-agent-skills list --collection my-picks` 获取跨货架的入门技能集合\n- 使用 `npx ai-agent-skills install --collection swift-agent-skills -p` 安装可选的精选包\n- 使用 `npx ai-agent-skills curate review` 处理策展人待处理的任务\n\n## 货架\n\n货架是主要的结构。\n\n\u003C!-- GENERATED:shelf-table:start -->\n| 货架 | 技能数量 | 涵盖内容 |\n| --- | --- | --- |\n| 前端 | 10 | 界面、设计系统、浏览器相关工作以及产品优化。 |\n| 后端 | 5 | 系统、数据、安全及运行时操作。 |\n| 移动 | 24 | Swift、SwiftUI、iOS 以及 Apple 平台开发，未来还可扩展 React Native 分支。 |\n| 工作流 | 11 | 文件、文档、计划、发布工作以及研究到产出的流程。 |\n| 代理工程 | 14 | MCP、技能构建、提示工程规范以及 LLM 应用相关工作。 |\n\u003C!-- GENERATED:shelf-table:end -->\n\n完整的地图位于 [WORK_AREAS.md](.\u002FWORK_AREAS.md) 中。\n\n## 收藏集\n\n收藏集是较小的技能集合，虽然有用，但不如货架重要。\n\n\u003C!-- GENERATED:collection-table:start -->\n| 收藏集 | 存在原因 | 从这里开始 |\n| --- | --- | --- |\n| `my-picks` | 一个简短的入门技能集合。这些是我首先会使用的技能。 | `frontend-design`, `mcp-builder`, `pdf` |\n| `build-apps` | 用于交付高质量应用的前端、UI 和设计工作。 | `frontend-design`, `frontend-skill`, `shadcn` |\n| `swift-agent-skills` | 本库中主要的 Swift 和 Apple 平台技能集合。可以一次性全部安装，也可以从中挑选。 | `swiftui-pro`, `swiftui-ui-patterns`, `swiftui-design-principles` |\n| `build-systems` | 后端、架构、MCP 和安全相关工作。 | `mcp-builder`, `backend-development`, `database-design` |\n| `test-and-debug` | QA、调试、CI 清理以及可观ility 相关工作。 | `playwright`, `webapp-testing`, `gh-fix-ci` |\n| `docs-and-research` | 文档、文件、研究和写作相关工作。 | `pdf`, `doc-coauthoring`, `docx` |\n\u003C!-- GENERATED:collection-table:end -->\n\n## 策划目录\n\n当你想添加上游技能而不将其纳入本地副本时，可以使用 `catalog` 命令。\n\n在受管的工作区中，首先使用 `add` 命令。如果需要更多控制，可以使用 `catalog` 和 `vendor` 命令。\n\n```bash\nnpx ai-agent-skills catalog openai\u002Fskills --list\nnpx ai-agent-skills catalog openai\u002Fskills --skill linear --area workflow --branch Linear\nnpx ai-agent-skills catalog openai\u002Fskills --skill security-best-practices --area backend --branch Security\nnpx ai-agent-skills catalog conorluddy\u002Fios-simulator-skill --skill ios-simulator-skill --area mobile --branch \"Swift \u002F Tools\" --collection swift-agent-skills\nnpx ai-agent-skills catalog shadcn-ui\u002Fui --skill shadcn --area frontend --branch Components\n```\n\n这不会创建本地副本，而是添加元数据和在活动库中的位置信息：\n\n- 所属的货架\n- 所在的分支\n- 为何值得收录\n- 未来应如何安装\n\n对于已有的技能，可以使用 `curate` 命令进行快速编辑：\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\n当我需要本地副本时，我会使用 `vendor` 命令：\n\n```bash\nnpx ai-agent-skills vendor \u003Crepo-or-path> --skill \u003Cname> --area \u003Cshelf> --branch \u003Cbranch> --why \"Why this deserves a local copy.\"\nnpx ai-agent-skills vendor \u003Crepo-or-path> --skill \u003Cname> --area mobile --branch \"Swift \u002F Tools\" --collection swift-agent-skills --why \"Why this deserves a place in the Swift pack.\"\n```\n\n## 源代码仓库\n\n当前的上游来源构成：\n\n\u003C!-- GENERATED:source-table:start -->\n| 源代码仓库 | 技能数量 |\n| --- | --- |\n| `anthropics\u002Fskills` | 11 |\n| `MoizIbnYousaf\u002FAi-Agent-Skills` | 11 |\n| `openai\u002Fskills` | 9 |\n| `Dimillian\u002FSkills` | 4 |\n| `wshobson\u002Fagents` | 4 |\n| `rgmez\u002Fapple-accessibility-skills` | 3 |\n| `ComposioHQ\u002Fawesome-claude-skills` | 2 |\n| `andrewgleave\u002Fskills` | 1 |\n| `arjitj2\u002Fswiftui-design-principles` | 1 |\n| `AvdLee\u002FCore-Data-Agent-Skill` | 1 |\n| `AvdLee\u002FSwift-Concurrency-Agent-Skill` | 1 |\n| `AvdLee\u002FSwift-Testing-Agent-Skill` | 1 |\n| `bocato\u002Fswift-testing-agent-skill` | 1 |\n| `conorluddy\u002Fios-simulator-skill` | 1 |\n| `dadederk\u002FiOS-Accessibility-Agent-Skill` | 1 |\n| `efremidze\u002Fswift-architecture-skill` | 1 |\n| `emilkowalski\u002Fskill` | 1 |\n| `Erikote04\u002FSwift-API-Design-Guidelines-Agent-Skill` | 1 |\n| `ivan-magda\u002Fswift-security-skill` | 1 |\n| `PasqualeVittoriosi\u002Fswift-accessibility-skill` | 1 |\n| `raphaelsalaja\u002Fuserinterface-wiki` | 1 |\n| `shadcn-ui\u002Fui` | 1 |\n| `twostraws\u002FSwift-Concurrency-Agent-Skill` | 1 |\n| `twostraws\u002FSwift-Testing-Agent-Skill` | 1 |\n| `twostraws\u002FSwiftData-Agent-Skill` | 1 |\n| `twostraws\u002FSwiftUI-Agent-Skill` | 1 |\n| `vanab\u002Fswiftdata-agent-skill` | 1 |\n\u003C!-- GENERATED:source-table:end -->\n\n本库中最大的两个上游发布者是 Anthropic 和 OpenAI。我会浏览、挑选并上架，但不会完全复制他们发布的所有内容。\n\n## 命令\n\n```bash\n# 浏览\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# 安装\nnpx ai-agent-skills install \u003C技能-名称 >\nnpx ai-agent-skills swift\nnpx ai-agent-skills install \u003C skill-name > -p\nnpx ai-agent-skills install --collection swift-agent-skills -p\nnpx ai-agent-skills \u003C 作者\u002F仓库 >\nnpx ai-agent-skills install \u003C 作者\u002F仓库 >\nnpx ai-agent-skills install \u003C 作者\u002F仓库 >@\u003C 技能-名称 >\nnpx ai-agent-skills install \u003C 作者\u002F仓库 > --skill \u003C 名称 >\nnpx ai-agent-skills install \u003C 作者\u002F仓库 > --list\nnpx ai-agent-skills install .\u002F本地路径\nnpx ai-agent-skills install \u003C 技能-名称 > --dry-run\n\n# 维护\nnpx ai-agent-skills sync [名称]\nnpx ai-agent-skills uninstall \u003C 名称 >\nnpx ai-agent-skills check\nnpx ai-agent-skills doctor\nnpx ai-agent-skills validate [路径]\n\n# 策划\nnpx ai-agent-skills catalog \u003C 作者\u002F仓库 > --list\nnpx ai-agent-skills catalog \u003C 作者\u002F仓库 > --skill \u003C 名称 > --area \u003C 架子 > --branch \u003C 分支 > --why \"\u003C 编辑说明 >\"\nnpx ai-agent-skills curate \u003C 技能-名称 > --branch \"\u003C 分支 >\"\nnpx ai-agent-skills curate review\nnpx ai-agent-skills vendor \u003C 仓库或路径 > --skill \u003C 名称 > --area \u003C 架子 > --branch \u003C 分支 > --why \"\u003C 编辑说明 >\"\n```\n\n## 测试\n\n- `npm test`\n  快速回归覆盖 CLI 行为、模式规则、路由和本地安装流程。\n- `npm run test:live`\n  不使用模拟的真实验证。克隆真实的上游仓库，捕获原始的 `SKILL.md` 前置元数据和文件清单，在隔离的临时目录和项目中运行真实的安装\u002F同步\u002F卸载流程，通过真实的 PTY 驱动 TUI，并将报告写入 `tmp\u002Flive-test-report.json`。\n- `npm run test:live:quick`\n  更小规模的实时测试矩阵，用于在相同的无模拟流水线下更快地迭代。\n\n## 旧版代理支持\n\n仍可通过 `--agent \u003C 名称 >` 支持：\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## 我关注的点\n\n- 小型架子\n- 清晰的来源\n- 解释为何保留某项内容的注释\n- 上游仓库保持其上游地位\n- 一个看起来被精心维护的库\n\n## 贡献\n这是一个精选的库。\n\n在提交 PR 之前，请阅读 [CURATION.md](.\u002FCURATION.md)。\n\n## 相关\n- [WORK_AREAS.md](.\u002FWORK_AREAS.md)\n- [CURATION.md](.\u002FCURATION.md)\n- [CONTRIBUTING.md](.\u002FCONTRIBUTING.md)\n- [Agent Skills 规范](https:\u002F\u002Fagentskills.io)","# Ai-Agent-Skills 快速上手指南\n\n**Ai-Agent-Skills** 是一个精心策划的 AI Agent 技能库，同时提供 CLI 和 TUI 工具，帮助你构建、管理和部署属于自己的技能库。它支持将技能安装到全局或项目目录，兼容任何符合 Agent Skills 规范的 Agent（如 Claude Code 等）。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**: macOS, Linux 或 Windows (需安装 Git Bash 或 WSL)。\n*   **Node.js**: 已安装 Node.js (推荐 v18 或更高版本)，因为该工具通过 `npx` 运行。\n*   **Git**: 已安装 Git，用于拉取上游技能仓库。\n*   **Agent 环境**: 已配置好支持 skills 目录的 AI Agent 环境（默认安装目标通常为 `~\u002F.claude\u002Fskills\u002F` 或项目下的 `.agents\u002Fskills\u002F`）。\n\n> **注意**：本项目主要通过 npm 分发。国内开发者若遇到网络延迟，可配置 npm 镜像源加速下载：\n> ```bash\n> npm config set registry https:\u002F\u002Fregistry.npmmirror.com\n> ```\n\n## 安装步骤\n\n无需全局安装，直接使用 `npx` 即可运行最新版本的工具。\n\n### 1. 验证运行\n在终端执行以下命令打开交互式界面或查看帮助，确认工具可用：\n```bash\nnpx ai-agent-skills\n```\n\n### 2. (可选) 初始化个人技能库\n如果你想建立自己管理的技能库（而非仅使用内置库），请创建一个工作区：\n```bash\nnpx ai-agent-skills init-library my-library\ncd my-library\n```\n\n## 基本使用\n\n### 场景一：直接使用内置精选库\n\n这是最快速的用法，直接从作者维护的库中浏览并安装技能。\n\n**1. 浏览技能架 (Shelves)**\n查看按领域分类的技能列表（如 Frontend, Backend, Mobile 等）：\n```bash\nnpx ai-agent-skills list\n```\n\n**2. 安装单个技能**\n将指定技能安装到默认的全局目标目录：\n```bash\nnpx ai-agent-skills install frontend-design\n```\n\n**3. 安装到当前项目**\n将技能安装到当前项目的 `.agents\u002Fskills\u002F` 目录（使用 `-p` 标志）：\n```bash\nnpx ai-agent-skills install pdf -p\n```\n\n**4. 安装整套精选集合**\n一次性安装一个预定义的技能包（例如 Swift 开发全套）：\n```bash\nnpx ai-agent-skills install --collection swift-agent-skills -p\n```\n\n**5. 从上游仓库安装**\n直接安装来自其他开源仓库（如 anthropics\u002Fskills）的技能：\n```bash\nnpx ai-agent-skills install anthropics\u002Fskills\n```\n\n---\n\n### 场景二：构建和管理自己的技能库\n\n如果你希望定制技能来源、添加备注并维护版本，请使用工作区模式。\n\n**1. 添加技能到库中**\n将内置技能或上游技能收录到你的库中，并指定分类（area）、分支（branch）和理由（why）：\n```bash\n# 添加内置技能\nnpx ai-agent-skills add frontend-design --area frontend --branch Implementation --why \"I want this on my shelf.\"\n\n# 添加上游仓库中的特定技能\nnpx ai-agent-skills add anthropics\u002Fskills --skill webapp-testing --area workflow --branch Testing --why \"I use this when I want browser-level checks in the workspace.\"\n```\n\n**2. 同步与安装**\n收录后，将其安装到目标位置并保持同步：\n```bash\nnpx ai-agent-skills install frontend-design -p\nnpx ai-agent-skills sync frontend-design -p\n```\n\n**3. 生成文档**\n更新库的说明文档，以便团队成员查阅：\n```bash\nnpx ai-agent-skills build-docs\n```\n\n### 核心概念速查\n\n*   **Shelves (技能架)**: 主要的组织方式，按工作领域分类（如 `frontend`, `workflow`）。\n*   **House copies**: 本地副本，包含在 npm 包中，安装快且支持离线。\n*   **Cataloged upstream**: 仅记录元数据，安装时从源仓库实时拉取，保持库轻量。\n*   **默认安装路径**:\n    *   全局：`~\u002F.claude\u002Fskills\u002F`\n    *   项目：`.agents\u002Fskills\u002F`","某全栈开发团队正在构建一个复杂的自动化运维 Agent，需要整合数十个来自不同开源社区的技能模块（如日志分析、自动部署、异常检测）来应对多变的线上故障。\n\n### 没有 Ai-Agent-Skills 时\n- **技能来源混乱**：团队成员各自从 GitHub 零散复制代码，导致本地存在大量重复或版本过时的“孤本”技能，难以统一维护。\n- **缺乏上下文理解**：新加入的技能往往缺少关键的使用说明和选型理由注释，Agent 在调用时经常因参数误解而执行失败。\n- **依赖管理缺失**：手动安装技能时容易忽略隐性依赖库，导致环境配置报错，排查问题耗费大量时间。\n- **更新同步困难**：上游开源项目修复了 Bug 或发布了新功能，本地库无法感知，团队长期使用有安全隐患的旧版本。\n\n### 使用 Ai-Agent-Skills 后\n- **结构化技能货架**：利用 `init-library` 和 `add` 命令，将分散的技能按\"frontend\"、\"workflow\"等分类整理到统一的受管库中，来源清晰可查。\n- **自带决策注释**：每个入库技能都保留了策展人编写的笔记，明确记录“为什么选它”及适用场景，让 Agent 能更精准地匹配任务。\n- **智能依赖安装**：通过 `requires` 机制自动解析并安装所需依赖，支持离线快速加载本地副本，大幅降低环境配置门槛。\n- **一键同步更新**：使用 `sync` 命令即可批量检查并拉取上游最新变更，确保团队始终使用经过验证的最新稳定版技能。\n\nAi-Agent-Skills 将原本杂乱无章的技能收集工作转变为标准化的资产管理流程，让 AI Agent 真正拥有了一支训练有素、随时待命的“特种部队”。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMoizIbnYousaf_Ai-Agent-Skills_265f9117.png","MoizIbnYousaf","Moiz Ibn Yousaf","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FMoizIbnYousaf_f79e6455.png","وَأَن لَّيْسَ لِلْإِنسَـٰنِ إِلَّا مَا سَعَىٰ ","Halaali ",null,"https:\u002F\u002Fwww.moizibnyousaf.com\u002F","https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf",[84,88],{"name":85,"color":86,"percentage":87},"JavaScript","#f1e05a",93.9,{"name":89,"color":90,"percentage":91},"HTML","#e34c26",6.1,989,111,"2026-04-04T20:55:50","MIT","Linux, macOS, Windows","未说明",{"notes":99,"python":100,"dependencies":101},"该工具是一个基于 Node.js 的 CLI 库管理工具，而非深度学习模型。运行核心需求是安装 Node.js 和 npm。它通过 'npx ai-agent-skills' 命令运行，用于管理和安装 AI Agent 的技能脚本（Skills），默认安装路径为全局 ~\u002F.claude\u002Fskills\u002F 或项目级 .agents\u002Fskills\u002F。无需 GPU 或特定 Python 版本，因为它主要作为包管理器工作，具体的技能脚本可能依赖其他环境，但工具本身仅需 Node.js 运行时。","未说明 (需支持 npx\u002FNode.js 环境)",[102,103],"node","npm\u002Fnpx",[45,15],[106,107,108,109,110,111,112],"agent-skills","claude-code","cli","codex","cursor","developer-tools","productivity","2026-03-27T02:49:30.150509","2026-04-06T08:46:50.793368",[116,121,126,131,136,141],{"id":117,"question_zh":118,"answer_zh":119,"source_url":120},16670,"Opencode Agent 的技能安装路径不正确，应该安装到哪里？","Opencode 最近更改了配置位置。全局技能的正确安装路径应为 `~\u002F.config\u002Fopencode\u002Fskill\u002F\u003Cname>\u002FSKILL.md`，而不是旧的 `~\u002F.opencode\u002Fskills\u002F`。项目级配置路径为 `.opencode\u002Fskill\u002F\u003Cname>\u002FSKILL.md`。如果遇到问题，请确保使用最新版本的工具，它已修复为指向新的配置目录。","https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills\u002Fissues\u002F2",{"id":122,"question_zh":123,"answer_zh":124,"source_url":125},16671,"为什么从外部 GitHub 仓库安装的技能在运行更新命令时会失败？","这是一个已知问题，现已修复。修复方案是在技能目录中添加了 `.skill-meta.json` 文件来追踪技能的来源（GitHub、本地或注册表）。更新命令现在会读取该元数据并从原始来源拉取更新：GitHub 技能会重新克隆，本地技能会重新复制。对于没有该元数据的旧版技能，仍会尝试从注册表更新。请确保更新到最新版本以获取此修复。","https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills\u002Fissues\u002F3",{"id":127,"question_zh":128,"answer_zh":129,"source_url":130},16672,"如何从 Git 仓库的特定子目录安装单个技能，而不是整个仓库？","目前直接提供包含子目录路径的 Git URL（例如 `...\u002Ftree\u002Fmain\u002Fsubdir`）进行安装会导致“仓库未找到”错误，因为克隆命令无法识别这种格式。当前变通方法是先手动克隆整个仓库，然后从本地路径安装特定的技能目录，或者等待工具后续支持针对子目录路径的安装功能。","https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills\u002Fissues\u002F15",{"id":132,"question_zh":133,"answer_zh":134,"source_url":135},16673,"CREATE INDEX CONCURRENTLY 命令在执行时报错，提示不能在事务块中运行，如何解决？","这是 PostgreSQL 的限制行为而非工具 Bug。根据 PostgreSQL 文档，普通的 CREATE INDEX 可以在事务块中执行，但 CREATE INDEX CONCURRENTLY 严禁在事务块中运行。如果在技能执行中遇到此错误，需要检查生成的 SQL 逻辑，确保该命令是在自动提交模式下单独执行，或者调整技能逻辑以避免将其包裹在事务中。","https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills\u002Fissues\u002F7",{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},16674,"如何提升我的技能在 Dispatch 等发现工具中的可见性？","如果您的技能缺少描述，像 Dispatch 这样的运行时工具将难以有效推荐它。建议在技能的元数据文件或仓库 README 中添加简短的 1-2 句描述，明确说明该技能的功能和适用场景。这将显著改善技能在各种插件推荐系统中的曝光率。","https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills\u002Fissues\u002F18",{"id":142,"question_zh":143,"answer_zh":144,"source_url":145},16675,"是否有计划集成更大的技能搜索源（如 agentskill.sh）？","社区提议集成拥有 40,000+ 技能的 agentskill.sh 作为搜索源，以解决当前仅约 40 个精选技能规模过小的问题。提议包括添加 `--source` 标志或在搜索命令中集成其 API。虽然该功能尚未默认实现，但用户可以通过直接调用其 API (`curl \"https:\u002F\u002Fagentskill.sh\u002Fapi\u002Fskills\u002Fsearch?q=seo&platform=cursor\"`) 或安装其 `\u002Flearn` 技能来获取更广泛的技能发现和安全性扫描服务。","https:\u002F\u002Fgithub.com\u002FMoizIbnYousaf\u002FAi-Agent-Skills\u002Fissues\u002F12",[147,152,157,162],{"id":148,"version":149,"summary_zh":150,"released_at":151},98950,"v4.0.0","# ai-agent-skills 4.0.0\n\n`ai-agent-skills 4.0.0` 将该项目从一个精选的库转变为一个库管理器。\n\n内置库仍然存在，并且依然是默认体验。不同之处在于，现在可以使用同一个包来构建和管理您自己的库。\n\n## 亮点\n\n- 使用 `init-library` 管理工作区\n- `add \u003Csource>` 用于将内置精选、上游仓库技能或自定义副本引入到您的库中\n- 主要的刷新命令为 `sync [name]`，`update` 作为其别名保留\n- 具有依赖感知的安装功能，支持 `requires` 和 `--no-deps`\n- 在 CLI 和 TUI 中均可查看已安装状态\n- 终端 UI 中新增了“已安装”视图和工作区引导\n- 提供针对新库构建流程的作者指南\n\n## 命令与界面变化\n\n- 新增：`init-library \u003Cname>`\n- 新增：`add \u003Csource>`\n- 新增：`build-docs`\n- 主要命令：`sync [name]`\n- 兼容性别名：`update [name]`\n- 新增安装选项：`--no-deps`\n- 新增目录字段：`requires: string[]`\n- 新增工作区标记文件：`.ai-agent-skills\u002Fconfig.json`\n\n## 内部改动\n\n- CLI 和 TUI 现在会根据当前目录解析活动库。\n- 在非工作区环境下，内置模式仍为默认。\n- 在受管库根目录内，工作区模式成为事实上的权威来源。\n- 目录安装可以按确定性顺序展开依赖项。\n- 已安装状态索引在列表、搜索、信息、集合以及 TUI 中共享。\n\n## 升级说明\n\n- `update` 仍然可用，但文档和帮助输出中，`sync` 已成为主要命令。\n- 现在 npm tarball 只从 `docs\u002F` 发布工作流文档。\n- 现有的内置库工作流保持不变。\n\n## 快速流程\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 add anthropics\u002Fskills --skill webapp-testing --area workflow --branch Testing --why \"I use this when I want browser-level checks in the workspace.\"\nnpx ai-agent-skills install frontend-design -p\nnpx ai-agent-skills sync frontend-design -p\nnpx ai-agent-skills build-docs\n```","2026-03-27T16:31:39",{"id":153,"version":154,"summary_zh":155,"released_at":156},98951,"v3.0.0","两种作用域。任意来源。同一 curated 库。\n\nv3 简化了安装模式，并新增了基于源代码仓库的安装方式。\n\n**作用域模型**\n- 默认安装到 `~\u002F.claude\u002Fskills\u002F`（全局作用域，所有地方均可使用）\n- `-p` 参数会将技能安装到 `.agents\u002Fskills\u002F` 目录下（项目作用域，随仓库提交，可供多个代理读取）\n- 旧版 `--agent` 标志仍适用于所有现有路径\n\n**从任意来源安装**\n- `npx ai-agent-skills install anthropics\u002Fskills` 可从任意 GitHub 仓库拉取技能\n- `npx ai-agent-skills install anthropics\u002Fskills@frontend-design` 可指定安装某个特定技能\n- 使用 `--skill` 标志可进行选择性安装，`--list` 则可在安装前预览\n- `--yes` 适用于 CI\u002FCD 和代理驱动的自动化安装\n- 每次安装都会写入包含来源信息的 `.skill-meta.json` 文件\n\n**新增命令**\n- `init [name]` 会生成带有 frontmatter 和章节占位符的新 SKILL.md 模板\n- `check` 可扫描已安装的技能，检测上游是否有变更，而无需重新安装\n\n**源解析**\n- 支持 GitHub 简写、完整 URL、tree\u002Fref\u002Fsubpath、@skill 语法、本地路径以及 Git URL\n- 对子路径进行安全处理，防止路径遍历攻击\n\n**目录改进**\n- 在验证脚本中增加描述质量警告\n- 增强对丰富型技能的检测能力（如包含 scripts\u002F 目录或 references\u002F 的技能）\n- 为所有 wshobson 技能提供单独的 whyHere 理由说明\n\n**70 个测试通过**（相比 v2 的 45 个有所提升）","2026-03-18T13:47:58",{"id":158,"version":159,"summary_zh":160,"released_at":161},98952,"v2.0.1","清理与修复。\n\n- 移除了旧的 `skills` 二进制别名（现在仅保留 `ai-agent-skills`）\n- 优化了目录元数据，移除了过时字段\n- 修复了 CI 的验证工作流\n- 更新了 GitHub Actions 的运行时环境","2026-03-18T10:58:57",{"id":163,"version":164,"summary_zh":165,"released_at":166},98953,"v2.0.0","精选技能库发布。\n\n- 涵盖8个工作领域，共48个技能，每个技能均附有来源元数据和精选理由\n- 终端浏览器，用于浏览和安装技能（`npx ai-agent-skills browse`）\n- 来源层：每个技能都标注了信任等级、同步模式、来源归属，并附有明确的收录理由\n- 工作领域分类：前端、后端、文档、测试、工作流、设计、业务、研究\n- 精选合集作为入口点（我的推荐、构建应用）\n- 支持11款智能体：Claude Code、Cursor、Copilot、Codex、Gemini CLI、Amp、Kilo Code、OpenCode、VS Code、Windsurf、Project\n- 双重安装路径：根据来源检测结果，可选择依赖副本或通过skills.sh获取上游版本\n- 40余项测试，覆盖目录完整性、CLI行为、安全性以及TUI视口处理等多方面","2026-03-18T10:58:50"]