ComposioHQ/awesome-claude-skills 保姆级部署教程：Claude 技能资源精选清单

一句话定位：GitHub 开源项目 ComposioHQ/awesome-claude-skills 是一份由 Composio 团队维护的、生产可用的 Claude Skills 精选清单（curated list）——收录了 1000+ 个可直接用在 Claude.ai、Claude Code、Claude API，以及 Codex、Cursor、Gemini CLI、Antigravity、Windsurf 等编码智能体上的技能（Skill）、插件与工作流，按文档处理、开发编码、数据分析、商业营销、写作沟通、创意媒体、生产力、协作管理、安全系统、SaaS 自动化等大类整理好，开箱即装。

slogan：A comprehensive and curated list of 1000+ production ready and practical Claude Skills and Plugins.

仓库地址：https://github.com/ComposioHQ/awesome-claude-skills · 许可证：Apache-2.0 · ⭐ 78,444 · 官方徽章：Awesome / PRs welcome

▲ 图 1：ComposioHQ/awesome-claude-skills 官方横幅（README 顶部内嵌图，Composio 官方出品，1280×640）

▲ 图 2：README 头部官方徽章组——Awesome 精选清单认证、PRs welcome 欢迎贡献、Apache-2.0 开源许可证（shields.io 渲染，README 官方展示）

▲ 图 3：README 头部官方社交徽章组——Follow on X、Follow on LinkedIn、Join our Discord（shields.io 渲染，README 官方展示）

▲ 图 4：README 尾部官方 CTA 徽章——Get Started Free，引导前往 Composio 平台免费注册（shields.io 渲染，README 官方展示）

一、项目简介

Claude Skills 是 Anthropic 在 2025 年 10 月推出、12 月作为开放标准发布的一种可复用指令包：每个 Skill 是一个文件夹，里面放一个带 YAML frontmatter（name、description）的 SKILL.md，再可选附带 scripts/、templates/、references/ 等辅助资源。智能体在会话启动时只读到每个 Skill 的名称与描述（约 100 token），当它判断当前任务相关时，才把完整的 SKILL.md 正文（通常 < 5000 token）以及辅助脚本按需加载进来——这种渐进加载机制让单个智能体可以同时挂载成百上千个技能而不撑爆上下文窗口。

ComposioHQ/awesome-claude-skills 本身不是一个需要编译运行的服务，而是 Composio 团队维护的一份精选清单 + 配套技能源码集：它把社区和官方散落的 Claude Skills 按业务场景分类整理好，仓库内还直接内置了一批可直接 cp -r 到技能目录就能用的技能（如 changelog-generator、mcp-builder、skill-creator、webapp-testing、canvas-design、image-enhancer、file-organizer、invoice-organizer，以及一整套基于 Composio Rube MCP 的 78 个 SaaS 自动化技能：Salesforce、HubSpot、Notion、Jira、Slack、Gmail、GitHub、Vercel、Stripe、Shopify 等）。

需要特别区分三层概念：Skill 不是 MCP Server，也不是工具本身。MCP 定义智能体如何连外部系统（鉴权、传输、工具发现），工具（tool）是智能体调用的具体函数，而 Skill 定义工作流——拿到连接和工具之后，按什么顺序、带什么护栏去做。生产环境里三者一起跑：MCP 管访问、工具管动作、Skill 管行为。

二、功能特点 / 核心能力

三、环境要求

• 宿主智能体：Claude Code（CLI）、Claude.ai 网页端、Claude API 三选一；清单中技能同样兼容 Codex、Cursor、Gemini CLI、Antigravity、Windsurf。
• 操作系统：Claude Code 支持 macOS / Linux / Windows（WSL 或原生终端）；技能目录路径在 Windows 上为 %USERPROFILE%\.config\claude-code\skills\，类 Unix 为 ~/.config/claude-code/skills/。
• 网络：能访问 GitHub 拉取仓库与各技能源码；使用 connect-apps 插件或 SaaS 自动化技能时，需能访问 Composio 控制台 dashboard.composio.dev 并申请免费 API Key。
• 运行时：仅需已安装并登录 Claude Code；纯文本类技能零依赖，带 scripts/ 的技能按脚本说明另行准备 Node/Python 环境。

四、保姆级部署步骤

4.1 克隆 awesome-claude-skills 仓库

本仓库是清单 + 内置技能源码合集，第一步先把它拉到本地：

git clone --depth 1 "https://github.com/ComposioHQ/awesome-claude-skills.git"
cd awesome-claude-skills

不需要 npm install、不需要构建——它本质是 Markdown 文档与若干技能目录的集合。

4.2 在 Claude.ai 网页端使用技能

在 Claude.ai 聊天界面点击技能图标（🧩），从技能市场添加，或直接上传自定义技能文件夹（把对应技能目录打成 zip 上传）。Claude 会根据你的任务自动激活相关技能。

4.3 在 Claude Code 中安装本地技能

以仓库内置的 mcp-builder 技能为例，把它复制到 Claude Code 的个人技能目录：

mkdir -p ~/.config/claude-code/skills/
cp -r ./mcp-builder ~/.config/claude-code/skills/
cp -r ./webapp-testing ~/.config/claude-code/skills/
cp -r ./skill-creator ~/.config/claude-code/skills/

复制完成后核对一下技能元数据是否正确写入：

head ~/.config/claude-code/skills/mcp-builder/SKILL.md

应该能看到 YAML frontmatter 中的 name: 与 description: 字段。

启动 Claude Code：

claude

技能会在启动时被自动加载，当你描述的任务与该技能的 description 匹配时，Claude Code 会自动激活它。

4.4 安装 connect-apps 插件（连接 1000+ 应用）

如果你想让 Claude 真正动手发邮件、建 Issue、发 Slack，使用 README 提供的 connect-apps 插件：

claude --plugin-dir ./connect-apps-plugin

启动后在 Claude 对话中输入斜杠命令完成设置：

/connect-apps:setup

按提示粘贴你的 Composio API Key（免费 Key 在 dashboard.composio.dev 注册获取），然后退出重启：

exit
claude

重启后试着让 Claude 发一封测试邮件；如果邮箱收到，说明 Claude 已经通过 Composio 连上了 1000+ 个应用。支持的完整应用清单见 composio.dev/toolkits。

4.5 通过 Claude API 编程式加载技能

把技能接入自己的 Python 服务端时，用 Claude Skills API：

import anthropic

client = anthropic.Anthropic(api_key="your-api-key")

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    skills=["skill-id-here"],
    messages=[{"role": "user", "content": "Your prompt"}]
)

详细参数见 官方 Skills API 文档。

五、配置说明

5.1 标准 Skill 目录结构

仓库里每个内置技能都遵循同一套目录约定：

skill-name/
├── SKILL.md          # 必需：技能指令与元数据（YAML frontmatter + Markdown 正文）
├── scripts/          # 可选：辅助脚本（Node/Python）
├── templates/        # 可选：文档模板
└── resources/        # 可选：参考资料文件

5.2 SKILL.md 模板

照着这个模板写自己的技能即可：

---
name: my-skill-name
description: A clear description of what this skill does and when to use it.
---

# My Skill Name

Detailed description of the skill's purpose and capabilities.

## When to Use This Skill

- Use case 1
- Use case 2
- Use case 3

## Instructions

[Detailed instructions for Claude on how to execute this skill]

## Examples

[Real-world examples showing the skill in action]

写作最佳实践：聚焦具体、可复用的任务；给出清晰示例与边界情况；指令写给 Claude 看而不是写给终端用户看；在 Claude.ai、Claude Code、API 三种环境都测一遍；写清前置依赖与错误处理指引。

5.3 Composio API Key（可选）

只有使用 connect-apps 插件或仓库内 78 个 SaaS 自动化技能时才需要。在 Composio 控制台注册后于 /connect-apps:setup 命令中粘贴；Key 只保存在本机 Claude Code 配置里，不要提交到 Git。

六、使用方法

6.1 在 Claude Code 里触发技能

技能是按需自动激活的，不需要你手动 use。只要你描述的任务命中了某个已安装技能的 description，Claude Code 会自动加载该技能的 SKILL.md 正文并按其中指令执行。例如装好 mcp-builder 后，直接说「帮我用 Python 写一个调用 GitHub API 的 MCP Server」，它就会套用 MCP Builder 的规范。

6.2 从清单挑选并安装第三方技能

README 按大类列出了上百个社区技能（如 aws-skills、Chrome Relay、Playwright Browser Automation、Brand Build Skills、NotebookLM Integration 等），每个条目都带原始仓库链接。用法：点进对应仓库 → 把技能目录 git clone 或 curl 下载到本地 → 按 4.3 节 cp -r 到 ~/.config/claude-code/skills/ 即可。

6.3 使用 78 个 SaaS 自动化技能

仓库内 ./salesforce-automation/、./notion-automation/、./slack-automation/ 等目录是基于 Composio Rube MCP 预生成的工作流技能，每个内含工具调用序列、参数指引、已知坑点与速查表。把它们复制进技能目录，并在 Composio 控制台授权对应 SaaS 账号后，Claude 就能直接对该 SaaS 执行读、写、搜索等真实操作。

6.4 自己贡献新技能

想把自己的技能收录进清单：先读仓库根目录的 CONTRIBUTING.md；确保技能基于真实使用场景；检查清单里没有重复项；按 5.2 节模板写好；跨平台测试通过后提 PR。

七、常见问题 FAQ

问一：这个仓库需要「部署」吗？是不是要起一个服务？
答：它不是一个需要编译运行的服务，而是一份 Markdown 清单 + 一组可直接复制的技能目录。所谓「部署」其实就是 git clone 拉下来，再把想用的技能目录 cp -r 到 ~/.config/claude-code/skills/，重启 Claude Code 即可。

问二：Skill、MCP Server、工具（Tool）三者有什么区别？
答：MCP 管智能体怎么连外部系统（鉴权、传输、工具发现）；工具是智能体可以调用的具体函数；Skill 是一份指令包，定义拿到连接和工具之后按什么顺序、带什么护栏去做。生产里三层同时跑：MCP 提供访问、工具执行动作、Skill 规定行为。

问三：Claude.ai、Claude Code、Claude API 上的技能能通用吗？
答：格式通用。Anthropic 在 2025 年 12 月把 Skill 作为开放标准发布，同一套 SKILL.md 可在 Claude.ai、Claude Code、Claude API 以及 Codex、Cursor、Gemini CLI、Antigravity、Windsurf 上使用。但带 scripts/ 的脚本类技能在不同平台上的可执行性需各自验证。

问四：为什么我装了技能，Claude 却没有自动用？
答：Skill 是渐进加载的——会话启动时 Claude 只看每个技能的 name 和 description，只有当它判断当前任务相关时才加载正文。如果你的 prompt 没有命中 description，就不会触发。可以在对话里直接点名「用 xxx 技能来做」，或者把 description 写得更明确。

问五：connect-apps 插件一定要 Composio API Key 吗？
答：是的。只有你想让 Claude 对 1000+ 真实 SaaS 执行动作（发邮件、建 Issue、发 Slack）时才需要；纯清单浏览、本地静态技能安装完全不需要 Key。免费 Key 在 dashboard.composio.dev 注册即可获取。

问六：一个智能体里同时挂几十个技能会不会撑爆上下文？
答：不会。每个技能在启动阶段只占约 100 token（name + description），正文与脚本按需加载，这正是 Skill 设计的核心目的——单智能体挂载成百上千个技能也不会膨胀 context。

相关链接

• 项目仓库：ComposioHQ/awesome-claude-skills
• Composio MCP 网关：composio.dev/mcp-gateway
• Composio 控制台（申请免费 Key）：dashboard.composio.dev
• 支持应用清单：composio.dev/toolkits
• Anthropic 官方 Skill 示例仓库：anthropics/skills
• Skills 用户指南：Using Skills in Claude
• 自定义 Skill 创作指南：Creating Custom Skills
• Skills API 文档：Skills API
• Anthropic 工程博客：Equipping agents for the real world with agent skills
• Composio Discord 社区：discord.com/invite/composio