{"id":"c4a53f06-f1cc-4d14-a9aa-2745ed1c794e","shortId":"QApnQ6","kind":"skill","title":"writing-skills","tagline":"Use when creating, updating, or improving agent skills.","description":"# Writing Skills (Excellence)\n\nDispatcher for skill creation excellence. Use the decision tree below to find the right template and standards.\n\n## ⚡ Quick Decision Tree\n\n### What do you need to do?\n\n1. **Create a NEW skill:**\n   - Is it simple (single file, <200 lines)? → [Tier 1 Architecture](references/tier-1-simple/README.md)\n   - Is it complex (multi-concept, 200-1000 lines)? → [Tier 2 Architecture](references/tier-2-expanded/README.md)\n   - Is it a massive platform (10+ products, AWS, Convex)? → [Tier 3 Architecture](references/tier-3-platform/README.md)\n\n2. **Improve an EXISTING skill:**\n   - Fix \"it's too long\" -> [Modularize (Tier 3)](references/templates/tier-3-platform.md)\n   - Fix \"AI ignores rules\" -> [Anti-Rationalization](references/anti-rationalization/README.md)\n   - Fix \"users can't find it\" -> [CSO (Search Optimization)](references/cso/README.md)\n\n3. **Verify Compliance:**\n   - Check metadata/naming -> [Standards](references/standards/README.md)\n   - Add tests -> [Testing Guide](references/testing/README.md)\n\n## 📚 Component Index\n\n| Component | Purpose |\n|-----------|---------|\n| **[CSO](references/cso/README.md)** | \"SEO for LLMs\". How to write descriptions that trigger. |\n| **[Standards](references/standards/README.md)** | File naming, YAML frontmatter, directory structure. |\n| **[Anti-Rationalization](references/anti-rationalization/README.md)**| How to write rules that agents won't ignore. |\n| **[Testing](references/testing/README.md)** | How to ensure your skill actually works. |\n\n## 🛠️ Templates\n\n- [Technique Skill](references/templates/technique.md) (How-to)\n- [Reference Skill](references/templates/reference.md) (Docs)\n- [Discipline Skill](references/templates/discipline.md) (Rules)\n- [Pattern Skill](references/templates/pattern.md) (Design Patterns)\n\n## When to Use\n- Creating a NEW skill from scratch\n- Improving an EXISTING skill that agents ignore\n- Debugging why a skill isn't being triggered\n- Standardizing skills across a team\n\n## How It Works\n\n1. **Identify goal** → Use decision tree above\n2. **Select template** → From `references/templates/`\n3. **Apply CSO** → Optimize description for discovery\n4. **Add anti-rationalization** → For discipline skills\n5. **Test** → RED-GREEN-REFACTOR cycle\n\n## Quick Example\n\n```yaml\n---\nname: my-technique\ndescription: Use when [specific symptom occurs].\nmetadata:\n  category: technique\n  triggers: error-text, symptom, tool-name\n---\n\n# My Technique\n\n## When to Use\n- [Symptom A]\n- [Error message]\n```\n\n## Common Mistakes\n\n| Mistake | Fix |\n|---------|-----|\n| Description summarizes workflow | Use \"Use when...\" triggers only |\n| No `metadata.triggers` | Add 3+ keywords |\n| Generic name (\"helper\") | Use gerund (`creating-skills`) |\n| Long monolithic SKILL.md | Split into `references/` |\n\nSee [gotchas.md](gotchas.md) for more.\n\n## ✅ Pre-Deploy Checklist\n\nBefore deploying any skill:\n\n- [ ] `name` field matches directory name exactly\n- [ ] `SKILL.md` filename is ALL CAPS\n- [ ] Description starts with \"Use when...\"\n- [ ] `metadata.triggers` has 3+ keywords\n- [ ] Total lines < 500 (use `references/` for more)\n- [ ] No `@` force-loading in cross-references\n- [ ] Tested with real scenarios\n\n## 🔗 Related Skills\n\n- **opencode-expert**: For OpenCode environment configuration\n- Use `/write-skill` command for guided skill creation\n\n## Examples\n\n**Create a Tier 1 skill:**\n```bash\nmkdir -p ~/.config/opencode/skills/my-technique\ntouch ~/.config/opencode/skills/my-technique/SKILL.md\n```\n\n**Create a Tier 2 skill:**\n```bash\nmkdir -p ~/.config/opencode/skills/my-skill/references/core\ntouch ~/.config/opencode/skills/my-skill/{SKILL.md,gotchas.md}\ntouch ~/.config/opencode/skills/my-skill/references/core/README.md\n```\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["writing","skills","antigravity","awesome","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity-skills"],"capabilities":["skill","source-sickn33","skill-writing-skills","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/writing-skills","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34404 github stars · SKILL.md body (4,042 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T00:52:00.464Z","embedding":null,"createdAt":"2026-04-18T21:47:48.156Z","updatedAt":"2026-04-22T00:52:00.464Z","lastSeenAt":"2026-04-22T00:52:00.464Z","tsv":"'-1000':64 '/.config/opencode/skills/my-skill':412 '/.config/opencode/skills/my-skill/references/core':410 '/.config/opencode/skills/my-skill/references/core/readme.md':416 '/.config/opencode/skills/my-technique':399 '/.config/opencode/skills/my-technique/skill.md':401 '/write-skill':384 '1':41,54,224,394 '10':75 '2':67,83,231,405 '200':51,63 '3':80,95,115,236,306,353 '4':243 '5':251 '500':357 'across':218 'actual':170 'add':122,244,305 'agent':10,159,206 'ai':98 'anti':102,151,246 'anti-ration':101,150,245 'appli':237 'architectur':55,68,81 'ask':450 'aw':77 'bash':396,407 'boundari':458 'cap':345 'categori':272 'check':118 'checklist':330 'clarif':452 'clear':425 'command':385 'common':291 'complex':59 'complianc':117 'compon':127,129 'concept':62 'configur':382 'convex':78 'creat':6,42,195,314,391,402 'creating-skil':313 'creation':18,389 'criteria':461 'cross':368 'cross-refer':367 'cso':111,131,238 'cycl':257 'debug':208 'decis':22,33,228 'deploy':329,332 'describ':429 'descript':139,240,265,295,346 'design':190 'directori':148,338 'disciplin':183,249 'discoveri':242 'dispatch':15 'doc':182 'ensur':167 'environ':381,441 'environment-specif':440 'error':276,289 'error-text':275 'exact':340 'exampl':259,390 'excel':14,19 'exist':86,203 'expert':378,446 'field':336 'file':50,144 'filenam':342 'find':26,109 'fix':88,97,105,294 'forc':364 'force-load':363 'frontmatt':147 'generic':308 'gerund':312 'goal':226 'gotchas.md':323,324,414 'green':255 'guid':125,387 'helper':310 'how-to':176 'identifi':225 'ignor':99,162,207 'improv':9,84,201 'index':128 'input':455 'isn':212 'keyword':307,354 'limit':417 'line':52,65,356 'llms':135 'load':365 'long':92,316 'massiv':73 'match':337,426 'messag':290 'metadata':271 'metadata.triggers':304,351 'metadata/naming':119 'miss':463 'mistak':292,293 'mkdir':397,408 'modular':93 'monolith':317 'multi':61 'multi-concept':60 'my-techniqu':262 'name':145,261,281,309,335,339 'need':38 'new':44,197 'occur':270 'opencod':377,380 'opencode-expert':376 'optim':113,239 'output':435 'p':398,409 'pattern':187,191 'permiss':456 'platform':74 'pre':328 'pre-deploy':327 'product':76 'purpos':130 'quick':32,258 'ration':103,152,247 'real':372 'red':254 'red-green-refactor':253 'refactor':256 'refer':179,321,359,369 'references/anti-rationalization/readme.md':104,153 'references/cso/readme.md':114,132 'references/standards/readme.md':121,143 'references/templates':235 'references/templates/discipline.md':185 'references/templates/pattern.md':189 'references/templates/reference.md':181 'references/templates/technique.md':175 'references/templates/tier-3-platform.md':96 'references/testing/readme.md':126,164 'references/tier-1-simple/readme.md':56 'references/tier-2-expanded/readme.md':69 'references/tier-3-platform/readme.md':82 'relat':374 'requir':454 'review':447 'right':28 'rule':100,157,186 'safeti':457 'scenario':373 'scope':428 'scratch':200 'search':112 'see':322 'select':232 'seo':133 'simpl':48 'singl':49 'skill':3,11,13,17,45,87,169,174,180,184,188,198,204,211,217,250,315,334,375,388,395,406,420 'skill-writing-skills' 'skill.md':318,341,413 'source-sickn33' 'specif':268,442 'split':319 'standard':31,120,142,216 'start':347 'stop':448 'structur':149 'substitut':438 'success':460 'summar':296 'symptom':269,278,287 'task':424 'team':220 'techniqu':173,264,273,283 'templat':29,172,233 'test':123,124,163,252,370,444 'text':277 'tier':53,66,79,94,393,404 'tool':280 'tool-nam':279 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'total':355 'touch':400,411,415 'treat':433 'tree':23,34,229 'trigger':141,215,274,301 'updat':7 'use':4,20,194,227,266,286,298,299,311,349,358,383,418 'user':106 'valid':443 'verifi':116 'won':160 'work':171,223 'workflow':297 'write':2,12,138,156 'writing-skil':1 'yaml':146,260","prices":[{"id":"7e9768b4-237e-41d8-ba07-3ed8ab826042","listingId":"c4a53f06-f1cc-4d14-a9aa-2745ed1c794e","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:47:48.156Z"}],"sources":[{"listingId":"c4a53f06-f1cc-4d14-a9aa-2745ed1c794e","source":"github","sourceId":"sickn33/antigravity-awesome-skills/writing-skills","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/writing-skills","isPrimary":false,"firstSeenAt":"2026-04-18T21:47:48.156Z","lastSeenAt":"2026-04-22T00:52:00.464Z"}],"details":{"listingId":"c4a53f06-f1cc-4d14-a9aa-2745ed1c794e","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"writing-skills","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34404,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-21T16:43:40Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"c4ed2443081958fa2dced11c272337490ad76fba","skill_md_path":"skills/writing-skills/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/writing-skills"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"writing-skills","description":"Use when creating, updating, or improving agent skills."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/writing-skills"},"updatedAt":"2026-04-22T00:52:00.464Z"}}