coleam00/second-brain-skills · 上手攻略

• 仓库：coleam00/second-brain-skills
• 链接：https://github.com/coleam00/second-brain-skills
• 分类：ai-productivity
• 作者：Tom
• 更新：2026-08-17

是什么

second-brain-skills 是一组为 Claude Code 打造的自定义 Skills 合集，将 Claude Code 从单纯的代码助手扩展为「第二大脑」——能够系统性捕获、组织和运营知识的工作流系统。

核心哲学是渐进式上下文披露（Progressive Disclosure of Context）：Claude 只在需要时才加载详细指令，保持上下文效率的同时维持每个领域的深度专业度。

Stars 812，周增 +7，2026 年内稳步增长。

解决什么问题

大多数用户把 Claude Code 当成写代码/调试工具用。这套 skills 解决的问题是：

1. 上下文膨胀：MCP 服务器工具有几千 token 的 schema，全部加载会撑爆 context window → 渐进加载解决
2. 品牌/风格不一致：每次生成 PPT、写文档都要重新说明风格 → 一次定义，随处复用
3. 重复性知识工作：每次新项目都要重建 SOP/文档结构 → 模板化解决
4. 跨工具集成：Zapier/GitHub/Slack 等外部服务接入 Claude Code 没有标准方案 → MCP 客户端封装

快速安装

本仓库不是 npm 包，而是一组 Claude Skills 集合。安装方式是将 skills 复制到本地 Claude Code 的 skills 目录：

# 假设你的 Claude Code skills 目录在以下位置
#（实际路径取决于你的 Claude Code 配置）
ls ~/.claude/skills/  # 查看已有 skills

# 克隆仓库
git clone https://github.com/coleam00/second-brain-skills.git
cd second-brain-skills

# 复制单个 skill 目录到你的 skills 目录
# 例如安装 brand-system skill
cp -r brand-system ~/.claude/skills/brand-system

每个 skill 内部结构遵循 Claude Code Skills 规范：

skill-name/
├── SKILL.md          # 必须：YAML frontmatter + 指令正文
├── scripts/          # 可选：可执行脚本
├── references/      # 可选：按需加载的文档
└── assets/          # 可选：输出使用的资源文件

核心 Skills 一览

1. Brand System（品牌系统）

定义品牌视觉和写作风格，一次定义后所有内容生成自动复用。

生成文件： | 文件 | 用途 | 使用者 | |------|------|--------| | brand.json | 颜色/字体/资源 | PPTX Generator | | config.json | 输出设置 | PPTX Generator | | brand-system.md | 设计哲学与指南 | 所有 skills | | tone-of-voice.md | 写作声音与人格 | 内容生成、SOP |

内置 5 种声音模板：Technical Educator、Calm Authority、Builder's Perspective、Approachable Expert、Contrarian Thinker。

2. MCP Client（MCP 客户端）

将外部 MCP 服务器（Zapier、GitHub、Sequential Thinking 等）接入 Claude Code，工具 schema 按需加载而非一次性全部注入上下文。

# Step 1: 复制示例配置
cp .claude/skills/mcp-client/references/example-mcp-config.json \
   .claude/skills/mcp-client/references/mcp-config.json

# Step 2: 编辑 mcp-config.json，填入你的 API keys
# 支持两种传输类型：
# - url + api_key → 远程服务器 Bearer 认证（Zapier）
# - command + args → 本地 stdio 服务器（npx、python、docker）

配置示例：

{
  "mcpServers": {
    "zapier": {
      "url": "https://mcp.zapier.com/api/v1/connect",
      "api_key": "YOUR_API_KEY_HERE"
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    }
  }
}

3. PPTX Generator（幻灯片生成）

使用 python-pptx 生成专业演示文稿和 LinkedIn 轮播图，自动应用品牌样式。

三种模式： - Slide Generation：16:9 演示文稿 - Carousel Generation：1:1 LinkedIn 轮播（导出 PDF） - Layout Management：创建和编辑布局

视觉优先原则：content-slide 是最后手段，非常规选项。内置决策树： - 3-5 个平等项 → multi-card-slide - 2-4 个大数字 → stats-slide - 两个事物对比 → two-column-slide - 中心概念 + 周围项 → circular-hero-slide - 有力引言 → quote-slide

4. Runbook Generator（运维手册生成）

创建实际会被人阅读的技术文档，而不是 50 页没人看的 PDF。

文档类型：Runbook（运维手册）、Playbook（行动手册）、SOP（标准操作流程）。

5. Remotion Video Creator（视频创建）

使用 React + Remotion 框架创建程序化视频，支持动画、合成、字幕等。

6. Skill 开发技能

教你如何从头创建新的 Claude Code Skill，流程为： 1. 理解具体案例 → 2. 规划可复用内容 → 3. 初始化（init_skill.py）→ 4. 编辑实现 → 5. 打包（package_skill.py）→ 6. 真实使用迭代

典型适用场景

坑与注意

⚠️ Skill 目录结构必须合规：每个 skill 必须包含 SKILL.md 文件（带 YAML frontmatter），否则 Claude Code 无法识别。

⚠️ MCP Client 需要手动配置：示例配置复制后才能使用，不支持开箱即用。

⚠️ PPTX Generator 依赖 python-pptx：

pip install python-pptx

Windows 环境字体路径与 macOS/Linux 不同，可能需要调整。

⚠️ Brand System 必须先于 PPTX Generator 运行：后者依赖前者生成的 brand.json 和 config.json。

⚠️ Remotion 需要 Node.js + ffmpeg：视频导出依赖 ffmpeg，需要提前安装。

⚠️ 不包含运行时依赖安装脚本：skills 本身不负责安装 python-pptx、remotion 等，需要手动安装。

⚠️ 非 npm 发布包：不是 npm install 即可用，需要手动复制 skill 目录到对应位置，更新时需要手动同步。

与同类对比

second-brain-skills 的独特价值在于渐进式上下文加载机制——相比一次性加载所有工具定义，它能显著降低 context 消耗，适合长期知识管理场景，而非单次代码任务。

一句话推荐结论

如果你已经用 Claude Code 做知识工作，想把零散能力整合成有体系的工作流（品牌管理/MCP集成/文档标准化），second-brain-skills 是目前面向 Claude Code 场景最完整的技能包；仅用于写代码的话，它提供的增量价值有限。