84 lines
2.8 KiB
Markdown
84 lines
2.8 KiB
Markdown
---
|
|
name: ck-skill-creator
|
|
description: Create or update Antigravity-format skills. Use for new skills, skill references, skill scripts, optimizing existing skills, and extending capabilities with SKILL.md, references/, and scripts/.
|
|
---
|
|
|
|
# Skill Creator (Antigravity Format)
|
|
|
|
Guidance for creating effective skills in Antigravity format.
|
|
|
|
## When to Use
|
|
|
|
- Creating a new skill from scratch
|
|
- Updating or optimizing an existing skill
|
|
- Adding reference files or scripts to a skill
|
|
- Converting skills from other formats to Antigravity
|
|
|
|
## Don't Use When
|
|
|
|
- Task is better handled by writing a one-off script (not reused)
|
|
- Knowledge is project-specific and not reusable across projects
|
|
|
|
## Antigravity Skill Format
|
|
|
|
### SKILL.md Structure
|
|
|
|
```
|
|
skills/
|
|
└── skill-name/
|
|
├── SKILL.md # Required: frontmatter + instructions
|
|
├── references/ # Markdown docs loaded as needed
|
|
├── scripts/ # Executable code (Node/Python)
|
|
└── assets/ # Templates, images, fonts
|
|
```
|
|
|
|
### Frontmatter Rules (CRITICAL)
|
|
|
|
```yaml
|
|
---
|
|
name: ck-skill-name # ck- prefix, colons → hyphens
|
|
description: > # ≥3 trigger phrases, under 200 chars
|
|
What it does. Use for X, Y, Z. Triggers on A, B, C tasks.
|
|
---
|
|
```
|
|
|
|
- **ONLY** `name` and `description` in frontmatter — no version, license, model
|
|
- Add `ck-` prefix to all skill names
|
|
- Replace `:` in names with `-` (e.g., `plan:fast` → `ck-plan-fast`)
|
|
|
|
### SKILL.md Body Rules
|
|
|
|
- Under 200 lines
|
|
- Must include **"Don't Use When"** section
|
|
- Description must contain ≥3 trigger phrases
|
|
- Replace CK tool names (Task tool, AskUserQuestion) with generic prose
|
|
- Use imperative/verb-first instructions throughout
|
|
|
|
## Creation Process
|
|
|
|
1. **Understand the skill** — what tasks trigger it, what knowledge it provides
|
|
2. **Write SKILL.md** — frontmatter + core instructions under 200 lines
|
|
3. **Add references/** — detailed docs split into <150 line files each
|
|
4. **Add scripts/** — reusable executable code with tests
|
|
5. **Validate** — check description has ≥3 triggers, "Don't Use When" exists, under 200 lines
|
|
|
|
## Progressive Disclosure
|
|
|
|
Three-level loading system:
|
|
1. **Description** (always in context) — triggers activation
|
|
2. **SKILL.md body** (when triggered) — core instructions
|
|
3. **references/ and scripts/** (loaded as needed) — detailed knowledge
|
|
|
|
Keep SKILL.md lean. Move detailed examples, schemas, and API docs to `references/`.
|
|
|
|
## Quality Checklist
|
|
|
|
- [ ] Frontmatter has only `name` + `description`
|
|
- [ ] Name has `ck-` prefix
|
|
- [ ] Description ≥3 trigger phrases, under 200 chars
|
|
- [ ] "Don't Use When" section present
|
|
- [ ] SKILL.md under 200 lines
|
|
- [ ] No CK-specific tool names (use generic prose)
|
|
- [ ] Reference files each under 150 lines
|
|
- [ ] Scripts have tests and work cross-platform
|