Agent Skills

这是一套为 AI 编程助手优化的 React Native 技能集合。本仓库为那些可以直接读取 skills/ 目录的助手提供了原始的 Agent Skills，同时也为 Claude Code 和 Codex 插件工作流提供了市场元数据（marketplace metadata）。

可用技能

技能	描述
react-native-best-practices	来自 Callstack 的 React Native 优化最佳实践
github	用于 PR、代码审查和分支管理的 GitHub 工作流模式
github-actions	用于 React Native 模拟器/仿真器构建产物的 GitHub Actions 工作流模式
upgrading-react-native	React Native 升级工作流：模板、依赖项及常见陷阱
react-native-brownfield-migration	使用 @callstack/react-native-brownfield 在原生应用中增量采用 React Native 或 Expo 的迁移策略，包含设置、打包及分阶段集成步骤

React Native 最佳实践

基于 Callstack 出品的 《React Native 优化终极指南》 构建的性能优化技能。

涵盖范围：

• JavaScript/React: 性能分析、FPS、重渲染、列表、状态管理、动画
• Native: iOS/Android 性能分析、TTI（首屏可交互时间）、内存管理、Turbo Modules
• Bundling: Bundle 分析、Tree Shaking、R8、应用体积优化

快速开始

Claude Code

使用 .claude-plugin/marketplace.json 中的 Claude Code 市场元数据。

1. 添加市场：

/plugin marketplace add callstackincubator/agent-skills

2. 安装所需的技能：

/plugin install react-native-best-practices@callstack-agent-skills

其他可用安装方式：

/plugin install github@callstack-agent-skills
/plugin install github-actions@callstack-agent-skills
/plugin install upgrading-react-native@callstack-agent-skills
/plugin install react-native-brownfield-migration@callstack-agent-skills

或者使用交互式菜单：

/plugin menu

本地开发：

claude --plugin-dir ./path/to/agent-skills

安装完成后，Claude 将根据任务自动加载相关技能。

OpenAI Codex

本仓库支持通过以下两种方式使用 Codex。

选项 1：安装捆绑的 Codex 插件

npx codex-plugin add callstackincubator/agent-skills

这将读取 .agents/plugins/marketplace.json，将捆绑的插件安装到 .codex/plugins/，并在重启 Codex 后生效。

选项 2：安装独立技能

所有主流 AI 编程助手均支持 Agent Skills 标准。

通过 skill-installer 安装：

$skill-installer install react-native-best-practices from callstackincubator/agent-skills

或者手动克隆：

# 项目级
git clone https://github.com/callstackincubator/agent-skills.git
cp -r agent-skills/skills/* .codex/skills/

# 用户级
cp -r agent-skills/skills/* ~/.codex/skills/

重启 Codex 以识别新安装的技能。

使用方法： 输入 $ 以引用技能，或使用 /skills 命令。

这些技能包含用于 Codex Skills UI 兼容性的 agents/openai.yaml 元数据。

其他 AI 助手

Cursor

选项 1：从 GitHub 导入规则

Cursor 的 GitHub / GitLab 规则导入器仅识别 .mdc 文件（通常位于 .cursor/rules/ 下）。本仓库包含这些文件，因此可以直接导入。

1. 打开 Cursor 设置 (Cmd+Shift+J / Ctrl+Shift+J)
2. 导航至 Rules 并使用 Import rules from GitHub（不同版本表述可能略有不同），或添加来自 Git URL 的远程规则
3. 输入：https://github.com/callstackincubator/agent-skills.git

导入的规则是简短的 Cursor 项目规则；它们指向 skills/ 下完整的 Agent Skills。当希望模型在本地读取完整的 markdown 技能时，请将 skills/ 树克隆或复制到工作区中（参见选项 2）。

选项 2：本地安装

# 项目级
git clone https://github.com/callstackincubator/agent-skills.git .cursor/skills/agent-skills

# 用户级（在所有项目中可用）
git clone https://github.com/callstackincubator/agent-skills.git ~/.cursor/skills/agent-skills

使用方法： 在 Agent 对话中输入 / 即可搜索并按名称选择技能。

Gemini CLI

从仓库安装：

gemini skills install https://github.com/callstackincubator/agent-skills.git

或者安装到工作区：

gemini skills install https://github.com/callstackincubator/agent-skills.git --target ./skills