技能创作
- 作者仓库星标 1,124
- 作者仓库 skillkit
- 领域
- 文档
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 98 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @rohitg00 · v1.0.0 · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
// BAD
const result = doTheThing(badInput);
// GOOD
const validated = validate(input);
const result = doTheThing(validated);
# Skill Authoring Guide
You are authoring a SKILL.md for an AI coding agent. A well-written skill provides clear, actionable guidance that agents can follow consistently.
## Core Principle
**A skill's description triggers it; the body teaches it.**
The description tells the agent WHEN to use the skill. The content tells the agent HOW to execute it.
## Skill Anatomy
### SKILL.md Structure
```markdown
---
name: [lowercase-hyphenated-name]
description: [Concrete actions + "Use when..." clause]
version: [Semantic version]
triggers:
- [keyword 1]
- [keyword 2]
tags:
- [tag 1]
---
# [Skill Title]
[Introduction paragraph explaining purpose]
## Core Principle
**[Single most important rule in bold]**
## [Main Content Sections]
## [Decision Points]
## [Verification Checklist]
```
### Frontmatter Fields
| Field | Required | Constraints |
|-------|----------|-------------|
| name | Yes | Lowercase alphanumeric + hyphens, 1–64 chars |
| description | Yes | Must include "Use when..." clause; 1–1024 chars |
| version | Yes | Semantic version (e.g. `1.0.0`) |
| triggers | Recommended | Natural-language phrases that activate the skill |
| tags | Recommended | Categorization tags |
## Writing Effective Triggers
Triggers should be phrases users naturally type.
**Good triggers:**
- "write tests first"
- "tdd"
- "test driven development"
**Bad triggers:**
- "testing methodology" (too vague)
- "red-green-refactor-cycle-for-test-driven-development" (too specific)
- "skill-123" (not natural language)
### Trigger Guidelines
1. **Natural language** — How would a human ask for this?
2. **Multiple variations** — Different ways to say the same thing
3. **Specific enough** — Don't trigger on too many queries
4. **Common terms** — Use terms people actually use
## Writing Skill Content
### Voice and Tone
Use **second person, present tense, active voice**:
- ✅ "Write the test first"
- ✅ "You are implementing TDD"
- ❌ "The developer should..." (passive)
- ❌ "It is recommended that..." (wordy)
### Structure Guidelines
1. **Start with context** — What is the agent doing and why
2. **State the core principle** — Most important rule upfront
3. **Provide process** — Step-by-step guidance
4. **Include examples** — Concrete illustrations
5. **Add a checklist** — Verification criteria
6. **End with integration** — How this connects to other skills
### Directive Language
| Strength | Examples |
|----------|----------|
| Strong (critical rules) | "You MUST…", "ALWAYS…", "NEVER…", "Do NOT…" |
| Soft (recommendations) | "Prefer…", "Consider…", "When possible…" |
## Content Patterns
### Decision Trees
```markdown
## Decision: [What to Decide]
If [condition A]:
→ [Action for A]
If [condition B]:
→ [Action for B]
If uncertain:
→ [Default action]
```
### Process Steps
```markdown
### Step 1: [Action]
[Detailed explanation]
**Verification:** [How to know step is complete]
### Step 2: [Action]
...
```
### Code Examples
```typescript
// BAD
const result = doTheThing(badInput);
// GOOD
const validated = validate(input);
const result = doTheThing(validated);
```
## Anti-Patterns to Avoid
| Anti-pattern | Problem | Fix |
|--------------|---------|-----|
| The Encyclopedia | Too much info, agent gets lost | Focus on actionable guidance only |
| The Vague Guide | "Consider best practices" | Be specific: "Use Arrange-Act-Assert" |
| The Constraint-Free Skill | No clear rules, agent improvises | Include explicit constraints |
| The Monologue | Wall of text | Use headers, lists, tables, code blocks |
| The Outdated Skill | References deprecated patterns | Version skills and review periodically |
## Skill Testing
Before publishing, verify:
1. **Trigger test** — Does it activate on expected phrases?
2. **Completeness test** — Can the agent follow it without external info?
3. **Clarity test** — Is every instruction unambiguous?
4. **Contradiction test** — No conflicting guidance?
5. **Edge case test** — Handles unusual situations?
## Pack Organization
Group related skills under a named pack directory. See `PACKS.md` for full pack manifest format and filesystem conventions.
```
packs/
├── testing/
│ ├── pack.json
│ ├── red-green-refactor/
│ │ └── SKILL.md
│ └── test-patterns/
│ └── SKILL.md
```
## Skill Maintenance
See `MAINTENANCE.md` for detailed versioning policy. Quick reference:
**Version increments:**
- **Patch (1.0.x):** Typos, clarifications, minor fixes
- **Minor (1.x.0):** New sections, examples, capabilities
- **Major (x.0.0):** Breaking changes, fundamental rewrites
**Deprecation frontmatter:**
```yaml
deprecated: true
deprecatedReason: "Superseded by skill-v2"
deprecatedSince: "2024-01-15"
```
Add a visible notice at the top of the body: `> **DEPRECATED:** Use [skill-v2] instead.`
## Publication Checklist
Before publishing, confirm:
- [ ] Frontmatter is complete and valid (name, description, version)
- [ ] Description includes concrete actions and a "Use when…" clause
- [ ] Triggers are natural-language phrases, specific but not over-fitted
- [ ] Core principle is clear and prominent
- [ ] Content uses headers, lists, or tables — no walls of text
- [ ] Code examples demonstrate correct vs. incorrect usage
- [ ] Verification criteria are included
- [ ] Related skills are linked where applicable
- [ ] No spelling/grammar errors
- [ ] Tested with target agents against all trigger phrases
章节与文件索引
按说明文件中的顺序排列。
核心原则
前沿领域
编写有效的触发器
触发指南
结构指南
文件/命令 -> 1.0.0 · PACKS.md · MAINTENANCE.md · > **DEPRECATED:** Use [skill-v2] instead.
内容校验值 -> 3ec496baa994
当前原文的自动摘译,尚未人工审校。
核心原则
技能的描述会触发它;身体教导它。描述告诉代理何时使用该技能。内容告诉代理如何执行它。
前沿领域
字段 · 必填 · 约束名称 · 是 · 小写字母数字 + 连字符,1–64 个字符描述 · 是 · 必须包含“Use when...”子句; 1–1024 个字符版本 · 是 · 语义版本(例如
1.0.0)触发器 · 推荐 · 激活技能的自然语言短语编写有效的触发器
触发器应该是用户自然输入的短语。好的触发器:“首先编写测试”“tdd”“测试驱动开发”
触发指南
自然语言——人类会如何要求这个?多种变体 — 表达同一事物的不同方式 足够具体 — 不要触发太多查询 常用术语 — 使用人们实际使用的术语
结构指南
从背景开始 — 代理在做什么以及为什么 陈述核心原则 — 预先提供最重要的规则 提供流程 — 分步指导 包括示例 — 具体插图 添加清单 — 验证标准