创建技能
技能只是一个带有 YAML 前置内容的 Markdown 文件。如果你有值得分享的领域专业知识,就将其写入 SKILL.md。
文件结构
SKILL.md
--- name: my-skill description: One sentence shown in lazy-load preview. version: 1.0.0 author: your-github-username tags: - laravel - php - testing --- # My Skill ## Overview What this skill teaches Claude and when to apply it. ## Conventions - Always use X instead of Y - Prefer Z pattern for ABC scenarios ## Examples ```php // Your code examples here ```
前置字段
| 字段 | 必填 | 说明 |
|---|---|---|
| name | 必填 | URL 友好的标识符。 |
| description | 必填 | 一句话说明——在懒加载预览和目录列表中显示。 |
| version | 可选 | 语义版本号,例如 1.0.0。 |
| author | 可选 | 你的 GitHub 用户名。 |
| tags | 可选 | 用于搜索和筛选的标签数组。 |
内容指南
- ▸要具体。"始终使用
$query->whereNull('deleted_at')"比"使用软删除"更有用。 - ▸包含示例。代码块让说明更加明确。
- ▸说明上下文。这个技能适用于什么项目类型、框架或场景?
- ▸保持专注。一个技能 = 一个领域。不要将 Laravel + 安全 + 测试打包到一个文件中。
提交到目录
- 1 将技能推送到公开的 GitHub 仓库。
- 2 前往提交页面,输入仓库 URL。
- 3 Claude API 对技能进行安全和质量分析。
- 4 审核通过后,几分钟内即可出现在目录中。
安全分析
每个提交的技能都会由 Claude 检查提示注入、未经授权的文件访问和数据外泄模式。标记为危险的技能将由管理员审核。保持技能专注于知识而非代码执行或外部请求,可确保顺利通过审核。