{"id":"4d03c819-aae2-4b9b-b25f-60c7a8842aed","shortId":"fgVPsw","kind":"skill","title":"compound-docs","tagline":">-","description":"# compound-docs\n\n## Process\n\nSingle-file architecture -- one markdown file per problem in its symptom category directory (e.g., `docs/solutions/performance-issues/n-plus-one-briefs.md`), with YAML frontmatter for metadata.\n\nFollow the 7-step documentation capture process. For full details, see [documentation-process.md](./references/documentation-process.md).\n\n1. **Detect confirmation** -- Auto-invoke after \"that worked\", \"it's fixed\", etc. Skip trivial fixes.\n2. **Gather context** -- Extract module, symptom, investigation attempts, root cause, solution, prevention. BLOCK if critical context missing.\n3. **Check existing docs** -- Search `docs/solutions/` for similar issues. If found, offer: new doc with cross-reference, update existing, or other.\n4. **Generate filename** -- Format: `[sanitized-symptom]-[module]-[YYYYMMDD].md`\n5. **Validate YAML** -- Run [validate-frontmatter.sh](./scripts/validate-frontmatter.sh) against the file. If invalid, fix the frontmatter and re-run until it passes.\n6. **Create documentation** -- Write file to `docs/solutions/[category]/[filename].md` using [resolution-template.md](./assets/resolution-template.md).\n7. **Cross-reference** -- Link related issues. Detect critical patterns (3+ similar issues).\n\n---\n\n## Decision Menu\n\nAfter successful documentation, present and WAIT for user response:\n\n```\nSolution documented\n\nFile created:\n- docs/solutions/[category]/[filename].md\n\nWhat's next?\n1. Continue workflow (recommended)\n2. Add to Required Reading - Promote to critical patterns\n3. Link related issues - Connect to similar problems\n4. Add to existing skill - Add to a learning skill\n5. Create new skill - Extract into new learning skill\n6. View documentation - See what was captured\n7. Other\n```\n\nFor detailed response handling, see [documentation-process.md](./references/documentation-process.md).\n\n---\n\n## Success Criteria\n\n- YAML frontmatter validated (all required fields, correct formats)\n- File created in `docs/solutions/[category]/[filename].md`\n- Enum values match schema exactly\n- Code examples included in solution section\n- Cross-references added if related issues found\n- User presented with decision menu and action confirmed\n\n---\n\n## References\n\n- [documentation-process.md](./references/documentation-process.md) - Full 7-step process with validation gates\n- [yaml-schema.md](./references/yaml-schema.md) - YAML frontmatter schema and enum values\n- [quality-guidelines.md](./references/quality-guidelines.md) - Quality standards, execution rules, error handling\n- [example-scenario.md](./references/example-scenario.md) - Complete walkthrough of documenting an N+1 query fix\n- [resolution-template.md](./assets/resolution-template.md) - Template for documentation files\n- [critical-pattern-template.md](./assets/critical-pattern-template.md) - Template for critical pattern entries\n- [validate-frontmatter.sh](./scripts/validate-frontmatter.sh) - Validate YAML frontmatter against schema\n\n## Integration\n\n- `/ia-compound-refresh` command -- reviews `docs/solutions/` for stale learnings","tags":["compound","docs","skills","iliaal","agent-skills","ai-coding-assistant","ai-tools","claude-code"],"capabilities":["skill","source-iliaal","skill-compound-docs","topic-agent-skills","topic-ai-coding-assistant","topic-ai-tools","topic-claude-code","topic-skills"],"categories":["ai-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/iliaal/ai-skills/compound-docs","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add iliaal/ai-skills","source_repo":"https://github.com/iliaal/ai-skills","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 13 github stars · SKILL.md body (3,055 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-05-18T19:07:01.819Z","embedding":null,"createdAt":"2026-05-09T01:05:34.788Z","updatedAt":"2026-05-18T19:07:01.819Z","lastSeenAt":"2026-05-18T19:07:01.819Z","tsv":"'+1':310 '/assets/critical-pattern-template.md':320 '/assets/resolution-template.md':140,314 '/ia-compound-refresh':334 '/references/documentation-process.md':41,231,278 '/references/example-scenario.md':303 '/references/quality-guidelines.md':295 '/references/yaml-schema.md':287 '/scripts/validate-frontmatter.sh':112,327 '1':42,176 '2':58,180 '3':75,151,189 '4':97,197 '5':107,207 '6':128,216 '7':31,141,223,280 'action':274 'ad':263 'add':181,198,202 'architectur':11 'attempt':65 'auto':46 'auto-invok':45 'block':70 'captur':34,222 'categori':20,135,170,246 'caus':67 'check':76 'code':254 'command':335 'complet':304 'compound':2,5 'compound-doc':1,4 'confirm':44,275 'connect':193 'context':60,73 'continu':177 'correct':240 'creat':129,168,208,243 'criteria':233 'critic':72,149,187,323 'critical-pattern-template.md':319 'cross':91,143,261 'cross-refer':90,142,260 'decis':154,271 'detail':38,226 'detect':43,148 'directori':21 'doc':3,6,78,88 'docs/solutions':80,134,169,245,337 'docs/solutions/performance-issues/n-plus-one-briefs.md':23 'document':33,130,158,166,218,307,317 'documentation-process.md':40,230,277 'e.g':22 'entri':325 'enum':249,292 'error':300 'etc':54 'exact':253 'exampl':255 'example-scenario.md':302 'execut':298 'exist':77,94,200 'extract':61,211 'field':239 'file':10,14,115,132,167,242,318 'filenam':99,136,171,247 'fix':53,57,118,312 'follow':29 'format':100,241 'found':85,267 'frontmatt':26,120,235,289,330 'full':37,279 'gate':285 'gather':59 'generat':98 'handl':228,301 'includ':256 'integr':333 'invalid':117 'investig':64 'invok':47 'issu':83,147,153,192,266 'learn':205,214,340 'link':145,190 'markdown':13 'match':251 'md':106,137,172,248 'menu':155,272 'metadata':28 'miss':74 'modul':62,104 'n':309 'new':87,209,213 'next':175 'offer':86 'one':12 'pass':127 'pattern':150,188,324 'per':15 'present':159,269 'prevent':69 'problem':16,196 'process':7,35,282 'promot':185 'qualiti':296 'quality-guidelines.md':294 'queri':311 're':123 're-run':122 'read':184 'recommend':179 'refer':92,144,262,276 'relat':146,191,265 'requir':183,238 'resolution-template.md':139,313 'respons':164,227 'review':336 'root':66 'rule':299 'run':110,124 'sanit':102 'sanitized-symptom':101 'schema':252,290,332 'search':79 'section':259 'see':39,219,229 'similar':82,152,195 'singl':9 'single-fil':8 'skill':201,206,210,215 'skill-compound-docs' 'skip':55 'solut':68,165,258 'source-iliaal' 'stale':339 'standard':297 'step':32,281 'success':157,232 'symptom':19,63,103 'templat':315,321 'topic-agent-skills' 'topic-ai-coding-assistant' 'topic-ai-tools' 'topic-claude-code' 'topic-skills' 'trivial':56 'updat':93 'use':138 'user':163,268 'valid':108,236,284,328 'validate-frontmatter.sh':111,326 'valu':250,293 'view':217 'wait':161 'walkthrough':305 'work':50 'workflow':178 'write':131 'yaml':25,109,234,288,329 'yaml-schema.md':286 'yyyymmdd':105","prices":[{"id":"af47cec7-3148-4818-a0ba-58a21b2768c7","listingId":"4d03c819-aae2-4b9b-b25f-60c7a8842aed","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"iliaal","category":"ai-skills","install_from":"skills.sh"},"createdAt":"2026-05-09T01:05:34.788Z"}],"sources":[{"listingId":"4d03c819-aae2-4b9b-b25f-60c7a8842aed","source":"github","sourceId":"iliaal/ai-skills/compound-docs","sourceUrl":"https://github.com/iliaal/ai-skills/tree/master/skills/compound-docs","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:34.788Z","lastSeenAt":"2026-05-18T19:07:01.819Z"}],"details":{"listingId":"4d03c819-aae2-4b9b-b25f-60c7a8842aed","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"iliaal","slug":"compound-docs","github":{"repo":"iliaal/ai-skills","stars":13,"topics":["agent-skills","ai-coding-assistant","ai-tools","claude-code","skills"],"license":"mit","html_url":"https://github.com/iliaal/ai-skills","pushed_at":"2026-05-16T13:15:17Z","description":"Curated collection of agent skills for AI coding assistants.","skill_md_sha":"9bb8c674faf57547654e7ff384506e8f77e46b51","skill_md_path":"skills/compound-docs/SKILL.md","default_branch":"master","skill_tree_url":"https://github.com/iliaal/ai-skills/tree/master/skills/compound-docs"},"layout":"multi","source":"github","category":"ai-skills","frontmatter":{"name":"compound-docs","description":">-"},"skills_sh_url":"https://skills.sh/iliaal/ai-skills/compound-docs"},"updatedAt":"2026-05-18T19:07:01.819Z"}}