$npx -y skills add feiskyer/claude-code-settingsCurated skills, sub-agents, and config templates that supercharge Claude Code — research, image gen, GitHub automation & more.
| 1 | # Claude Code Skills & Agents |
| 2 | |
| 3 | [](https://github.com/feiskyer/claude-code-settings/stargazers) |
| 4 | [](https://github.com/feiskyer/claude-code-settings/network/members) |
| 5 | [](LICENSE) |
| 6 | [](https://github.com/feiskyer/claude-code-settings/commits) |
| 7 | [](CONTRIBUTING.md) |
| 8 | |
| 9 | 给 Claude Code 加上深度调研、图片生成、GitHub 自动化等能力,配好多模型切换,开箱即用。 |
| 10 | |
| 11 | > OpenAI Codex 的配置和自定义 prompt 请参考 [feiskyer/codex-settings](https://github.com/feiskyer/codex-settings)。 |
| 12 | |
| 13 | ## 快速开始 |
| 14 | |
| 15 | ```sh |
| 16 | /plugin marketplace add feiskyer/claude-code-settings |
| 17 | |
| 18 | # 安装主插件(包含所有技能和代理) |
| 19 | /plugin install claude-code-settings |
| 20 | ``` |
| 21 | |
| 22 | 主插件包含的完整技能列表:brainstorming、codex-skill、deep-research、github-fix-issue、github-review-pr、gpt-image-skill、grill-me、handoff、nanobanana-skill、skill-creator、translate、youtube-transcribe-skill,详见[技能列表](#技能列表)。单个技能也可以通过 npx skills 按需安装(见下方其他安装方式)。 |
| 23 | |
| 24 | **注意:** [~/.claude/settings.json](settings.json) 不通过 Plugin 配置,需要手动设置。 |
| 25 | |
| 26 | <details> |
| 27 | <summary><b>其他安装方式</b></summary> |
| 28 | |
| 29 | ### npx skills |
| 30 | |
| 31 | `npx skills` 可以为你的 AI 编程工具安装技能: |
| 32 | |
| 33 | ```sh |
| 34 | # 列出可用技能 |
| 35 | npx -y skills add -l feiskyer/claude-code-settings |
| 36 | |
| 37 | # 安装全部技能 |
| 38 | npx -y skills add --all feiskyer/claude-code-settings |
| 39 | |
| 40 | # 手动选择要安装的技能 |
| 41 | npx -y skills add feiskyer/claude-code-settings |
| 42 | ``` |
| 43 | |
| 44 | ### 手动安装 |
| 45 | |
| 46 | > **⚠️ 手动安装会覆盖 `~/.claude` 目录,请务必先备份原有配置。** |
| 47 | |
| 48 | ```sh |
| 49 | # 备份原有配置 |
| 50 | mv ~/.claude ~/.claude.bak |
| 51 | |
| 52 | # 克隆本仓库 |
| 53 | git clone https://github.com/feiskyer/claude-code-settings.git ~/.claude |
| 54 | |
| 55 | # 启动 Copilot Gateway 代理(监听 http://localhost:4141) |
| 56 | npx copilot-gateway@latest start --proxy-env |
| 57 | |
| 58 | # 也可以用 tmux 在后台运行 |
| 59 | # tmux new-session -d -s copilot 'npx copilot-gateway@latest start --proxy-env' |
| 60 | ``` |
| 61 | |
| 62 | 首次启动会提示认证: |
| 63 | |
| 64 | ``` |
| 65 | Please visit https://github.com/login/device and enter code XXXX-XXXX to authenticate. |
| 66 | ``` |
| 67 | |
| 68 | 打开链接,登录并授权你的 GitHub Copilot 账户。 |
| 69 | |
| 70 | **注意:** |
| 71 | |
| 72 | 1. 仓库根目录的 [settings.json](settings.json) 是作者的配置模板,默认指向 [copilot-gateway](https://github.com/feiskyer/copilot-gateway) 代理(`http://localhost:4141`)。如需使用 [LiteLLM Proxy Server](https://docs.litellm.ai/docs/simple_proxy) 等其他网关,把 `ANTHROPIC_BASE_URL` 改为对应地址(如 `http://localhost:4000`)即可。 |
| 73 | 2. 确保以下模型在你的账户中可用,否则需替换为你自己的模型名(模型名以你的网关实际提供的为准): |
| 74 | |
| 75 | - ANTHROPIC_DEFAULT_SONNET_MODEL: claude-sonnet-4-6 |
| 76 | - ANTHROPIC_DEFAULT_OPUS_MODEL: claude-opus-4-6 |
| 77 | - ANTHROPIC_DEFAULT_HAIKU_MODEL: claude-haiku-4-5 |
| 78 | 3. 模板中 `defaultMode` 为 `acceptEdits`(自动接受文件编辑但保留命令确认)。如需完全跳过权限确认可自行改为 `bypassPermissions`,但请了解其安全风险后再启用。 |
| 79 | |
| 80 | </details> |
| 81 | |
| 82 | ## 技能列表 |
| 83 | |
| 84 | 技能是[可复用的能力模块](https://docs.anthropic.com/en/docs/claude-code/skills),教会 Claude 如何完成特定任务。可通过 `/skill-name [参数]` 手动调用,或根据上下文自动触发。 |
| 85 | |
| 86 | <details> |
| 87 | <summary><b>brainstorming</b> — 头脑风暴:从想法到设计</summary> |
| 88 | |
| 89 | ### [brainstorming](./skills/brainstorming) |
| 90 | |
| 91 | 在构建新功能、创建新组件或设计新系统之前使用。通过协作对话探索用户意图、需求和设计方案,再进入实现阶段。 |
| 92 | |
| 93 | **触发词:** 用户描述想要构建的东西且涉及设计决策 |
| 94 | |
| 95 | **核心特性:** |
| 96 | |
| 97 | - 逐个提问,渐进式理解需求 |
| 98 | - 提出 2-3 个方案并推荐最优解 |
| 99 | - 分节呈现设计,每节获得用户认可 |
| 100 | - 编写规格文档并自审 |
| 101 | - 可选的浏览器可视化伴侣(展示 mockup、图表、布局对比) |
| 102 | |
| 103 | </details> |
| 104 | |
| 105 | <details> |
| 106 | <summary><b>codex-skill</b> — 将任务交给 Codex CLI</summary> |
| 107 | |
| 108 | ### [codex-skill](./skills/codex-skill) |
| 109 | |
| 110 | 非交互式自动化模式,使用 OpenAI Codex 完成 Claude 设计好的功能或计划。 |
| 111 | |
| 112 | **触发词:** "codex", "use gpt", "gpt-5", "let openai", "full-auto", "用codex", "让gpt实现" |
| 113 | |
| 114 | **核心特性:** |
| 115 | |
| 116 | - 多种执行模式(只读、工作区写入、完全访问) |
| 117 | - 默认使用 `~/.codex/config.toml` 中配置的模型 |
| 118 | - 自主执行无需审批 |
| 119 | - JSON 结构化输出、可恢复会话 |
| 120 | - CLI 完整参考和场景示例见 `references/` 目录 |
| 121 | |
| 122 | **依赖:** Codex CLI(`npm i -g @openai/codex` 或 `brew install codex`) |
| 123 | |
| 124 | </details> |
| 125 | |
| 126 | <details> |
| 127 | <summary><b>nanobanana-skill</b> — 使用 Gemini 生成图片</summary> |
| 128 | |
| 129 | ### [nanobanana-skill](./skills/nanobanana-skill) |
| 130 | |
| 131 | 通过 Google Gemini API 生成或编辑图片。这是默认图片技能——未指明提供商的图片请求都路由到这里。 |
| 132 | |
| 133 | **触发词:** "nanobanana", "generate image", "create image", "edit image", "图片生成", "生成图片", "AI绘图", "图片编辑" |
| 134 | |
| 135 | **核心特性:** |
| 136 | |
| 137 | - 多种宽高比和分辨率(1K、2K、4K) |
| 138 | - 图片编辑功能 |
| 139 | - 多模型选择(gemini-3.1-flash-image-preview 默认, gemini-3-pro-image-preview 高质量) |
| 140 | |
| 141 | **依赖:** |
| 142 | |
| 143 | - `GEMINI_API_KEY`(配置在 `~/.nanobanana.env`) |
| 144 | - Python3 + google-genai, Pillow, python-dotenv |
| 145 | |
| 146 | </details> |
| 147 | |
| 148 | <details> |
| 149 | <summary><b>gpt-image-skill</b> — 使用 OpenAI GPT Image 生成图片</summary> |
| 150 | |
| 151 | ### [gpt-image-skill](./skills/gpt-image-skill) |
| 152 | |
| 153 | 使用 OpenAI GPT Image 模型(gpt-image-2, gpt-image-1 等)生成或编辑图片。仅在用户明确指定 OpenAI/GPT 时触发;未指明提供商的图片请求由 nanobanana-skill 处理。 |
| 154 | |
| 155 | **触发词:** "gpt image", "openai image", "generate image with openai", "用 openai 画图", "用 GPT 生成图片" |
| 156 | |
| 157 | **核心特性:** |
| 158 | |
| 159 | - 多模型支持(gpt-image-2, gpt-image-1.5, gpt-image-1, gpt-image-1-mini) |
| 160 | - 最多 3 张参考图编辑 |
| 161 | - 多种尺寸和质量等级 |
| 162 | - 透明背景、多输出格式(png, jpeg, webp) |
| 163 | |
| 164 | **依赖:** |
| 165 | |
| 166 | - `OPENAI_API_KEY`(配置在 `~/.gpt-image.env` 或环境变量) |
| 167 | - Python3 + openai, Pillow |
| 168 | |
| 169 | </details> |
| 170 | |
| 171 | <details> |
| 172 | <summary><b>youtube-transcribe-skill</b> — YouTube 字幕提取</summary> |
| 173 | |
| 174 | ### [youtube-transcribe-skill](./skills/youtube-transcribe-skill) |
| 175 | |
| 176 | 从 YouTube 视频链接提取字幕/转录文本。 |
| 177 | |
| 178 | **核心特性:** |
| 179 | |
| 180 | - 双提取方式:CLI(快速)和浏览器自动化(兜底) |
| 181 | - 自动选择字幕语言(zh-Hans, zh-Hant, en) |
| 182 | - 保存转录文本到本地文件 |
| 183 | |
| 184 | **依赖:** `yt-dlp`(CLI 方式)或 `chrome-devtools-mcp`(浏览器方式) |