Claude Skills 创建指南与最佳实践
来源: ComposioHQ/awesome-claude-skills 适配: LiYe OS 三层架构
提供创建 Claude Skills 的完整指导，包括专业知识封装、工作流设计、工具集成等。
当需要创建新的 Claude 技能时：
标准目录结构：
skill-name/
├── SKILL.md # 必须：技能定义文件
├── scripts/ # 可选：辅助脚本
├── templates/ # 可选：文档模板
└── references/ # 可选：参考资料
必须包含的 Frontmatter：
---
name: skill-name
description: 清晰描述技能功能
domain: 所属域
version: 1.0.0
status: active | draft | deprecated
---
必须包含的章节：
在 LiYe OS 中创建技能需要考虑三层架构：
L1 方法论层 (docs/methodology/):
# skill_definition.md - 10 模块结构
1. Skill Identity
2. Capability Model
3. Mental Models
4. Methods & SOPs
5. Execution Protocols
6. Output Structure
7. Templates
8. Tools Access
9. Evaluation
10. Evolution
L2 可执行层 (src/skill/atomic/):
// index.ts
export const skill: Skill = {
id: 'skill-name',
name: 'Skill Name',
execute: async (input) => { ... }
};
// spec.yaml
id: skill-name
type: atomic
input: { ... }
output: { ... }
L3 指令层 (.claude/skills/):
# SKILL.md - 简洁的使用指导
针对 Claude 的操作指令
用户: 帮我创建一个 Amazon 广告分析技能
Claude: [使用 skill-creator 技能设计结构、生成模板文件]
用户: 把这个 API 文档转换成 Claude 技能
Claude: [使用 skill-creator 技能提取关键信息、生成 SKILL.md]
用户: 检查这个技能是否符合规范
Claude: [使用 skill-creator 技能对照最佳实践进行评审]
无外部依赖，纯知识型技能。
此技能被以下业务域引用：
/docs/architecture/SKILL_SPEC.md/_meta/skill_template/Created: 2025-12-28 | Adapted for LiYe OS
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer