mcpField
S
skill-development

skill-development

github.com/letta-aiAgent 工作流152153 次安装4 周前更新
代码仓库

关于 skill-development

介绍如何创建、组织、验证并贡献可复用的 Agent 技能，面向技能作者。指南说明指令与资源的组织方式，并帮助判断内容是否具有通用价值。

主要功能

  1. 01定义 SKILL.md 结构和元数据
  2. 02通过渐进式披露组织内容
  3. 03使用脚本初始化、打包和验证
  4. 04评估并贡献可复用知识

适用场景

  1. 01为重复工作流创建技能
  2. 02打包技能以便分发
  3. 03向共享知识库贡献通用解决方案

安装

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

$npx skills add https://github.com/letta-ai/skills --skill skill-development

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
references/
contribution-examples.md
pr-workflow.md
progressive-disclosure-research.md
recognizing-learnings.md
validation-criteria.md
scripts/
init_skill.py
package_skill.py
quick_validate.py

详细介绍

技能开发

创建有效技能并将其贡献到公共知识库的指南。

何时使用此技能

创建技能：

  • 为特定领域或工作流构建新技能
  • 改进现有技能
  • 打包技能以便分发

贡献技能：

  • 你发现了某些需要花费大量时间才能弄明白的内容
  • 现有技能说明不完整，或误导了你
  • 你反复解决同一个未记录的问题

第 1 部分：创建技能

技能结构
skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter (name, description)
│   └── Markdown instructions
└── Bundled Resources (optional)
    ├── scripts/      - Executable code
    ├── references/   - Documentation loaded as needed
    └── assets/       - Files used in output
SKILL.md 要求
---
name: skill-name
description: What this skill does. Use when [triggers]. 
---

# Skill Name

[Instructions in imperative form...]

元数据规则：

  • name：小写，使用连字符，采用动名词形式（例如，creating-skills）
  • description：以动作动词开头，以 "Use when [triggers]" 结尾
写作风格

使用祈使或不定式形式（动词开头），不要使用第二人称：

  • ✅ “要实现 X，请执行 Y”
  • ❌ “你应该执行 X”
渐进式披露

保持 SKILL.md 精简（少于 5k 个单词）。将详细内容移至 references/：

  1. 元数据（约 100 个单词）——始终处于上下文中
  2. SKILL.md 正文（少于 5k 个单词）——技能触发时加载
  3. 参考资料（不限）——按需由 Agent 加载
脚本

为以下任务提供脚本：

  • 需要反复重写
  • 要求可靠地确定性执行
  • 能节省大量令牌

第 2 部分：贡献技能

核心理念

本仓库是一个持续发展的知识库。技能必须包含能帮助许多 Agent 的通用知识，而非特定于项目的配置或个人偏好。

贡献内容
✅ 应贡献❌ 不应贡献
出现 3 次以上的模式一次性解决方案
通用 API/工具模式特定于项目的配置
经实践验证的变通方案个人偏好
现有技能中的缺失内容已在其他地方记录的内容
验证清单

贡献前，请确认：

  • 这是否能推广到你的特定情境之外？
  • 你是否多次见过这种模式？
  • 这是否解决了实际的缺失问题，而非个人偏好？
  • 这是否能帮助处理完全不同项目的 Agent？
贡献流程
  1. 识别——在工作中留意模式（时间投入、重复出现、修正）
  2. 验证——确认该模式具有通用性，而非仅适用于你的情境
  3. 创建分支——add/skill-name 或 fix/skill-name
  4. 提交 PR——提供清晰的说明，并阐述理由和证据

详细的 PR 流程请参阅 references/pr-workflow.md。

脚本

  • scripts/init_skill.py - 初始化技能目录结构
  • scripts/package_skill.py - 打包技能以便分发
  • scripts/quick_validate.py - 验证 SKILL.md 格式

参考资料

  • references/recognizing-learnings.md - 识别有价值经验的模式
  • references/validation-criteria.md - 详细的验证指南
  • references/pr-workflow.md - PR 流程和模板
  • references/contribution-examples.md - 实际贡献示例
  • references/progressive-disclosure-research.md - 关于技能组织方式的研究

评论

支持 Markdown