Claude-Skills-完全构建指南--分发与共享

Skills 让你的 MCP 集成更加完整。当用户比较各种连接器时，拥有 Skills 的连接器提供了更快的价值路径，让你在仅有 MCP 的替代方案中脱颖而出。

个人用户获取 Skills 的方式：

1. 下载 Skill 文件夹
2. 压缩文件夹（如需要）
3. 通过 Claude.ai 的 Settings > Capabilities > Skills 上传
4. 或放置在 Claude Code skills 目录中

组织级 Skills：

• 管理员可以在整个工作区部署 Skills（2025 年 12 月 18 日上线）
• 自动更新
• 集中管理

我们将 Agent Skills 作为开放标准发布。与 MCP 一样，我们相信 Skills 应该可以跨工具和平台移植——无论使用 Claude 还是其他 AI 平台，同一个 Skill 都应该能够工作。也就是说，有些 Skills 被设计为充分利用特定平台的能力；作者可以在 Skill 的 compatibility 字段中注明这一点。我们一直在与生态系统的各方成员合作推进这一标准，并对早期采用者的积极反响感到振奋。

对于程序化使用场景——如构建利用 Skills 的应用程序、智能体或自动化工作流——API 提供对 Skill 管理和执行的直接控制。

核心能力：

• /v1/skills 端点，用于列举和管理 Skills
• 通过 container.skills 参数将 Skills 添加到 Messages API 请求
• 通过 Claude Console 进行版本控制和管理
• 与 Claude Agent SDK 协同工作，用于构建自定义智能体

何时使用 API vs. Claude.ai：

注意：API 中的 Skills 需要代码执行工具（Code Execution Tool）beta 版，该工具提供了 Skills 运行所需的安全环境。

更多实现细节，请参阅：

• Skills API 快速入门
• 创建自定义 Skills
• Agent SDK 中的 Skills

从在 GitHub 上用公开仓库托管你的 Skill 开始，包含清晰的 README（面向人类访问者——这与你的 Skill 文件夹分开，Skill 文件夹不应包含 README.md）以及带截图的示例用法。然后在你的 MCP 文档中添加一个章节，链接到该 Skill，解释同时使用两者为何有价值，并提供快速入门指南。

1. 在 GitHub 上托管

• 开源 Skills 使用公开仓库
• 清晰的 README，包含安装说明
• 示例用法和截图

2. 在你的 MCP 仓库中建立文档

• 从 MCP 文档链接到 Skills
• 解释同时使用两者的价值
• 提供快速入门指南

3. 创建安装指南

## 
	
	Installing the 
	
	
	
	[
	
	
	
	Your Service
	
	
	
	]
	
	
	
	 skill
	
	
	
	

1
	
	
	
	.
	
	
	
	 Download the skill:
    -
	
	
	
	 Clone repo: `git clone https://github.com/yourcompany/
	
	
	
	
      skills`
    -
	
	
	
	 Or download ZIP from Releases

2
	
	
	
	.
	
	
	
	 Install in Claude:
    -
	
	
	
	 Open Claude.ai > Settings > skills
    -
	
	
	
	 Click "Upload skill"
    -
	
	
	
	 Select the skill folder (zipped)

3
	
	
	
	.
	
	
	
	 Enable the skill:
    -
	
	
	
	 Toggle on the [
	
	
	
	Your Service]
	
	
	
	 skill
    -
	
	
	
	 Ensure your MCP server is connected

4
	
	
	
	.
	
	
	
	 Test:
    -
	
	
	
	 Ask Claude: "Set up a new project in [
	
	
	
	Your Service]
	
	
	
	"

你描述 Skill 的方式决定了用户是否理解其价值并真正尝试使用它。在 README、文档或推广材料中介绍你的 Skill 时，请遵循以下原则：

聚焦结果，而非功能：

✅ 好：

"The ProjectHub skill enables teams to set up complete project
workspaces in seconds — including pages, databases, and
templates — instead of spending 30 minutes on manual setup."

❌ 差：

"The ProjectHub skill is a folder containing YAML frontmatter
and Markdown instructions that calls our MCP server tools."

突出 MCP + Skills 的组合：

"Our MCP server gives Claude access to your Linear projects.
Our skills teach Claude your team's sprint planning workflow.
Together, they enable AI-powered project management."

 claude-skills-完整构建指南简介

• 第一章：基础知识
• 第二章：规划与设计
• 第三章：测试与迭代
• 第四章：分发与共享
• 第五章：模式与故障排除
• 第六章：资源与参考
• 参考 A：快速检查清单
• 参考 B：YAML Frontmatter