skill-creator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill Creator

技能创建指南

Create effective Agent Skills using progressive disclosure.

使用渐进式披露机制创建高效的Agent Skills。

When to Create a Skill

何时创建技能

Create a skill when you notice:

Repeating context across conversations
Domain expertise needed repeatedly
Project-specific knowledge the agent should know automatically

当你遇到以下情况时，应该创建技能：

对话中重复出现相同上下文
反复需要领域专业知识
代理需要自动掌握项目特定知识

Progressive Disclosure

渐进式披露

Skills load in 3 levels:

Metadata (~27 tokens) - YAML frontmatter for triggering
Instructions (<680 tokens) - SKILL.md body with core patterns
Resources (unlimited) - references/ scripts/ assets/ loaded on demand

Key: Keep Levels 1 & 2 lean. Move details to Level 3.

技能分为3个层级加载：

元数据（约27个token）- 用于触发技能的YAML前置内容
说明文档（少于680个token）- SKILL.md主体部分，包含核心流程
资源文件（无限制）- 按需加载的参考文档、脚本、资源文件

关键原则：保持第1、2层级简洁，将详细内容移至第3层级。

Quick Workflow

快速工作流程

Create skill directory:
```
.aider-desk/skills/my-skill/
```
Write
```
SKILL.md
```
with YAML frontmatter (
```
name
```
,
```
description
```
) and body instructions
Add detailed docs to
```
references/
```
as needed
Verify: mention a trigger keyword — skill should appear in active skills sidebar

If skill doesn't load: check YAML syntax is valid,

name

is lowercase-hyphenated, and

description

contains the trigger terms users would say

创建技能目录：
```
.aider-desk/skills/my-skill/
```
编写
```
SKILL.md
```
文件，包含YAML前置内容（
```
name
```
、
```
description
```
）和主体说明
按需将详细文档添加至
```
references/
```
目录
验证：提及触发关键词，技能应显示在活跃技能侧边栏中

如果技能未加载：检查YAML语法是否有效，

name

是否为小写连字符格式，

description

是否包含用户会使用的触发词汇

SKILL.md Example

SKILL.md示例

yaml

---
name: deploy-helper
description: Deploy AiderDesk builds to staging and production environments. Use when deploying, releasing, or publishing builds.
---

markdown

undefined

yaml

---
name: deploy-helper
description: Deploy AiderDesk builds to staging and production environments. Use when deploying, releasing, or publishing builds.
---

markdown

undefined

Deploy Helper

Build and deploy AiderDesk to target environments.

Steps

Run
```
npm run build
```
to generate production artifacts
Verify build output exists in
```
dist/
```
Deploy to staging:
```
./scripts/deploy.sh staging
```
Verify deployment: check health endpoint returns 200

Run
```
npm run build
```
to generate production artifacts
Verify build output exists in
```
dist/
```
Deploy to staging:
```
./scripts/deploy.sh staging
```
Verify deployment: check health endpoint returns 200

Troubleshooting

Build fails: check
```
tsconfig.json
```
paths and run
```
npm run typecheck
```

Build fails: check
```
tsconfig.json
```
paths and run
```
npm run typecheck
```

References

environments.md - Environment configs

undefined

environments.md - Environment configs

undefined

Structure

目录结构

my-skill/
├── SKILL.md       # Core instructions + metadata
├── references/    # Detailed docs (loaded as needed)
├── scripts/       # Executable operations
└── assets/        # Templates, images, files

my-skill/
├── SKILL.md       # 核心说明 + 元数据
├── references/    # 详细文档（按需加载）
├── scripts/       # 可执行操作脚本
└── assets/        # 模板、图片、文件资源

References

参考资料

quick-start.md - Creating your first skill
writing-guide.md - Writing effective skills
development-process.md - Step-by-step workflow
skill-examples.md - Patterns and examples
cli-reference.md - CLI tool usage
agent-skills-resources.md - Architecture and best practices

quick-start.md - 创建首个技能的快速入门指南
writing-guide.md - 撰写高效技能的指南
development-process.md - 分步工作流程
skill-examples.md - 模式与示例
cli-reference.md - CLI工具使用参考
agent-skills-resources.md - 架构与最佳实践