Smithery is now a part of Arcade.dev! Read more in our announcement here
官方 Skill 开发指南，包含目录结构、元数据规范及构建流程。仅用于指导开发者创建新 Skill。
本指南用于回答三个问题：
每个 Skill 目录必须包含 SKILL.md，文件头使用 YAML frontmatter，最小只需要两个字段：
---
name: your-skill-name
description: WHAT + WHEN（做什么 + 何时触发）
---
约束：
name 必填，建议小写连字符，如 weather-fetcherdescription 必填，必须写清楚 WHAT 和 WHENname、description）正文只写 How（怎么做）：
references/，正文只保留入口和选择规则scripts/assets/Aurora 会递归扫描 skills/：
SKILL.mdSKILL_<language>.md（如 SKILL_en.md）SKILL.md推荐结构：
skill-name/
├── SKILL.md
├── SKILL_en.md # 可选
├── scripts/ # 可选
├── references/ # 可选
└── assets/ # 可选
官方最小只要求 name + description。Aurora 额外支持以下字段：
enabled: true|falselocked: true|falsefor_ai: true|falseplatforms: [all|desktop|mobile|windows|macos|linux|android|ios]id: custom_id（不填时默认目录名）tools: [...]（工具定义）worker_mode: reasoner|executor（Skill Worker 执行模式）与 turns 相关的 Aurora 扩展字段：
skill_max_turnsskillMaxTurns、worker_max_turns、workerMaxTurns、subagent_max_turns、subagentMaxTurns、_aurora_skill_max_turns、max_turns、maxTurns说明：skill_max_turns 是 Aurora 项目扩展，不是官方必需 frontmatter 字段。
worker_mode 说明：
reasoner（默认）：Worker 可多轮推理与工具调用executor：Worker 在拿到首个工具输出后直接返回结果，不在 Worker 内做二次收尾兼容别名（模式字段）：
workerModeskill_worker_modeskillWorkerModesubagent_modesubagentMode_aurora_worker_mode_aurora_skill_worker_mode键名（按读取顺序）：
orchestrator_max_turnsorchestratorMaxTurns_aurora_max_turnsmax_turnsmaxTurns来源与顺序：
customParametersglobalSettings默认值与范围：
81..50键名（按读取顺序）：
skill_max_turnsskillMaxTurnsworker_max_turnsworkerMaxTurnssubagent_max_turnssubagentMaxTurns_aurora_skill_max_turnsmax_turnsmaxTurns来源与顺序：
customParametersglobalSettings默认值与范围：
61..30补充：
maxTurns=8、shell timeout 45s6/1..30 规则为准在 Aurora UI：
SettingsAgent SkillsEditSKILL.md 顶部 YAML frontmatter当前桌面端主要入口是 Provider 配置的两类 Custom Parameters 卡片：
Settings -> Model Provider -> provider 区域右上齿轮（Global Config）-> Custom ParametersSettings -> Model Provider -> 模型行右侧齿轮（Model Config）-> Custom Parameters注意：
customParameters + globalSettings + skill metadatamodelSettings 自定义参数目前不参与 turns 解析（它主要用于请求参数覆盖）---
name: weather-fetcher
description: 获取指定城市实时天气。当用户询问天气、温度、降雨或风力时触发。
enabled: true
for_ai: true
platforms: [desktop]
skill_max_turns: 10
worker_mode: reasoner
---
# Weather Fetcher
## Instructions
1. 校验输入
2. 拉取数据
3. 返回结构化结果
## Examples
- Input: 上海天气
- Output: { ... }
name 与 description 已填写且语义明确description 明确写了 WHAT + WHENskill_max_turnsworker_mode: executor