Skill CreatorSAFE

NekroAgent 是一个面向多人互动场景的跨平台 Agent 框架,集 Claude Code 沙盒执行、工作区编排、长期记忆、结构化 MCP 管理与可视化控制台于一体,兼具高扩展性、多模态交互、实时状态推送和自动化运行能力。项目支持 QQ、Discord、Telegram、Minecraft、BilibiliLive、WeChat、Email、SSE(SDK) 等多种平台接入,应用于构建高智能聊天机器人,可扩展为具备代码执行、工具调用、插件协作和复杂任务处理能力的通用 Agent 系统

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: skill-creator
description: 创建新的 Claude Code 技能,修改和优化已有技能。当用户想从头创建技能、将当前工作流封装为技能、优化已有技能的内容或触发描述时使用此技能。即使用户没有明确说"技能",当他们想把某个重复工作流程固定下来时也应使用。
allowed-tools: Read,Write,Bash
---

# 技能创建器

帮助用户创建、修改和优化 Claude Code 技能。

## 核心流程

1. 理解用户意图(想让技能做什么、何时触发、期望输出)
2. 编写符合规范的 SKILL.md
3. 保存到 `~/.claude/skills/<skill-name>/` 目录
4. 验证技能可被正确解析

按用户的实际需求灵活执行——可以跳过不需要的步骤。

---

## SKILL.md 格式规范(必须严格遵守)

### Frontmatter 格式

SKILL.md 必须以 YAML frontmatter 开头。frontmatter 用 `---` 行包裹,首行必须是 `---`,不能有前导空行或空格。

```
---
name: my-skill-name
description: 技能功能描述,以及何时应当调用此技能
allowed-tools: Read,Write,Bash
---
```

**严格要求**:

- 第一行必须是 `---`(三个连字符,无前导空格)
- 最后一行必须是 `---`(独立一行)
- 每个字段占一行,格式为 `key: value`
- 冒号后必须有一个空格
- 值中不要使用引号包裹,除非值本身包含特殊字符
- frontmatter 与正文之间应有一个空行

### 必填字段

| 字段 | 要求 | 说明 |
|------|------|------|
| `name` | **必填** | 技能标识符。仅限小写字母、数字和连字符,最长 64 字符。不能以连字符开头或结尾。示例:`code-reviewer`、`api-client-gen` |
| `description` | **必填** | 技能做什么 + 何时触发。最长 1024 字符。这是自动触发的唯一判断依据,必须写清楚触发场景 |

### 可选字段

| 字段 | 说明 |
|------|------|
| `allowed-tools` | 技能激活时允许使用的工具列表,逗号分隔。常用:`Read`、`Write`、`Bash`、`Edit`、`Grep`、`Glob` |
| `version` | 版本号,如 `1.0.0` |

### name 字段规则

合法:`code-reviewer`、`api-gen`、`my-skill-2`
非法:`Code_Reviewer`(大写和下划线)、`-my-skill`(连字符开头)、`my skill`(空格)

### description 字段写法指南

description 是技能能否被正确触发的关键。遵循以下原则:

1. **先说做什么,再说何时用**:`生成 API 客户端代码。当用户需要根据 OpenAPI/Swagger 规范生成 HTTP 客户端、REST API 封装、或类型定义时使用。`

2. **包含用户可能使用的关键词**:把用户自然语言中会用到的词写进去,即使不是技术术语。

3. **适度"主动"**:Claude 倾向于不触发技能,所以 description 应该稍微宽泛一些。例如,不要只写 `处理 PDF 文件`,而应写 `处理 PDF 文件。当用户提到 PDF、文档转换、表格提取、文件合并、表单填写,或需要处理任何扫描文档时都应使用此技能。`

4. **不要在 description 中写使用说明**:description 仅用于触发判断,具体指令放在正文中。

---

## 正文编写原则

### 用祈使句,解释原因而非堆砌规则

不好:`你必须始终使用 TypeScript。绝对不允许使用 JavaScript。`
好:`使用 TypeScript 编写,因为项目需要类型安全来减少运行时错误。`

### 保持简洁,仅写 Claude 不知道的内容

Claude 已经知道如何编程、如何使用工具。不需要解释基础概念,只需要写:
- 项目特有的约定和模式
- 需要遵循的特定工作流程
- 预期的输出格式(如有要求)

### 输出格式用模板定义

如果技能有固定的输出格式,提供明确的模板:

```markdown
## 输出格式
生成的报告必须使用以下结构:
# [标题]
## 摘要
## 发现
## 建议
```

### 控制在 500 行以内

SKILL.md 正文应控制在 500 行以内。超过时,将详细内容拆分到附属文件。

---

## 多文件技能结构

复杂技能应拆分为多个文件:

```
my-skill/
├── SKILL.md           # 主文件(核心指令,保持简洁)
├── reference.md       # 参考文档(按需加载)
├── examples.md        # 示例(按需加载)
└── scripts/
    └── helper.py      # 可执行脚本(直接运行,无需加载到上下文)
```

在 SKILL.md 中明确引用附属文件,告诉 Claude 什么时候该读取它们:

```markdown
## 参考资料
- 完整 API 文档见 [reference.md](reference.md)
- 使用示例见 [examples.md](examples.md)
```

---

## 平台元数据边界

只创建和修改 skill 内容文件,例如 `SKILL.md`、`install.md`、`reference.md`、`scripts/`。

不要手动编造或维护平台级来源元数据,例如:
- `.skill-origin.json`
- 市场/社区 skill ID
- 发布者身份
- 工作区实例 ID

这些信息应由上层平台在保存、扫描、晋升或发布时自动补齐。

---

## 完整示例

### 示例 1:简单技能

```
---
name: commit-message
description: 生成规范的 Git 提交信息。当用户完成代码修改想要提交、需要写 commit message、或提到 conventional commits 时使用。
allowed-tools: Read,Bash
---

根据暂存区的变更生成提交信息。

## 流程

1. 运行 `git diff --cached --stat` 查看变更概览
2. 运行 `git diff --cached` 查看具体变更
3. 分析变更的性质(新功能、修复、重构等)
4. 生成符合 Conventional Commits 格式的提交信息

## 提交信息格式

类型(范围): 简要描述

- feat: 新功能
- fix: 修复
- refactor: 重构
- docs: 文档
- test: 测试
- chore: 构建/工具

范围是可选的,用于标识影响的模块。描述用祈使语气,不超过 72 字符。
```

### 示例 2:多文件技能

主文件 `SKILL.md`:
```
---
name: api-client-gen
description: 根据 OpenAPI 规范生成类型安全的 API 客户端代码。当用户需要生成 HTTP 客户端、REST API 封装、SDK、或从 Swagger/OpenAPI 文档创建类型定义时使用。
allowed-tools: Read,Write,Bash
---

根据 OpenAPI/Swagger 规范生成类型安全的 API 客户端。

## 流程

1. 读取用户提供的 OpenAPI 规范文件
2. 分析 endpoints、schemas 和认证方式
3. 根据目标语言生成客户端代码
4. 包含类型定义、错误处理和认证逻辑

## 支持的语言

根据项目上下文自动检测,或由用户指定。
参考各语言的具体模板见 [reference.md](reference.md)。
```

---

## 保存位置

将技能保存到 `~/.claude/skills/<skill-name>/` 目录:

```bash
mkdir -p ~/.claude/skills/my-skill-name
```

workspace 本地技能在会话之间持久保存,创建后即可被 Claude Code 发现。

## 创建后验证

技能创建完成后,读取生成的 SKILL.md 并验证:
1. 第一行是否为 `---`
2. frontmatter 中是否包含 `name` 和 `description` 字段
3. name 是否符合命名规则(小写字母、数字、连字符)
4. description 是否清晰描述了功能和触发场景
5. 第二个 `---` 是否独立成行
6. frontmatter 之后是否有正文内容

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.