{"id":"6f6791ee-866c-447a-a48c-8dad65ddaef3","shortId":"mfHecF","kind":"skill","title":"capture-knowledge","tagline":"AI DevKit · Capture structured knowledge about a code entry point and save it to the knowledge docs. Use when users ask to document, understand, or map code for a module, file, folder, function, or API.","description":"# Knowledge Capture Assistant\n\nBuild structured understanding of code entry points with an analysis-first workflow.\n\n## Hard Rule\n- Do not create documentation until the entry point is validated and analysis is complete.\n\n## Workflow\n\n1. Gather & Validate\n- Confirm entry point (file, folder, function, API), purpose, and desired depth.\n- Verify it exists; resolve ambiguity or suggest alternatives if not found.\n- Search for existing knowledge before analyzing: `npx ai-devkit@latest memory search --query \"<entry point name or purpose>\"`\n\n2. Collect Source Context\n- Summarize purpose, exports, key patterns.\n- Folders: list structure, highlight key modules.\n- Functions/APIs: capture signature, parameters, return values, error handling.\n\n3. Analyze Dependencies\n- Build dependency view up to depth 3, track visited nodes to avoid loops.\n- Categorize: imports, function calls, services, external packages.\n- Exclude external systems or generated code.\n\n4. Synthesize\n- Overview (purpose, language, high-level behavior).\n- Core logic, execution flow, patterns.\n- Error handling, performance, security considerations.\n- Improvements or risks discovered during analysis.\n\n5. Create Documentation\n- Normalize name to kebab-case (`calculateTotalPrice` → `calculate-total-price`).\n- Create `docs/ai/implementation/knowledge-{name}.md` using the Output Template.\n- Include mermaid diagrams when they clarify flows or relationships.\n\n## Red Flags and Rationalizations\n\n| Rationalization | Why It's Wrong | Do Instead |\n|---|---|---|\n| \"I already understand this code\" | Understanding ≠ documented understanding | Write it down, then verify |\n| \"The code is self-documenting\" | Future readers lack your current context | Capture the why, not just the what |\n| \"Dependencies are obvious\" | Implicit dependencies cause surprises | Map them explicitly to depth 3 |\n\n## Validation\n- Documentation covers all Output Template sections.\n- Summarize key insights, open questions, and related areas for deeper dives.\n- Confirm file path and remind to commit.\n\n## Output Template\n- Overview\n- Implementation Details\n- Dependencies\n- Visual Diagrams (mermaid)\n- Additional Insights\n- Metadata (date, depth, files touched)\n- Next Steps","tags":["capture","knowledge","devkit","codeaholicguy","agent-skills","ai-assisted-development","antigravity","claude-code","codex","cursor","development","engineering"],"capabilities":["skill","source-codeaholicguy","skill-capture-knowledge","topic-agent-skills","topic-ai-assisted-development","topic-antigravity","topic-claude-code","topic-codex","topic-cursor","topic-development","topic-engineering","topic-engineering-enablement","topic-engineering-experience","topic-prd"],"categories":["ai-devkit"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/codeaholicguy/ai-devkit/capture-knowledge","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add codeaholicguy/ai-devkit","source_repo":"https://github.com/codeaholicguy/ai-devkit","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 1186 github stars · SKILL.md body (2,217 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-09T12:52:48.973Z","embedding":null,"createdAt":"2026-04-18T21:55:28.743Z","updatedAt":"2026-05-09T12:52:48.973Z","lastSeenAt":"2026-05-09T12:52:48.973Z","tsv":"'1':72 '2':111 '3':134,143,274 '4':163 '5':188 'addit':309 'ai':4,105 'ai-devkit':104 'alreadi':231 'altern':93 'ambigu':90 'analysi':52,68,187 'analysis-first':51 'analyz':102,135 'api':38,81 'area':289 'ask':24 'assist':41 'avoid':148 'behavior':171 'build':42,137 'calcul':199 'calculate-total-pric':198 'calculatetotalpric':197 'call':153 'captur':2,6,40,127,255 'capture-knowledg':1 'case':196 'categor':150 'caus':267 'clarifi':215 'code':11,30,46,162,234,244 'collect':112 'commit':299 'complet':70 'confirm':75,293 'consider':181 'context':114,254 'core':172 'cover':277 'creat':59,189,202 'current':253 'date':312 'deeper':291 'depend':136,138,262,266,305 'depth':85,142,273,313 'desir':84 'detail':304 'devkit':5,106 'diagram':212,307 'discov':185 'dive':292 'doc':20 'docs/ai/implementation/knowledge-':203 'document':26,60,190,236,248,276 'entri':12,47,63,76 'error':132,177 'exclud':157 'execut':174 'exist':88,99 'explicit':271 'export':117 'extern':155,158 'file':34,78,294,314 'first':53 'flag':220 'flow':175,216 'folder':35,79,120 'found':96 'function':36,80,152 'functions/apis':126 'futur':249 'gather':73 'generat':161 'handl':133,178 'hard':55 'high':169 'high-level':168 'highlight':123 'implement':303 'implicit':265 'import':151 'improv':182 'includ':210 'insight':284,310 'instead':229 'kebab':195 'kebab-cas':194 'key':118,124,283 'knowledg':3,8,19,39,100 'lack':251 'languag':167 'latest':107 'level':170 'list':121 'logic':173 'loop':149 'map':29,269 'md':205 'memori':108 'mermaid':211,308 'metadata':311 'modul':33,125 'name':192,204 'next':316 'node':146 'normal':191 'npx':103 'obvious':264 'open':285 'output':208,279,300 'overview':165,302 'packag':156 'paramet':129 'path':295 'pattern':119,176 'perform':179 'point':13,48,64,77 'price':201 'purpos':82,116,166 'queri':110 'question':286 'ration':222,223 'reader':250 'red':219 'relat':288 'relationship':218 'remind':297 'resolv':89 'return':130 'risk':184 'rule':56 'save':15 'search':97,109 'section':281 'secur':180 'self':247 'self-docu':246 'servic':154 'signatur':128 'skill' 'skill-capture-knowledge' 'sourc':113 'source-codeaholicguy' 'step':317 'structur':7,43,122 'suggest':92 'summar':115,282 'surpris':268 'synthes':164 'system':159 'templat':209,280,301 'topic-agent-skills' 'topic-ai-assisted-development' 'topic-antigravity' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-development' 'topic-engineering' 'topic-engineering-enablement' 'topic-engineering-experience' 'topic-prd' 'total':200 'touch':315 'track':144 'understand':27,44,232,235,237 'use':21,206 'user':23 'valid':66,74,275 'valu':131 'verifi':86,242 'view':139 'visit':145 'visual':306 'workflow':54,71 'write':238 'wrong':227","prices":[{"id":"1bb5adfb-6259-432b-94a3-129ca3d697bc","listingId":"6f6791ee-866c-447a-a48c-8dad65ddaef3","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"codeaholicguy","category":"ai-devkit","install_from":"skills.sh"},"createdAt":"2026-04-18T21:55:28.743Z"}],"sources":[{"listingId":"6f6791ee-866c-447a-a48c-8dad65ddaef3","source":"github","sourceId":"codeaholicguy/ai-devkit/capture-knowledge","sourceUrl":"https://github.com/codeaholicguy/ai-devkit/tree/main/skills/capture-knowledge","isPrimary":false,"firstSeenAt":"2026-04-18T21:55:28.743Z","lastSeenAt":"2026-05-09T12:52:48.973Z"}],"details":{"listingId":"6f6791ee-866c-447a-a48c-8dad65ddaef3","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"codeaholicguy","slug":"capture-knowledge","github":{"repo":"codeaholicguy/ai-devkit","stars":1186,"topics":["agent-skills","ai","ai-assisted-development","antigravity","claude-code","codex","cursor","development","engineering","engineering-enablement","engineering-experience","prd"],"license":null,"html_url":"https://github.com/codeaholicguy/ai-devkit","pushed_at":"2026-05-09T11:11:33Z","description":"A universal CLI toolkit for AI agent skills, enabling structured AI-assisted development across tools like Cursor, Claude Code, Codex, and more.","skill_md_sha":"f0f3b182e4c3bcaf312d4da0212b45552a166201","skill_md_path":"skills/capture-knowledge/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/codeaholicguy/ai-devkit/tree/main/skills/capture-knowledge"},"layout":"multi","source":"github","category":"ai-devkit","frontmatter":{"name":"capture-knowledge","description":"AI DevKit · Capture structured knowledge about a code entry point and save it to the knowledge docs. Use when users ask to document, understand, or map code for a module, file, folder, function, or API."},"skills_sh_url":"https://skills.sh/codeaholicguy/ai-devkit/capture-knowledge"},"updatedAt":"2026-05-09T12:52:48.973Z"}}