update-skill
修改现有的skill
When & Why to Use This Skill
The update-skill is a specialized meta-utility designed to manage and refine the lifecycle of Claude agent capabilities. It provides a structured, automated workflow for modifying existing skill definitions, allowing users to precisely update descriptions, execution logic, tool permissions, and examples while maintaining the structural integrity of the skill's YAML frontmatter.
Use Cases
- Iterative Skill Refinement: Easily update the instructions or logic of an existing skill based on performance feedback to improve agent accuracy.
- Tooling Configuration Management: Modify the 'allowed-tools' list for specific skills as new capabilities are integrated or security requirements change.
- Documentation Maintenance: Keep skill descriptions and metadata up to date to ensure the agent correctly identifies and utilizes the right skill for specific tasks.
- Example Optimization: Update or expand the 'Examples' section within a skill to provide better few-shot guidance for the AI, enhancing its contextual understanding.
| name | update-skill |
|---|---|
| description | 修改现有的skill |
| allowed-tools | Read, Edit, Glob |
更新Skill
目的
修改现有skill的内容。
执行逻辑
1. 列出所有skills
- 查找
.claude/skills/目录 - 列出所有skill（编号列表）
- 询问："要更新哪个skill？"
2. 询问修改内容
询问："你想修改什么？" 选项：
- 描述
- 说明/指令
- 工具列表
- 示例
- 其他
3. 执行修改
根据用户选择，使用Edit工具进行精确修改：
- 保持YAML frontmatter完整
- 仅修改指定部分
- 不改变其他内容
4. 基本验证
检查：
- YAML frontmatter完整（--- 开始和结束）
- 必需字段存在
成功输出
✅ Skill已更新: {skill-name}
📁 位置: ./.claude/skills/{skill-name}/SKILL.md
错误处理
- 未找到 .claude/ → 提示先创建skill
- YAML格式错误 → 报告具体问题
- 无写入权限 → 报告错误
示例
用户: "更新reddit-upvote skill"
执行流程:
- 列出skills:
- reddit-upvote
- reddit-comment
- 用户选择: 1
- 询问修改内容 → "描述"
- 询问新描述 → "Upvote Reddit posts and comments"
- 使用Edit工具更新描述字段
- 输出成功消息