Back to Details

skill-development

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Development Rules

Skill开发规则

When working with files in 
.claude/skills/
:
在处理
.claude/skills/
目录下的文件时：

SKILL.md Structure

SKILL.md 结构

yaml
undefined
yaml
undefined

DO

应当遵循

  • Keep SKILL.md concise (< 200 lines)
  • Include clear "When to Use" section
  • Provide copy-paste bash commands
  • Reference scripts/ for MCP operations
  • Add triggers to skill-rules.json
  • 保持SKILL.md简洁（不超过200行）
  • 包含清晰的“适用场景”章节
  • 提供可直接复制粘贴的bash命令
  • 引用scripts/目录下的文件用于MCP操作
  • 向skill-rules.json中添加触发规则

DON'T

应当避免

  • Include implementation details in SKILL.md
  • Duplicate content across skills
  • Create skills without corresponding trigger in skill-rules.json
  • Use allowed-tools that aren't needed
  • 在SKILL.md中包含实现细节
  • 在不同Skill中重复内容
  • 创建未在skill-rules.json中配置对应触发规则的Skill
  • 使用不必要的allowed-tools

MCP Wrapper Skills

MCP包装类Skill

For skills that wrap MCP scripts:
  • Use 
    allowed-tools: [Bash, Read]
    to restrict capabilities
  • Point to the script in scripts/ directory
  • Include parameter documentation
对于封装MCP脚本的Skill：
  • 使用
    allowed-tools: [Bash, Read]
    来限制功能权限
  • 指向scripts/目录下的脚本文件
  • 包含参数说明