Initial commit: antigravity-claudekit

skills/ck-skill-creator/SKILL.md

@@ -0,0 +1,83 @@
+---
+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