{"id":"33f800fc-ef23-4f65-a353-f82732b86081","shortId":"pUrR7t","kind":"skill","title":"memory","tagline":"Use AI DevKit memory via CLI commands. Search before non-trivial work, store verified reusable knowledge, update stale entries, and avoid saving transcripts, secrets, or one-off task progress.","description":"# AI DevKit Memory CLI\n\nUse `npx ai-devkit@latest memory ...` as the durable knowledge layer.\n\n## Workflow\n\n1. For implementation, debugging, review, planning, or documentation tasks, search before deep work unless the task is trivial:\n   ```bash\n   npx ai-devkit@latest memory search --query \"<task, subsystem, error, or convention>\" --limit 5\n   ```\n   For broad or risky tasks, search multiple angles: subsystem, error text, framework, command, and task intent.\n\n2. Use results as context:\n   - Trust repo files, tests, fresh command output, and explicit user instructions over memory.\n   - If memory conflicts with verified evidence, use the evidence and update the stale memory.\n   - Mention memory only when it changes the plan or avoids asking the user again.\n\n3. Search before storing:\n   ```bash\n   npx ai-devkit@latest memory search --query \"<knowledge to store>\" --table\n   ```\n\n4. Store or update only after the quality gate passes.\n\n## Quality Gate\n\nBefore storing, all must be true:\n\n- Future sessions are likely to reuse it.\n- It is verified by code, docs, tests, command output, or explicit user instruction.\n- It is not merely a restatement of obvious nearby files unless it prevents repeated agent mistakes.\n- It is scoped narrowly enough.\n- Existing memory does not already cover it.\n- It contains no secrets, credentials, private customer data, personal data, raw logs, or temporary paths.\n\nStore:\n- Project conventions, user preferences, durable decisions.\n- Reusable fixes, testing patterns, commands, setup gotchas.\n- Non-obvious constraints, architecture rules, failure patterns.\n\nDo not store:\n- Task progress, transcripts, speculation, generic programming facts.\n- Raw errors without diagnosis.\n- Anything the user did not intend to persist.\n\n## Commands\n\n### Search\n\n```bash\nnpx ai-devkit@latest memory search \\\n  --query \"<query>\" \\\n  --tags \"<tags>\" \\\n  --scope \"<scope>\" \\\n  --limit 5\n```\n\nUse `--table` to get IDs for updates:\n\n```bash\nnpx ai-devkit@latest memory search --query \"<query>\" --table\n```\n\nOptions: `--query/-q` required; `--tags`; `--scope/-s`; `--limit/-l` from 1-20; `--table`.\n\n### Store\n\n```bash\nnpx ai-devkit@latest memory store \\\n  --title \"<actionable title, 10-100 chars>\" \\\n  --content \"<context, guidance, evidence, exceptions>\" \\\n  --tags \"<lowercase,tags>\" \\\n  --scope \"<global|project:name|repo:org/repo>\"\n```\n\nUse this content shape when helpful:\n\n```text\nContext: Where this applies.\nGuidance: What to do.\nEvidence: File, command, test, or user instruction.\nExceptions: When not to apply it.\n```\n\n### Update\n\nFind the ID with `search --table`, then update only changed fields:\n\n```bash\nnpx ai-devkit@latest memory update \\\n  --id \"<memory-id>\" \\\n  --title \"<updated title>\" \\\n  --content \"<updated content>\" \\\n  --tags \"<replacement,tags>\" \\\n  --scope \"<updated scope>\"\n```\n\n`--tags` replaces all existing tags.\n\n## Scoping\n\nUse the narrowest useful scope:\n\n- `repo:<org/repo>` for one repository.\n- `project:<name>` for one app, product, or workspace.\n- `global` only for knowledge that applies across unrelated projects.\n\nIf unsure, use a narrower scope.\n\n## Troubleshooting\n\n- CLI missing: run `npx ai-devkit@latest --version`.\n- Duplicate title: search, then update the existing item if it is the same knowledge.\n- Empty results: broaden terms, remove filters, or search symptoms and subsystem names separately.\n- Validation error: check title/content lengths, query length, and `--limit` range.\n- DB path: default is `~/.ai-devkit/memory.db`; project config can override it automatically.","tags":["memory","devkit","codeaholicguy","agent-skills","ai-assisted-development","antigravity","claude-code","codex","cursor","development","engineering","engineering-enablement"],"capabilities":["skill","source-codeaholicguy","skill-memory","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/memory","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 · 1174 github stars · SKILL.md body (3,552 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-03T00:52:57.145Z","embedding":null,"createdAt":"2026-04-18T21:55:31.035Z","updatedAt":"2026-05-03T00:52:57.145Z","lastSeenAt":"2026-05-03T00:52:57.145Z","tsv":"'-100':343 '-20':328 '/.ai-devkit/memory.db':503 '1':50,327 '10':342 '2':100 '3':146 '4':160 '5':83,299 'across':443 'action':340 'agent':212 'ai':3,33,40,71,153,290,310,334,402,458 'ai-devkit':39,70,152,289,309,333,401,457 'alreadi':223 'angl':91 'anyth':277 'app':433 'appli':369,385,442 'architectur':259 'ask':142 'automat':509 'avoid':23,141 'bash':68,150,287,307,331,399 'broad':85 'broaden':478 'chang':137,397 'char':344 'check':491 'cli':7,36,453 'code':189 'command':8,96,110,192,252,285,376 'config':505 'conflict':120 'constraint':258 'contain':227 'content':345,361,409 'context':104,346,366 'convent':81,243 'cover':224 'credenti':230 'custom':232 'data':233,235 'db':499 'debug':53 'decis':247 'deep':61 'default':501 'devkit':4,34,41,72,154,291,311,335,403,459 'diagnosi':276 'doc':190 'document':57 'duplic':462 'durabl':46,246 'empti':476 'enough':218 'entri':21 'error':79,93,274,490 'evid':123,126,348,374 'except':349,381 'exist':219,417,468 'explicit':113,195 'fact':272 'failur':261 'field':398 'file':107,207,375 'filter':481 'find':388 'fix':249 'framework':95 'fresh':109 'futur':178 'gate':168,171 'generic':270 'get':303 'global':354,437 'gotcha':254 'guidanc':347,370 'help':364 'id':304,390,407 'implement':52 'instruct':115,197,380 'intend':282 'intent':99 'item':469 'knowledg':18,47,440,475 'l':325 'latest':42,73,155,292,312,336,404,460 'layer':48 'length':493,495 'like':181 'limit':82,298,324,497 'log':237 'lowercas':351 'memori':1,5,35,43,74,117,119,131,133,156,220,293,313,337,405 'mention':132 'mere':201 'miss':454 'mistak':213 'multipl':90 'must':175 'name':356,487 'narrow':450 'narrowest':422 'narrowli':217 'nearbi':206 'non':12,256 'non-obvi':255 'non-trivi':11 'npx':38,69,151,288,308,332,400,456 'obvious':205,257 'one':29,428,432 'one-off':28 'option':317 'org/repo':358,426 'output':111,193 'overrid':507 'pass':169 'path':240,500 'pattern':251,262 'persist':284 'person':234 'plan':55,139 'prefer':245 'prevent':210 'privat':231 'product':434 'program':271 'progress':32,267 'project':242,355,430,445,504 'q':319 'qualiti':167,170 'queri':76,158,295,315,318,494 'rang':498 'raw':236,273 'remov':480 'repeat':211 'replac':411,415 'repo':106,357,425 'repositori':429 'requir':320 'restat':203 'result':102,477 'reus':183 'reusabl':17,248 'review':54 'riski':87 'rule':260 'run':455 'save':24 'scope':216,297,322,353,413,419,424,451 'search':9,59,75,89,147,157,286,294,314,392,464,483 'secret':26,229 'separ':488 'session':179 'setup':253 'shape':362 'skill' 'skill-memory' 'source-codeaholicguy' 'specul':269 'stale':20,130 'store':15,149,161,173,241,265,330,338 'subsystem':78,92,486 'symptom':484 'tabl':159,301,316,329,393 'tag':296,321,350,352,410,412,414,418 'task':31,58,65,77,88,98,266 'temporari':239 'term':479 'test':108,191,250,377 'text':94,365 'titl':339,341,408,463 'title/content':492 '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' 'transcript':25,268 'trivial':13,67 'troubleshoot':452 'true':177 'trust':105 'unless':63,208 'unrel':444 'unsur':447 'updat':19,128,163,306,387,395,406,466 'use':2,37,101,124,300,359,420,423,448 'user':114,144,196,244,279,379 'valid':489 'verifi':16,122,187 'version':461 'via':6 'without':275 'work':14,62 'workflow':49 'workspac':436","prices":[{"id":"ae26f367-76da-45cf-b019-a8eb26420122","listingId":"33f800fc-ef23-4f65-a353-f82732b86081","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:31.035Z"}],"sources":[{"listingId":"33f800fc-ef23-4f65-a353-f82732b86081","source":"github","sourceId":"codeaholicguy/ai-devkit/memory","sourceUrl":"https://github.com/codeaholicguy/ai-devkit/tree/main/skills/memory","isPrimary":false,"firstSeenAt":"2026-04-18T21:55:31.035Z","lastSeenAt":"2026-05-03T00:52:57.145Z"}],"details":{"listingId":"33f800fc-ef23-4f65-a353-f82732b86081","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"codeaholicguy","slug":"memory","github":{"repo":"codeaholicguy/ai-devkit","stars":1174,"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-03T00:18:58Z","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":"c44f6cd782069584c8ad17dfe84b418a62c4e843","skill_md_path":"skills/memory/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/codeaholicguy/ai-devkit/tree/main/skills/memory"},"layout":"multi","source":"github","category":"ai-devkit","frontmatter":{"name":"memory","description":"Use AI DevKit memory via CLI commands. Search before non-trivial work, store verified reusable knowledge, update stale entries, and avoid saving transcripts, secrets, or one-off task progress."},"skills_sh_url":"https://skills.sh/codeaholicguy/ai-devkit/memory"},"updatedAt":"2026-05-03T00:52:57.145Z"}}