文档

创建技能

技能只是一个带有 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. 1 将技能推送到公开的 GitHub 仓库。
  2. 2 前往提交页面,输入仓库 URL。
  3. 3 Claude API 对技能进行安全和质量分析。
  4. 4 审核通过后,几分钟内即可出现在目录中。

安全分析

每个提交的技能都会由 Claude 检查提示注入、未经授权的文件访问和数据外泄模式。标记为危险的技能将由管理员审核。保持技能专注于知识而非代码执行或外部请求,可确保顺利通过审核。