mcpField
S
skill-creator

skill-creator

github.com/breverdbidderAgent 工作流36 次安装
代码仓库

关于 skill-creator

skill-creator 是用于创建和改进 Claude 技能的交互式指南，面向技能编写者。它涵盖技能结构、工作流指导及可选配套资源。

主要功能

  1. 01创建与修改技能的指导
  2. 02SKILL.md 结构与元数据
  3. 03指令、示例和工作流设计
  4. 04脚本、参考资料与素材配置
  5. 05技能测试与质量实践

适用场景

  1. 01起草新的 Claude 技能
  2. 02改进现有技能
  3. 03整理技能的配套文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/breverdbidder/life-os --skill skill-creator

安装后在 Claude Code 中输入/skill-creator确认已加载。

详细介绍

技能创建器

用于创建高质量 Claude 技能的交互式指南。

何时使用此技能

在以下情况使用此技能：

  • 用户想要创建新的 Claude 技能
  • 用户想要更新或改进现有技能
  • 用户需要有关技能结构和最佳实践的指导
  • 用户想要扩展 Claude 在特定工作流中的能力

技能结构

每个技能都包含一个必需的 SKILL.md 文件，以及可选的捆绑资源：

skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter metadata (required)
│   │   ├── name: (required)
│   │   └── description: (required)
│   └── Markdown instructions (required)
└── Bundled Resources (optional)
    ├── scripts/ - Executable code (Python/Bash/etc.)
    ├── references/ - Documentation loaded into context as needed
    └── assets/ - Files used in output (templates, icons, fonts, etc.)

必需组件

前置元数据（YAML）
---
name: my-skill-name
description: A clear, comprehensive description of what this skill does and when to use it
---

重要：description 字段决定 Claude 何时使用此技能。请具体、全面地说明：

  • 此技能的功能
  • 应在何时使用
  • 哪些类型的查询会触发此技能
  • 此技能会生成什么输出
正文（Markdown）

Markdown 内容包括：

  • 说明：使用此技能的分步指南
  • 示例：具体的使用示例
  • 指南：最佳实践和规则
  • 工作流：详细流程

可选的捆绑资源

1. scripts/

适用情形：技能需要可执行代码时

示例：

  • scripts/analyzer.py - Python 数据分析脚本
  • scripts/formatter.sh - Bash 格式化工具
  • scripts/validator.js - JavaScript 验证工具

规则：

  • 纳入前必须经过测试
  • 应有完善的文档
  • 包含错误处理
2. references/

适用情形：技能需要详细的参考资料，但这些资料会让 SKILL.md 变得臃肿时

示例：

  • references/schema.md - 数据库架构文档
  • references/api-spec.md - API 端点参考
  • references/examples.md - 扩展示例

规则：

  • 将详细信息移至此处，让 SKILL.md 保持精简
  • 避免 SKILL.md 与 references/ 之间的内容重复
  • 用于存放架构、规范和详细示例
3. assets/

适用情形：技能需要在输出中使用的文件时

示例：

  • assets/logo.png - 品牌素材
  • assets/template.pptx - PowerPoint 模板
  • assets/boilerplate/ - HTML/React 起始代码
  • assets/fonts/ - 自定义字体

规则：

  • 仅用于最终输出中会用到的文件
  • 不用于存放文档（文档请放在 references/ 中）
  • 可存放模板、图片、图标和样板代码

创建工作流

步骤 1：分析使用场景

提出澄清问题：

  1. 此技能要处理什么具体任务？
  2. 用户查询有哪些 3–5 个具体示例？
  3. 是什么让此任务具有重复性或专业性？
  4. 需要哪些上下文或知识？
  5. 是否有可集成的现有工具/API？
步骤 2：识别可复用资源

针对每个具体示例，识别：

  • 有哪些实用脚本
  • 需要哪些参考文档
  • 应包含哪些素材/模板
步骤 3：创建结构
  1. 从 SKILL.md 前置元数据开始
  2. 撰写清晰、全面的描述
  3. 添加说明部分
  4. 根据需要创建 scripts/
  5. 添加 references/ 存放详细文档
  6. 添加 assets/ 存放模板
步骤 4：测试技能
  1. 测试所有脚本，确保其正常运行
  2. 确认参考资料完整
  3. 检查素材格式是否正确
  4. 验证 SKILL.md 中的说明是否清晰

最佳实践

撰写描述

✅ 良好的描述： “使用 12 阶段流程分析 Brevard County 的止赎拍卖。在 AcclaimWeb 中搜索留置权，使用 ARV 公式计算最高出价，并生成 BID/REVIEW/SKIP 建议。在分析止赎房产、计算最高出价或生成拍卖报告时使用。”

❌ 不佳的描述： “帮助进行止赎分析”

撰写说明
  • 具体且便于执行
  • 提供具体示例
  • 逐步定义工作流
  • 说明何时使用及何时不使用
  • 提供成功标准
资源组织
  • 让 SKILL.md 专注于操作流程
  • 将详细文档移至 references/
  • 纳入前测试所有脚本
  • 合理组织素材

常见技能模式

1. 领域专家技能

重点：某个领域的专业知识 资源：references/，其中包含领域文档和示例 示例：foreclosure-analysis、medical-coding

2. 工作流自动化技能

重点：可重复的多步骤流程 资源：用于自动化的 scripts/、assets/ 中的模板 示例：git-workflow、deployment-checklist

3. 集成技能

重点：使用外部 API/工具 资源：references/ 中的 API 文档、用于 API 调用的 scripts/ 示例：stripe-integration、supabase-setup

4. 模板/样板技能

重点：项目的起点 资源：assets/ 中的模板、references/ 中的文档 示例：react-boilerplate、brand-guidelines

示例

请参考以下技能：

  • frontend-design：带有美学指南的创意工作流
  • mcp-builder：包含详细规格的技术集成
  • docx：使用脚本进行复杂的文件操作
  • brand-guidelines：资源与参考资料的组合

评论

支持 Markdown