> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 技能清单参考

> theo-skill.json 字段完整参考。

完整的类型化接口请参阅 [SDK defineSkill() 参考](/sdk-reference/skills)。

## 必填字段

| 字段 | 类型 | 说明 |
| - | - | - |
| `name` | `string` | 人类可读的技能名称 |
| `slug` | `string` | 唯一 ID（小写字母、连字符，不能以连字符开头或结尾） |
| `version` | `string` | 语义化版本号（例如 `1.0.0`） |
| `description` | `string` | 简短描述 |
| `category` | `SkillCategory` | 取值之一：`productivity`、`domain`、`integration`、`automation`、`creative` |
| `author` | `object` | `{ name: string, email?: string, url?: string }` |
| `systemPromptExtension` | `string` | 注入给 LLM 的领域指令 |

## 可选字段

| 字段 | 类型 | 默认值 | 说明 |
| - | - | - | - |
| `tools` | `SkillToolInput[]` | `[]` | 工具定义 |
| `permissions` | `SkillPermission[]` | `[]` | 所需权限 |
| `knowledge` | `string[]` | `[]` | 随附的知识文件路径 |
| `modelPreference` | `string` | — | 偏好的模型 ID |
| `trigger` | `SkillTriggerInput` | — | 激活触发条件 |
| `hooks` | `object` | — | `{ onInstall?, onUninstall? }` |
| `readme` | `string` | — | Markdown 格式的 README |
| `changelog` | `string` | — | Markdown 格式的变更日志 |
| `license` | `string` | `"MIT"` | 许可证标识符 |
| `repository` | `string` | — | 源代码仓库 URL |
| `keywords` | `string[]` | `[]` | 搜索关键词 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.