> ## 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.