voltagent-best-practices：把 VoltAgent 架构约定写进 Agent Skill
voltagent-best-practices 是 VoltAgent 官方维护的架构速查 Skill，覆盖 Agent 与 Workflow 的取舍、src 目录约定、内存默认值、Hono/Elysia/serverless 服务器以及 VoltOps 观测接入。本文依据官方 SKILL.md、VoltAgent 文档与 VoltAgent/skills 仓库交叉核实安装启用方式、代码片段与注意事项，并说明它和 create-voltagent 脚手架 Skill 的分工。
阅读全文create-voltagent：用官方 Skill 按 VoltAgent 规范初始化 AI Agent 项目
create-voltagent 是 VoltAgent 官方维护的 Agent Skill，指导用 create-voltagent-app CLI 或完整手动步骤创建 TypeScript AI Agent 项目。本文依据官方 SKILL.md、Quick Start 与 VoltAgent/skills 仓库交叉核实：安装启用方式、Hono/Elysia 与六家模型提供商、目录与环境变量约定、天气 Tool 与报销审批 Workflow 示例，以及它和通用「搭项目」Skill 的差别。
阅读全文用官方 template-skill 写出你的第一个 Agent Skill
template-skill 是 Anthropic 官方仓库 anthropics/skills 里的 Skill 起始骨架，目录中只有一份带 name、description 占位的 SKILL.md。Agent Skills 已于 2025 年 12 月成为开放标准，同一文件可在 Cursor、Claude Code、Codex CLI 中按各自扫描目录启用。本文按官方模板与 agentskills.io 规范，说明 frontmatter 字段、目录结构、各工具安装路径，以及如何把模板填成可触发的第一个 Skill。
阅读全文find-bugs：让 AI 按清单扫描当前分支的 Bug 与安全问题
find-bugs 是 Sentry 工程团队在 getsentry/skills 仓库中公开的 Agent Skill，用于审查本地分支相对默认分支的改动。它按五阶段执行：用 git 与 GitHub CLI 取完整 diff、映射攻击面、逐项过 Injection/XSS/鉴权/IDOR 等 11 项安全清单、核实假阳性，再输出带证据的报告，且明确不改代码。可通过 Claude 插件市场或 npx skills add 安装，适用于 Cursor、Claude Code、Codex 等支持 SKILL.md 的工具。
阅读全文使用 modern-python Skill 为 Python 项目配置 uv、ruff 与 ty
Trail of Bits 把内部 cookiecutter-python 模板写成 Agent Skill modern-python，用 uv、ruff、ty、pytest、prek 替代 pip、flake8、black、mypy 和 pre-commit。本文依据官方 SKILL.md 与文档站核实安装方式、最小项目、PEP 723 脚本以及从 requirements.txt / setup.py 迁移的步骤，并说明 Python 3.11+ 与 ty 仍处 beta 等限制。
阅读全文shadcn Skill：让 AI 按项目配置搜索、安装和组合 shadcn/ui 组件
shadcn 是 shadcn/ui 官方 Agent Skill。安装后会读取项目的 components.json，通过 shadcn info --json 注入框架、别名、已装组件、图标库和底层原语，再按官方组合规则搜索、安装、调试和拼接 UI。它随 2026 年 3 月 CLI v4 发布，可用 pnpm dlx skills add shadcn/ui 装进 Cursor、Claude Code、Codex 等工具，避免助手凭记忆写出对不上项目的组件。
阅读全文firecrawl-cli：让 AI Agent 用 CLI 抓取、搜索、爬取与映射网页
firecrawl-cli 是 Firecrawl 官方 Agent Skill（目录 skills/firecrawl-cli，frontmatter 名为 firecrawl）。它让 Cursor、Claude Code、Codex 等助手用 firecrawl CLI 搜索、抓取、映射、爬取和交互网页，结果以 Markdown/JSON 写入 .firecrawl/。本文依据官方 SKILL.md 与 CLI 文档，说明安装鉴权、search→scrape→map→crawl→interact 路径，以及 credits 与无 Key 限流等注意点。
阅读全文improve-codebase-architecture：让 AI 先做架构审查，再决定改哪里
Matt Pocock 的 improve-codebase-architecture 是一条用户主动唤起的 Agent Skill：按近期提交热点扫描浅模块与泄漏的缝，用删除测试过滤候选，把加深机会写成不进仓库的 HTML 报告（Tailwind + Mermaid），再对你选中的一项做 grilling。它不改业务代码，产出是可测试、可导航的架构决策，随后才进入 to-spec / to-tickets / implement。适合定期治理技术债和大改前的结构体检，而不是自动重构。
阅读全文使用 Matt Pocock 的 tdd Skill 做垂直切片测试驱动开发
Matt Pocock 的 tdd Skill 约束编程 Agent 按垂直切片做 TDD：先约定公开 seam，再一次只写一个失败测试、一段刚好能通过的实现。文章根据 GitHub SKILL.md、tests.md、mocking.md 和 aihero.dev 说明，整理好测试标准、三种反模式、mock 边界、Cursor / Claude Code / Codex 安装方式，以及重构已拆到 code-review、不宜用于胶水代码等限制。
阅读全文grill-me：动手写代码前，先让 Agent 把你问清楚
grill-me 是 Matt Pocock 技能集里的用户触发入口：在 Agent 动手前，按决策树一轮一轮追问，把还没成形的想法磨到可以承诺。它无状态、不写文件，主题也不必是代码。真正的面试循环在同仓库的 grilling 里，只装 grill-me 往往跑不起来。本文依据官方 SKILL.md 与 aihero.dev 说明，整理安装方式、提问格式、和 grill-with-docs / wayfinder 的分工，以及被动点头、范围过大、Skill 未加载等常见坑。
阅读全文adding-analytics：让 AI Agent 按标准流程给 Web 应用接入 PostHog
adding-analytics 是 awesome-cursor-skills 里的一份 SKILL.md，把给 Web 应用接入 PostHog 收成固定流程：识别框架、安装 posthog-js / posthog-node、初始化 Provider、为 SPA 补页面浏览、用环境变量管理密钥，再按需加自定义事件、Feature Flag 和会话回放。本文依据 Skill 原文与 PostHog、Cursor、Claude Code、Codex 官方文档交叉核实，说明安装目录、可复现示例，以及变量名、React 包路径、pageview 默认行为和输入脱敏等与现行文档的差异。
阅读全文用 database-design：让 AI Agent 按规范设计表关系、索引、约束与 ORM
database-design 是 awesome-cursor-skills 收录的数据库建模 Skill，把实体识别、表关系、约束、索引和 Prisma/Drizzle 配置写成一份 SKILL.md。本文按官方原文核实其六步工作流、PostgreSQL 示例与安装方式，说明它如何补上 AI 编程在 schema 设计上的短板，以及 Postgres 方言、ORM 范围等使用限制。
阅读全文adding-stripe：让 AI Agent 按标准流程接入 Stripe 支付
adding-stripe 是 awesome-cursor-skills 中的社区 Agent Skill，把 Stripe Checkout、订阅 Webhook 与客户门户写成 7 步清单。本文依据 SKILL.md 原文，并对照 Stripe Checkout、Webhook、Billing Portal 与 Cursor Skills 文档，说明它解决什么问题、如何在 Cursor / Claude Code / Codex 中安装，以及验签、Customer ID、API 版本等使用注意。
阅读全文用 recording-browser-flow-as-test：在浏览器里走一遍流程，自动生成 Playwright 测试
介绍 spencerpauly/awesome-cursor-skills 中的 recording-browser-flow-as-test：在 Cursor 内置浏览器逐步走查用户流程，用 browser_snapshot 记录无障碍树信息，再生成基于 getByRole/getByLabel 等稳定定位的 Playwright 测试。文中核实安装命令、前置条件、录制步骤、断言与加固建议，以及 2FA/验证码等不适用场景。
阅读全文accessibility-auditing：用 Cursor 浏览器 ARIA 树做无障碍审计
介绍 spencerpauly/awesome-cursor-skills 中的 accessibility-auditing：依托 Cursor 内置浏览器的 browser_navigate、browser_snapshot 与 browser_press，对页面 ARIA 树做缺失标签、语义 HTML、键盘顺序、ARIA 误用与对比度检查，输出 Critical/Warnings/Passed 报告并直接改源码。文中说明安装到 .cursor/skills 或用 npx skills add 的方式，以及适用场景与合规复核注意点。
阅读全文用 visual-qa-testing 在 Cursor 里做视觉 QA：截图、控制台与网络请求一次过
visual-qa-testing 是社区仓库 awesome-cursor-skills 中的 Agent Skill，指导 Cursor Agent 借助内置浏览器（cursor-ide-browser）在改完 UI 后做视觉 QA：确认开发服务、打开页面截图、检查控制台错误与网络请求，并可对按钮表单做交互后再验。本文依据 SKILL.md 与 Cursor 官方 Skills/Browser 文档，说明其定位、安装目录与 npx skills 安装方式、典型调用步骤，以及依赖内置浏览器、非测试框架替代品等注意事项。
阅读全文用 grinding-until-pass：让 Agent 自己修到测试全绿
介绍 spencerpauly/awesome-cursor-skills 中的 grinding-until-pass：通过 fix→run→check 循环，让 Agent 自主修到测试、构建或 lint 通过。文中核实官方 SKILL.md 的步骤与十条以内迭代、一次修一事、禁止删测与压制错误等规则，并说明用 npx skills 或拷贝到 .cursor/skills 的安装方式，以及目标命令示例与 Cursor Hooks 进阶用法。适合大重构、依赖升级、合分支后清红灯的场景；慢测试与需改设计时需人工介入。
阅读全文用 best-of-n-solving：隔离 Worktree 并行试多种方案，再择优合并
介绍 spencerpauly/awesome-cursor-skills 中的 best-of-n-solving：面对复杂重构、棘手 bug 或架构选型时，先定 2～3 条策略，再用 Cursor 的 best-of-n-runner 在隔离 git worktree 中并行尝试，按测试、实现质量、性能与可维护性择优合并。文中核实官方 SKILL.md 的四步流程、npx skills / 手动安装到 .cursor/skills 的方式，以及适用场景与「简单问题不必上 Best-of-N」等注意事项。
阅读全文用 expo-native-ui 让 AI 写出更像原生 App 的 Expo 界面
介绍 Expo 官方 Agent Skill expo-native-ui（v1.1.1）：它教 AI 按 Apple HIG、语义色、原生控件、Reanimated 与 Expo Go 优先等约定，搭建观感接近系统的 Expo 屏幕。文中核实了 Cursor / Claude Code / Codex 的安装方式、Color API 与动画示例，并说明导航应配合 expo-router、与 expo-ui 的分工差异。
阅读全文remotion-best-practices：让 AI 按规范写出 Remotion 程序化视频
介绍 Remotion 官方 Agent Skill remotion-best-practices：它作为总入口，把创建项目、Markup、地图、字幕、Studio、渲染、升级等子技能路由给 Cursor、Claude Code、Codex 等代理。文章基于官方 SKILL.md 与文档，说明安装命令、帧驱动动画规范（useCurrentFrame + interpolate）、媒体与资源约定，以及预览/抽帧用法，帮助用 AI 写程序化视频时少踩渲染坑。
阅读全文用 supabase-postgres-best-practices 给 AI 编程助手补上 Postgres 功课
介绍 Supabase 维护的 Agent Skill「supabase-postgres-best-practices」：面向 Cursor、Claude Code 等工具，按查询性能、连接管理、RLS、schema 等八类优先级规则，约束 AI 写 SQL、改表与排查性能。文中核实官方安装命令、规则结构与典型正误示例，并说明其与 Supabase MCP 的配合方式。
阅读全文agents-sdk Skill：在 Cloudflare 上构建有状态 AI Agent
介绍 Cloudflare 官方 agents-sdk Skill：引导 AI 助手优先检索 Agents 文档，在 Workers / Durable Objects 上正确编写有状态 Agent，覆盖 setState、@callable RPC、调度、Workflows、MCP 与 React hooks。文中给出安装方式、agents 依赖核对、wrangler 配置与 Counter 示例，并标明装饰器、migration 与实验特性等注意事项。
阅读全文用 web-perf Skill 做前端性能审计：把 Core Web Vitals 塞进 Agent 工作流
介绍 Cloudflare 官方 Agent Skill「web-perf」：借助 Chrome DevTools MCP 审计 Core Web Vitals（LCP、INP、CLS）及 FCP、TBT、Speed Index，排查渲染阻塞、网络依赖链、布局偏移与缓存问题。文章说明其定位、五阶段工作流、在 Cursor / Claude Code / Codex 等工具中的安装方式、MCP 必配项，以及典型提示词与输出格式，并提醒以现行文档核验阈值、无 MCP 时勿硬编结论。
阅读全文Wrangler Skill：让 AI 助手正确部署 Cloudflare Workers
介绍 Cloudflare 官方 Agent Skill「wrangler」：它指导 AI 编程助手在部署与管理 Workers、KV、R2、D1 等资源前优先检索官方文档与配置 schema，避免过时命令与错误绑定。文章覆盖 Skill 定位、核心能力、在 Cursor/Claude Code/Codex 等工具中的安装启用、典型 wrangler.jsonc 与常用命令示例，以及密钥安全与本地 remote binding 等注意事项。
阅读全文用 deploy-to-vercel 把 AI 写好的项目一键预览上线
介绍 Vercel Labs 官方 Agent Skill「deploy-to-vercel」：如何在 Cursor / Claude Code / Codex 等工具中安装，如何按 git remote、.vercel 关联与 CLI 登录状态自动选择 git push、vercel deploy 或无鉴权沙箱脚本，默认产出 Preview URL，并尽量把项目推进到可长期自动部署的 link 状态。文中命令与分支逻辑均对照官方 SKILL.md（v3.0.0）与 skills.sh 安装说明核实。
阅读全文