vercel-react-best-practices
Vercel 官方维护的 React 和 Next.js 性能优化指南,包含 8 大类别下按优先级排序的 70 条规则,覆盖瀑布流消除、包体积优化、服务端性能、数据获取、重渲染优化等场景,用于自动化重构和代码生成。
适合编写或重构 React 组件、Next.js 页面时的性能优化
AGENT SKILLS DIRECTORY
从公开榜单和 GitHub 原文里挑出来的 Agent 技能:先看用途,再看热度,装上就用。
按近期安装变化与社区热度滚动生成。
joeseesun/qiaomu-anything-to-notebooklm 公开仓库中的 Skill,原文路径 SKILL.md。
GitHub Stars 5,721#1qiaomu-mondo-poster-design乔木视觉与网页joeseesun/qiaomu-mondo-poster-design 公开仓库中的 Skill,原文路径 SKILL.md。
GitHub Stars 1,061#1qiaomu-opencli-autofix乔木开发与部署joeseesun/qiaomu-opencli-skills 公开仓库中的 Skill,原文路径 qiaomu-opencli-autofix/SKILL.md。
GitHub Stars 978#2qiaomu-opencli-browser乔木开发与部署joeseesun/qiaomu-opencli-skills 公开仓库中的 Skill,原文路径 qiaomu-opencli-browser/SKILL.md。
GitHub Stars 978#1find-skillsAgent 工作流近 3 周公开安装量合计 343,502,热度仍在滚动。
近 3 周安装 343,502#3sleek-design-mobile-apps设计与 UI近 3 周公开安装量合计 111,951,热度仍在滚动。
近 3 周安装 111,951#1frontend-design设计与 UI近 3 周公开安装量合计 88,964,热度仍在滚动。
近 3 周安装 88,964#5design-taste-frontend设计与 UI近 3 周公开安装量合计 74,353,热度仍在滚动。
近 3 周安装 74,353#2agent-browserAgent 工作流近 3 周公开安装量合计 66,579,热度仍在滚动。
近 3 周安装 66,579#6high-end-visual-design设计与 UI近 3 周公开安装量合计 55,740,热度仍在滚动。
近 3 周安装 55,740#1vercel-react-best-practices前端与 React近 3 周公开安装量合计 52,304,热度仍在滚动。
近 3 周安装 52,304#2web-design-guidelines设计与 UI近 3 周公开安装量合计 50,806,热度仍在滚动。
近 3 周安装 50,806把同一类任务会连续用到的 Skill 放在一起。
从 React 性能、组件组合、设计系统到浏览器测试,适合把前端界面做成可上线、可维护的产品。
6 个 Skill · vercel-react-best-practices / vercel-composition-patterns / frontend-design设计审查UI 设计打磨覆盖视觉方向、移动端体验、审美判断和高端视觉细节,适合在页面不够精致时集中调度。
6 个 Skill · frontend-design / web-design-guidelines / sleek-design-mobile-apps发布门禁上线前验证把完成前检查、Playwright 自动化和最佳实践组合起来,用于发布前发现真实交互和回归问题。
5 个 Skill · verification-before-completion / playwright-cli / playwright-best-practicesAI WebNext.js AI 产品上线覆盖 Next.js 架构、AI SDK、缓存、单仓库构建和 Vercel 部署,适合把 AI Web 产品从原型推到线上。
6 个 Skill · ai-sdk / next-best-practices / next-cache-components移动端移动 App MVP从 React Native、Expo 原生界面、移动数据获取到升级与样式配置,适合快速做可试用的移动端产品。
6 个 Skill · vercel-react-native-skills / building-native-ui / native-data-fetching后端地基后端与数据库地基覆盖 API 设计、后端模式、Postgres、Supabase、Neon 和 PlanetScale,适合先把数据层和服务边界定稳。
6 个 Skill · api-design / backend-patterns / supabase-postgres-best-practices实时协作认证与实时应用 MVP把 Firebase、Convex、Supabase 的认证和实时数据能力放在一起,适合聊天、协作、看板和轻量 SaaS 原型。
6 个 Skill · firebase-basics / firebase-auth-basics / convex-quickstart造 SkillAgent Skill 制作流水线从发现 Skill、创建 Skill、拆计划到执行与并行调度,适合把一次性经验沉淀成可复用 Agent 能力。
6 个 Skill · find-skills / skill-creator / writing-plans修 Bug调试、测试与代码评审把系统化排查、TDD、完成前验证和代码评审串成闭环,适合修复杂 bug、减少回归和交付前自检。
6 个 Skill · systematic-debugging / test-driven-development / requesting-code-review自然增长SEO 与内容增长从 SEO 审计、AI 搜索、批量 SEO 页面到内容策略和社媒分发,适合给产品建立长期自然流量。
6 个 Skill · seo-audit / ai-seo / programmatic-seo转化落地页转化覆盖文案、营销心理、广告创意、冷邮件和流失挽回,适合把页面访问变成注册、咨询或购买。
6 个 Skill · copywriting / marketing-psychology / ad-creative个人效率个人知识与任务系统把笔记、提醒、Notion、Google Workspace 和内容监控放在一起,适合管理资料、待办和日常信息流。
6 个 Skill · apple-notes / apple-reminders / bear-notes资料整理文档研究工作台覆盖摘要、PDF 编辑、邮件处理、差异审阅和飞书文档,适合把散乱材料整理成可交付研究结果。
6 个 Skill · summarize / nano-pdf / himalaya项目推进会议到项目推进把会议纪要、项目规划、Jira、仪表盘、复盘学习和 Teams 会议流水线串起来,适合会后推进和跨团队协作。
6 个 Skill · meeting-notes / project-planner / jira-integration自动化数据采集与自动化运营适合把公开网页、内容平台、Google Workspace 和定时任务接入自动化,减少重复收集和手工搬运。
6 个 Skill · data-scraper-agent / agent-browser / content-engine安全护栏安全、密钥与发布护栏覆盖 1Password、主机健康检查、UI E2E、自动审查、熔断和发布安全,适合上线前降低误操作风险。
6 个 Skill · 1password / healthcheck / control-ui-e2e架构架构决策系统用于 API、Docker、六边形架构、长期 Agent 任务和架构决策记录,适合在项目变复杂前先定边界。
6 个 Skill · architecture-decision-records / hexagonal-architecture / docker-patterns测试矩阵多语言测试套件把端到端、TDD、Python、Go、C#、Django 和 Laravel 测试方法放在一起,适合维护多技术栈项目。
7 个 Skill · e2e-testing / tdd-workflow / python-testing开源维护GitHub 与开源维护覆盖 GitHub CLI、分支流程、PR 维护、开源打包和发布恢复,适合管理仓库、Issue、PR 和发布节奏。
7 个 Skill · github / git-workflow / github-ops策略调研、竞品与决策把市场研究、竞品分析、品牌发现、基准方法和多视角决策放在一起,适合立项、定位和路线选择。
6 个 Skill · competitive-platform-analysis / market-research / brand-discovery338 个结果 · 显示前 48 个
Vercel 官方维护的 React 和 Next.js 性能优化指南,包含 8 大类别下按优先级排序的 70 条规则,覆盖瀑布流消除、包体积优化、服务端性能、数据获取、重渲染优化等场景,用于自动化重构和代码生成。
适合编写或重构 React 组件、Next.js 页面时的性能优化
一套用于构建灵活、可维护 React 组件的组合模式,避免布尔属性泛滥,通过复合组件、提升状态和组合内部结构来构建可扩展的组件 API,并包含 React 19 API 变更。
适合重构具有许多布尔属性的组件
这是一个 shadcn/ui 官方技能,用于在项目中使用和定制 shadcn 组件与设计系统。它通过 CLI(按项目包管理器使用 npx shadcn@latest、pnpm dlx shadcn@latest 或 bunx --bun shadcn@latest)完成组件的添加、搜索、修复、调试与样式调整,并支持组合 UI,包括聊天界面。技能会自动注入项目上下文(npx shadcn@latest info --json),包含别名、是否 RSC、Tailwind 版本与 CSS 文件、style、base(radix 或 base)、图标库、路径、框架、包管理器和 preset 等字段,并用 npx shadcn@latest docs 获取组件文档与示例 URL。文档列出了必须遵守的关键规则(样式与 Tailwind、表单与输入、组件结构、用组件而非自定义标记、图标、聊天与消息、CLI 预设),并提供典型代码模式与组件选型表。它还覆盖从 DESIGN.md 构建设计系统、用 --dry-run 与 --diff 智能更新组件、preset 切换(覆盖/部分/合并/跳过)以及注册表搜索与第三方注册表导入路径修正等流程。触发场景包括使用 shadcn/ui、组件注册表、presets、--preset 代码,或任何含 components.json 的项目。该技能标记为 user-invocable: false。
适合在含 components.json 的 shadcn/ui 项目中添加、搜索、调试或修改组件
该技能提供使用 Playwright 测试本地 Web 应用的指南,包括单元、集成和端到端测试模式。它包含辅助脚本(如 with_server.py)用于管理服务器生命周期,并指导用户采用先侦察后行动的模式:先等待网络空闲,检查渲染后的 DOM,再选择选择器执行操作。强调将脚本作为黑盒调用,避免污染上下文窗口。
适合测试本地 React 或前端 Web 应用
用于用 Tailwind 实现设计系统,覆盖 design token、组件变体与组件模式,方便统一页面视觉规范和复用结构。
适合搭建 Tailwind 设计系统时。
typescript-advanced-types 是 wshobson/agents 仓库中的一个技能,技能描述为涵盖可辨识联合、条件类型、模板字面量和实用类型模式。它可通过 npx skills 安装器单独安装,也可作为该仓库多工具插件与技能体系的一部分使用;仓库支持 Claude Code、Codex CLI、Cursor、OpenCode、Antigravity CLI、GitHub Copilot 和 Pi 等工具。
适合为 TypeScript 数据结构设计可辨识联合类型
Vercel 官方出品的部署技能(作者 vercel,版本 4.0.0),用于将应用和网站部署到 Vercel。技能要求先执行四项状态检查:git remote、.vercel/ 链接文件、vercel whoami 登录状态、可用团队列表;再根据“是否已链接、是否有 git remote、CLI 是否已认证”选择路径:git push 触发部署、vercel deploy、先 link 再部署,或在无凭据环境下改用 vercel deploy --temporary 临时部署。技能默认一律部署 preview,只有用户明确要求才上 production;命令通过 --scope 指定团队,用 --no-wait 加 vercel inspect 查询构建状态,并给出 claude.ai 网络白名单与沙箱提权等排障指引。
适合用户说“deploy my app”“push this live”或要求创建 preview deployment 时,需要按状态选择部署方式
Turborepo 官方技能,用于配置和排查 Turborepo 仓库,覆盖 turbo.json、任务管道、缓存、Remote Cache、turbo CLI、过滤、环境变量、包边界、monorepo 结构与 CI 工作流。技能本身不承载框架指导:完整的 Turborepo 文档随已安装的 turbo 包一起分发,技能要求先读取与当前安装版本完全对应的内置文档,入口为 node_modules/turbo/docs/README.md,再根据其中的任务索引选择最小的相关文档页面,并在修改 Turborepo 配置、包脚本或 CI 工作流之前先阅读该页面。若包管理器使用非扁平 node_modules 布局或 workspace link,需先用 node -p "require.resolve('turbo/package.json')" 解析包位置,再读取其下的 docs/README.md。若未安装 turbo,应先检查仓库的包管理器与既有版本约束,再决定是否安装;安装后使用内置文档而非其他版本的指导。
适合编写或调整 turbo.json 中的任务管道与依赖关系
面向 Next.js 接入 Vercel AI SDK,覆盖 generateText、streamText、工具调用和 useChat。
适合适合给 Next.js 接入 AI 能力。
原文有效说明不足;仅能确认它指向 Next.js 规范、RSC 边界、数据模式和异步 API 约定。
适合适合查 Next.js 规范与约定。
原文有效说明不足;仅能确认它围绕 Next.js 缓存组件,涉及 PPR、use cache 和缓存标签。
适合适合查 Next.js 缓存与失效。
为构建具有独特视觉设计的 UI 提供指导,涵盖美学方向、排版和避免模板化默认选择。
适合构建新 UI 时追求独特视觉风格
该技能通过从指定 URL 获取最新的 Web Interface Guidelines,读取用户指定的文件或模式,并对照所有规则进行审查,最终以简洁的 file:line 格式输出发现的问题。
适合审查 UI 代码与设计规范的一致性
面向 iOS 与 Android 的移动端界面设计指引,帮助规划屏幕、布局和移动优先的视觉表达。
适合适合移动 App 界面设计。
这是一个面向 Web、移动端和桌面端界面的 UI/UX 设计智能技能,核心是一个本地可搜索的设计知识库,包含 80 种样式(51 种活跃)、192 套产品配色与推理档案、74 组字体搭配、120 条 UX 规范、105 个精选图标、17 个 GSAP 预设、25 种图表类型和 22 个技术栈指南。它通过 Python 检索脚本查询(--design-system 聚合生成完整设计系统,--domain 查询单个关注点,--stack 查询特定框架实现细节),并可按优先级 1→10 处理可访问性、触摸交互、性能、样式、响应式布局、排版配色、动效、表单反馈、导航与图表。支持用 --persist 把设计系统写入 MASTER.md 与页面级覆盖文件,用 --variance/--motion/--density 三个滑杆调节输出版式,用 --rtl 处理从右到左界面。技能自身声明不安装软件包、不改动操作系统,搜索结果只作建议。
适合为新项目或新页面生成统一的设计系统(产品类型、风格、配色、字体、效果与反模式)
Taste Skill(tasteskill 2.5.1)是一个面向编码 Agent 的前端设计技能,目标是让 Agent 从一份简要需求出发搭建 figma.com、x.ai 级别的公司官网,而不是拼出通用落地页。工作流先把客户业务归类为 software、gaming、tech、product、service、place 六类,再逐屏规划,然后才开始写标记:scripts/start.mjs 按行业发牌一套配色与 Google Fonts 字体搭配,assets/layout/deal.mjs 从 11 种 hero 版式中发牌一种;assets/starter.html 与 system.css、layout.css 强制桌面 1440x900 下一屏一节、左右内容边对齐、固定导航与单屏收尾页脚。内容层面要求真实产品 UI 片段、真实品牌 SVG 图标,以及来自受审照片库(含本地打包的 Wikimedia Commons 图与 Unsplash 图)的实拍照片,来源统一收在一行可展开页脚中;着色器、滚动场景与程序化 3D 只发给 software、tech、gaming 页面,并受四上下文 WebGL 上限约束,手机与减弱动效有静态降级。交付前由 consistency.mjs 等在无头 Chrome 中通过 HTTP 以 1440、1024、820、768、390 等宽度渲染检查,抓空视觉、坏着色器、对比度下降、列错位、占位文案、编造的门牌号与弱网图片缺口,再由 gate.mjs 完成门禁把关(最多三轮)。依赖 Node 22+ 与 Chrome/Edge/Chromium,ffmpeg 可选,不安装任何东西、无需 API Key,采用 MIT 许可。
适合让编码 Agent 从一份简要需求搭建软件、科技或游戏公司的官网首页
面向奢华与编辑风界面提供高端视觉审美参考,帮助把页面做得更克制、更精致。
适合适合高端感与编辑风页面。
从现有代码库中提取设计令牌、组件和模式,并生成项目本地的初始令牌文件。
适合从公开网站逆向提取颜色、字体、间距等设计原语
对界面进行最终视觉打磨:收紧间距、优化字体、清理边缘,在不改变原有设计概念的前提下提升细节质量。
适合正式发布前的视觉细节审查
impeccable 的 critique 命令对指定设计目标(源码文件路径或 URL)执行一次结构化设计评审:先把目标解析为稳定标识,再由两个相互隔离的子代理分别运行 Assessment A(设计评审:设计特异性、整体设计、认知负荷、情绪旅程、Nielsen 十大启发式 0–4 评分)与 Assessment B(内置检测器 CLI 扫描 + 浏览器叠加层证据,桌面应用通过 CDP 端口接入),随后合成一份以聊天回复为主要交付物的报告。报告包含运行溯源头部、Design Health Score 评分表、设计特异性判定、整体印象、做得好的地方、P0–P3 优先问题(每条附带具体修复建议与可映射的后续命令)、用户画像红旗、次要观察、启发式提问和 Run Notes。若因缺少子代理工具等原因降级运行,报告首行必须输出 ⚠️ DEGRADED 横幅;最后把报告快照持久化到 .impeccable/critique/、读取最近 5 次趋势,并以 2–4 个带具体选项的针对性问题收尾。
适合对网页页面或组件进行发布前的结构化设计评审,并获取带修复建议与后续命令的优先问题清单
该技能用于创建基于设计哲学的高质量视觉艺术作品,输出为 .pdf 或 .png 文件。流程分两步:先创建设计哲学(.md),再在画布上通过形式、空间、色彩等视觉语言表达。强调极少文字、视觉优先、大师级工匠精神和避免复制已有艺术家作品。
适合创作海报、艺术设计或其他静态视觉作品
React Native 和 Expo 最佳实践指南,涵盖列表性能、动画、导航、UI 模式、状态管理、渲染、Monorepo 和配置等类别,用于构建高性能移动应用。
适合构建 React Native 或 Expo 应用
这是Expo官方团队提供的AI agent技能,用于构建原生UI组件,包括列表、模态框、标签页、底部弹窗和触觉反馈。作为Expo Skills的一部分,它帮助AI代理掌握Expo API的使用方法,与Expo文档、CLI等共同构成开发参考。
适合使用Expo开发原生移动应用,需要构建列表、模态、标签页等界面组件
面向原生应用的数据获取方案,覆盖离线缓存、后台刷新与同步模式。
适合原生 App 数据获取。
提供 Expo SDK 升级路径,处理破坏性变更、原生模块兼容和迁移步骤。
适合Expo 版本升级迁移。
指导在 Expo 中配置 NativeWind 和 Tailwind,处理原生类名与样式映射。
适合Expo Tailwind 配置。
帮助用户发现并安装代理技能,通过技能市场搜索、验证并安装技能。
适合用户询问如何完成某任务时寻找现成技能
agent-browser 是 Vercel Labs 提供的浏览器自动化 CLI,面向 AI Agent 使用,通过 CDP 驱动 Chrome/Chromium,无需依赖 Playwright 或 Puppeteer;它采用原生 Rust 实现,并使用可访问性树快照和紧凑的 @eN 元素引用进行可靠交互。该 Skill 文件本身只是一个发现入口(stub),要求先运行 `agent-browser skills get core` 加载实际工作流内容,核心指南末尾附带参考表;此外还提供 Electron、Slack、探索性测试/QA、HAR 派生 API 客户端、WebMCP 工具生成、Vercel Sandbox、受保护 Vercel 部署访问、AWS Bedrock AgentCore 云浏览器等专项 Skill。功能覆盖导航页面、填写表单、点击按钮、截图、提取数据、测试 Web 应用以及登录站点等,并支持会话、认证保险库、状态持久化和视频录制。
适合让 Agent 打开网站、导航页面并完成多步网页操作
skill-creator 是一个用于创建、测试、改进和发布新技能的技能。它提供了一套完整的工作流,包括捕获意图、编写 SKILL.md、创建测试用例、运行评估、迭代优化,以及优化技能描述以提高触发准确率。
适合从零创建新技能
这是 obra/superpowers 中的 brainstorming 技能,定位为在任何创造性工作之前(做功能、搭组件、加功能、改行为,或规划演讲、生意、装修等软件之外的事情)先弄清人类伙伴真正想要什么、以及为什么。技能要求:已有项目或已给上下文时先读材料再提问,不重复询问已被回答或已决定的事;第一条消息用约 200 词复述请求的“形状”(要什么、给谁、为什么)并补充发现的相关信息,然后提一个开放式问题,或给出简短设计请求批准。对话阶段提问与 200-300 词的回放交替进行,一次只问一个,用对方语言;理解意图后,先用单独一条消息列出 2-3 个具体方案及其取舍并推荐一个,再评估工作规模(小改动写短设计、项目写完整设计文档)。设计文档需含意图、目标/非目标/反目标、约束、方案、已定的“怎么做”和留给构建者的部分;软件仓库中放在 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md 并提交。项目级设计还要派发子代理按 builder-check-prompt.md 做审阅,把问题分为已答、次要、须由伙伴回答三类。技能设 HARD-GATE:设计文档获批前不得写产品代码、搭脚手架、装依赖或调用实现技能,例外是伙伴已选择跳过提问,或已同意的 spike(保持 throwaway 标记,保留产出需重新过门禁);获批后下一步只调用 superpowers:writing-plans。另含红灯自查表与“视觉伴侣”,后者按需及时提供、单独成条消息,接受后须先读 visual-companion.md 再启动服务器。
适合在开发新功能、新组件或修改现有行为之前,先澄清用户真正想要什么与为什么
来自 obra/superpowers 的 systematic-debugging 技能,主张以假设驱动的调试循环处理任何 bug、测试失败或异常行为。其核心是「铁律」:在完成根因调查前不得提出任何修复(NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST),症状式修复被视为失败。技能规定必须依次完成四个阶段——1 根因调查(细读错误信息、稳定复现、检查近期变更、在组件边界加诊断埋点、沿调用栈回溯数据流)、2 模式分析(找出可用的相似实现、完整对照参考实现、列出全部差异)、3 假设与验证(提出单一假设、做最小改动测试、验证后再继续)、4 实施(先写失败测试、单一修复、验证,若三次以上修复均失败则停下来质疑架构)。文档还列出触发停下的「红旗」思维清单、human partner 的错误信号、常见借口与现实的对照表,以及 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md 三个配套技术文件,并引用同仓库的 test-driven-development 与 verification-before-completion 技能。
适合遇到测试失败、生产 bug、异常行为、性能问题、构建失败或集成问题时,在提出修复之前使用
obra/superpowers 中的 writing-plans 技能,用于在动手写代码之前,为多步骤任务编写结构化的实施计划。计划面向一位没见过该代码库、也没读过规格说明的工程师:假定对方掌握项目语言并会写出符合习惯的代码,凡是其无法自行得知的决策——涉及哪些文件、命名与签名、规格中的哪些取值、由哪些测试证明每个任务——都要在计划中写明。计划以可勾选的小任务形式交付,遵循 DRY、YAGNI、TDD 与频繁提交。内容涵盖:范围检查(若规格横跨多个独立子系统则建议拆分为多份计划);文件结构规划(按职责而非技术分层拆分,每个文件单一职责);任务粒度(任务是最小自带测试周期、值得独立评审的单位);步骤粒度(每个步骤只做一个动作并可检验,如写失败测试、运行确认失败、实现最小代码、运行确认通过、提交);计划文档的固定头部(Goal、Architecture、Tech Stack、Spec 路径、Global Constraints、Review Focus);随后是对照规格的自审清单(规格覆盖、步骤扫描、类型一致性、Review Focus、篇幅比例);最后是执行交接,要求人类先评审计划,并在未指定执行方式时选择子代理驱动或原生执行。计划默认保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md。
适合已有规格说明或需求,需要把它拆成一份可逐任务执行的多步骤实施计划
该 Skill 属于 obra/superpowers 的 Agent 工作流集合,用于在完成任务、实现主要功能或合并到 main 之前发起代码审查。核心原则是“尽早审查、频繁审查”。它要求先通过 git rev-parse 或 git merge-base 取得 BASE_SHA 与 HEAD_SHA,再派发一个 general-purpose 代码审查子代理,并按 code-reviewer.md 模板填充 {DESCRIPTION}、{PLAN_OR_REQUIREMENTS}、{BASE_SHA}、{HEAD_SHA} 四项占位符;子代理只需精确构造的上下文,而非当前会话历史。审查结果按 Critical、Important、Minor 分级处理:Critical 立即修复,Important 在继续前修复,Minor 记录待办,若审查者有误可基于技术理由反驳。文档还列出常见借口与红线(如不得因“很简单”跳过审查、不得忽略 Critical 问题)。
适合在子代理驱动开发中,每完成一个任务后发起审查
一套强制纪律的测试驱动开发(TDD)工作流技能:先写一个最小失败测试(RED),必须亲眼看到它以预期原因失败,再写刚好通过测试的最简代码(GREEN),并运行整个项目测试套件确认全绿,最后在保持绿灯的前提下重构(REFACTOR),循环重复。核心铁律是“没有失败测试,就不写生产代码”,先写实现再补测试被视为需删除代码重来;同时列出常见合理化借口、红旗信号、验证清单,以及测试难以编写时的设计排错建议。适用于新功能、Bug 修复、重构与行为变更,一次性原型、生成代码、配置文件等例外需征得人类搭档同意。
适合Agent 实现新功能时,需要先写失败测试再写实现
该技能用于在当前会话中由执行者本人按计划逐任务实现:不使用每个任务的实现子代理和审查子代理,而是在最后对整个分支做一次全新上下文的审查。它把计划视为已完成思考的产物,要求严格按计划执行、用“先看到失败再看到通过”的测试证明每一步,并把进度与裁决写入 workspace 中的 ledger 文件(progress.md),以防上下文压缩后遗忘或重复实现。执行中不逐任务向人类确认,遇到冲突、歧义或计划缺陷时自行裁决并记录 Ruling;只有四类情况会停止并询问:不可逆或破坏性操作、安全敏感动作、工作树之外的副作用(如合并、推送共享分支、发布)、以及计划坏到所有前路都只能靠猜。结束时按影响重新评定审查发现,Critical/Important 进入唯一一次修复通道,Minor 记入 ledger 并在最终消息列出。
适合已通过 superpowers:writing-plans 获得计划,且人类伙伴在交接时明确选择内联执行
该 skill 用于在当前会话中执行一份实现计划:为每个任务派发一个带隔离上下文的全新实现子代理,任务完成后派发任务评审(同时检查规格符合性与代码质量),全部任务结束后再做一次整分支的总体评审。它要求用 ledger 文件记录进度以防上下文压缩后丢失位置,按任务复杂度显式选择子代理模型,用修复循环处理评审发现的问题,并在遇到冲突、歧义或计划缺陷时直接裁决并记入 ledger,而不是停下来询问。
适合已有一份实现计划,且各任务大多相互独立,需要在当前会话中连续逐项执行
Supabase 维护的 Postgres 最佳实践指南,涵盖查询性能、连接管理、安全与 RLS、Schema 设计、并发与锁、数据访问模式、监控诊断、高级特性等 8 类规则,包含 SQL 示例与查询计划分析,用于指导数据库优化与代码生成。
适合创建或修改表、列、Schema 设计、迁移和声明式 Schema 文件时
这是 Supabase 官方发布的 agent skill(仓库 supabase/agent-skills,版本 0.1.2),面向任何涉及 Supabase 的任务,覆盖 Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues 等产品,以及 supabase-js、@supabase/ssr 在 Next.js、React、SvelteKit、Astro、Remix 中的 SSR 集成。内容分几块:核心原则(不依赖训练数据、先查 changelog 与当前文档、实现后验证、失败 2-3 次即换思路、表暴露到 Data API 的 GRANT 与 RLS 关系);一份 Supabase 专属安全清单(JWT 授权不能用 user_metadata、删除用户不失效 token、service_role 与密钥不得暴露、视图默认绕过 RLS、UPDATE 需要 SELECT 策略、auth.role() 已废弃且匿名登录下会失效、TO authenticated 单独使用构成 BOLA/IDOR、UPDATE 策略需 USING+WITH CHECK、SECURITY DEFINER 绕过 RLS 且 public 中默认可被调用、Storage upsert 需 INSERT+SELECT+UPDATE、锁定依赖版本);CLI 使用规范(必须用 --help 发现命令,附已知版本门槛与踩坑);MCP server 的连接排查步骤(可达性 curl、.mcp.json、OAuth 2.1 认证、scoped token 权限);文档获取优先级(MCP search_docs、URL 加 .md、网络搜索);schema 变更的声明式与命令式两条路径(并说明何时用 execute_sql 而非 apply_migration);以及调试时必须先读 Monitoring and Debugging 文档。
适合在 Next.js、React、SvelteKit、Astro、Remix 中接入 supabase-js 或 @supabase/ssr,并处理登录、登出、会话、JWT、cookie、getSession/getUser/getClaims
Firebase 官方(Google LLC,v1.0.0)提供的基础设施类 Agent Skill,专注 Firebase CLI 的入门配置:检查/安装 firebase-tools(统一通过 npx -y firebase-tools@latest 执行)、CLI 登录(含无浏览器环境的 --no-localhost 方式)、项目创建(projects:create)与项目切换/确认(firebase use),以及用 apps:sdkconfig 以编程方式拉取 Android 的 google-services.json 与 iOS 的 GoogleService-Info.plist。技能还要求按所用 Agent 环境(Gemini CLI、Antigravity、Android Studio、Claude Code、Cursor、GitHub Copilot 等)阅读对应参考文档完成本地环境搭建与后续刷新,并强调优先使用 Firebase MCP Server 工具与 developerknowledge_search_documents 检索官方知识。该技能明确限定使用范围:不用于 Hosting 部署、Firestore、Auth、App Hosting、Data Connect、Crashlytics 或 Remote Config。
适合首次在项目中配置 Firebase CLI 并验证版本与安装状态
Firebase 官方(Google LLC)提供的 Firebase Authentication 入门指南,属于 Identity 类别。内容覆盖核心概念(用户 uid/email/displayName/photoURL/emailVerified、身份提供商、ID Token 与 Refresh Token)、配置流程(通过 firebase.json 的 auth 块以 CLI 启用 Google Sign In、匿名和邮箱/密码,或用控制台启用其他提供商,并需执行 firebase deploy --only auth 部署生效)、客户端接入参考(Web、Flutter、Android Kotlin、iOS Swift)以及使用 request.auth 编写 Firestore/Storage 安全规则。文中给出 authorizedRedirectUris 的常见配置坑:不含端口号,否则部署会报 INVALID_AUTHORIZED_DOMAIN;本地开发需允许 localhost 以规避 unauthorized-domain。使用前提是已有 Firebase 项目和已登录的 Firebase CLI(可经 npx -y firebase-tools@latest 调用),并且该技能与 Firebase CLI 配合使用最佳但并非必需。
适合为 Web/Flutter/Android/iOS 应用添加 Firebase 用户登录与注册
Convex 数据库快速入门技能:从一句话想法启动一个极简 Next.js + Convex 模板,使用匿名开发部署。包含工作流程、规则、数据访问、HTTP 路由、保留名称及自验证等关键约束。
适合快速生成 Convex + Next.js 项目脚手架
用于 Convex 首次配置认证,支持 Clerk、Auth0 和自定义 JWT 提供方。
适合适合 Convex 认证首次接入。
Neon 官方提供的 neon-postgres 技能,面向在 Neon 上使用 Lakebase Postgres 的数据库工作:如何选择池化与直连连接串及驱动、以代码方式管理 schema 与迁移、分支工作流(含 schema-only 分支、从父分支重置、branch-per-PR)、计算实例的自动扩缩容与 scale-to-zero、即时恢复、只读副本、连接池、IP 白名单、逻辑复制、出口流量优化,以及 Lakebase Search 的语义、全文(BM25)与混合搜索。文档还给出基于 neon inspect db 与 MCP inspect_database 的诊断检查项、Neon LFC 与预取相关的 EXPLAIN 选项,以及一套性能排查流程。
适合在 Neon 上执行 schema 迁移,并确认使用不带 -pooler 的直连连接串
Firestore 大规模应用方案,涵盖分片、复合索引和企业级数据建模。
适合需要优化 Firestore 性能的开发者
用于 PlanetScale Postgres 的架构设计、分支管理和 Vitess 扩展模型理解。
适合适合 PlanetScale Postgres 设计。
帮助处理 PlanetScale MySQL 的分支迁移、分片扩展、连接方式和 InnoDB 结构设计。
适合适合 PlanetScale MySQL 迁移优化。
该技能要求在声称任务完成、修复或通过之前,必须先运行验证命令并确认输出,始终遵循“证据先于声明”的原则。
适合在提交代码或创建 PR 之前确保验证已执行
微软官方维护的 playwright-cli 技能,用命令行控制一个真实的浏览器:打开页面、按快照中的 ref 点击/输入/拖拽/悬停/上传、截图或导出 PDF,并可录制、检查与回放交互。除核心操作外,还覆盖标签页管理、Cookies/localStorage/sessionStorage 与 state 保存加载、配色与媒体等模拟、网络请求 route 模拟、console/requests 调试、tracing 与视频录制(可加章节和动作标注)、run-code 执行 Playwright 脚本、生成 locator 与元素高亮。它支持 --raw 与 --json 结构化输出以便管道处理,可通过命名会话、持久化 profile、浏览器扩展或 CDP 连接已有浏览器,并可调用页面通过实验性 WebMCP 注册的工具。
适合用快照 ref 驱动真实浏览器完成点击、填表、上传、拖拽等多步页面交互