{"id":"f40962f7-7898-49d3-8643-d70a6305a916","shortId":"zNHq8G","kind":"skill","title":"start-aicoo","tagline":"Use this skill when the user wants to boot their Aicoo agent, verify identity, check workspace health, and incrementally sync new or changed context. Triggers on: 'start aicoo', 'boot my agent', 'launch aicoo', 'wake up aicoo', 'aicoo status', 'is my agent running', 'sync context","description":"# Start Aicoo — Boot & Incremental Context Sync\n\nOne command to verify your agent identity, check workspace health, and push any new context.\n\n## Prerequisites\n\n- `AICOO_API_KEY` environment variable must be set\n- Base URL: `https://www.aicoo.io/api/v1`\n\n## Workflow\n\n### Step 1: Verify identity\n\n```bash\ncurl -s \"https://www.aicoo.io/api/v1/identity\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" | jq .\n```\n\nExpected response includes `profile.userId`, `profile.username`, `profile.name`.\nIf this fails, the API key is invalid or expired — guide user to https://www.aicoo.io/settings/api-keys.\n\n### Step 2: Check workspace health\n\n```bash\ncurl -s \"https://www.aicoo.io/api/v1/os/status\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" | jq .\n```\n\nReport: note count, folder count, last sync time, active share links.\n\n### Step 3: Check identity files exist\n\n```bash\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/notes/search\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\":\"COO.md USER.md POLICY.md\"}' | jq .\n```\n\nIf any of `memory/self/COO.md`, `memory/self/USER.md`, or `memory/self/POLICY.md` are missing, prompt the user to create them or offer to generate defaults.\n\n### Step 4: Detect local changes for incremental sync\n\nScan the current project directory for recently modified files:\n\n```bash\n# Find markdown/text files changed in the last 24 hours\nfind . -maxdepth 3 \\( -name \"*.md\" -o -name \"*.txt\" \\) \\\n  -not -path \"*/node_modules/*\" \\\n  -not -path \"*/.git/*\" \\\n  -not -path \"*/.next/*\" \\\n  -newer /tmp/.aicoo-last-sync 2>/dev/null | head -30\n```\n\nIf no `/tmp/.aicoo-last-sync` marker exists, this is a first sync — list all candidate files and ask the user which ones to include.\n\n### Step 5: Search before creating (dedup)\n\nFor each file to sync, search for existing notes:\n\n```bash\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/notes/search\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\":\"[file title or topic]\"}' | jq .\n```\n\n- If a matching note exists: snapshot it, then PATCH with updated content.\n- If no match: create a new note.\n\n### Step 6: Bulk sync changed files\n\n```bash\ncurl -s -X POST \"https://www.aicoo.io/api/v1/accumulate\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"files\": [\n      {\"path\": \"Folder/filename.md\", \"content\": \"...\"}\n    ]\n  }' | jq .\n```\n\n### Step 7: Update sync marker\n\n```bash\ntouch /tmp/.aicoo-last-sync\n```\n\n### Step 8: Report summary\n\nPrint a concise status:\n\n```\nAicoo Agent Status\n  Identity:    @username (Name)\n  Workspace:   X notes, Y folders\n  Last sync:   YYYY-MM-DD HH:MM\n  This sync:   N files synced (M new, K updated)\n  Identity files: COO.md ✓  USER.md ✓  POLICY.md ✓\n  Share links: Z active\n```\n\n## Error Handling\n\n| Error | Action |\n|-------|--------|\n| 401 from `/identity` | API key invalid — guide to settings page |\n| Identity OK but `/os/status` fails | Workspace not initialized — run `POST /init` |\n| Missing identity files | Offer to create defaults from user context |\n| No local changes found | Report \"Agent context is up to date\" |\n\n## When to Use\n\n- Start of a work session\n- After pulling new code or docs\n- Before sharing an agent link\n- Periodic check that agent knowledge is current","tags":["start","aicoo","skills","aicoo-team","agent","agent-skills","agentic-ai"],"capabilities":["skill","source-aicoo-team","skill-start-aicoo","topic-agent","topic-agent-skills","topic-agentic-ai"],"categories":["AICOO-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/Aicoo-Team/AICOO-Skills/start-aicoo","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add Aicoo-Team/AICOO-Skills","source_repo":"https://github.com/Aicoo-Team/AICOO-Skills","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 12 github stars · SKILL.md body (3,338 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:07.683Z","embedding":null,"createdAt":"2026-05-09T01:05:26.200Z","updatedAt":"2026-05-18T19:07:07.683Z","lastSeenAt":"2026-05-18T19:07:07.683Z","tsv":"'-30':252 '/.git':243 '/.next':246 '/api/v1':82 '/api/v1/accumulate':348 '/api/v1/identity':93 '/api/v1/os/notes/search':165,297 '/api/v1/os/status':133 '/dev/null':250 '/identity':425 '/init':443 '/node_modules':240 '/os/status':436 '/settings/api-keys.':122 '/tmp/.aicoo-last-sync':248,255,373 '1':85 '2':124,249 '24':228 '3':153,232 '4':204 '401':423 '5':276 '6':336 '7':367 '8':375 'action':422 'activ':149,418 'agent':15,34,44,59,383,459,482,487 'aicoo':3,14,31,36,39,40,49,70,97,137,169,301,352,382 'api':71,98,111,138,170,302,353,426 'application/json':176,308,359 'ask':268 'author':95,135,167,299,350 'base':78 'bash':88,128,158,220,290,341,371 'bearer':96,136,168,300,351 'boot':12,32,50 'bulk':337 'candid':265 'chang':26,207,224,339,456 'check':18,61,125,154,485 'code':476 'command':55 'concis':380 'content':174,306,327,357,364 'content-typ':173,305,356 'context':27,47,52,68,453,460 'coo.md':179,412 'count':143,145 'creat':196,279,331,449 'curl':89,129,159,291,342 'current':213,490 'd':177,309,360 'date':464 'dd':398 'dedup':280 'default':202,450 'detect':205 'directori':215 'doc':478 'environ':73 'error':419,421 'exist':157,257,288,320 'expect':101 'expir':116 'fail':109,437 'file':156,219,223,266,283,311,340,361,404,411,446 'find':221,230 'first':261 'folder':144,392 'folder/filename.md':363 'found':457 'generat':201 'guid':117,429 'h':94,134,166,172,298,304,349,355 'handl':420 'head':251 'health':20,63,127 'hh':399 'hour':229 'ident':17,60,87,155,385,410,433,445 'includ':103,274 'increment':22,51,209 'initi':440 'invalid':114,428 'jq':100,140,182,315,365 'k':408 'key':72,99,112,139,171,303,354,427 'knowledg':488 'last':146,227,393 'launch':35 'link':151,416,483 'list':263 'local':206,455 'm':406 'markdown/text':222 'marker':256,370 'match':318,330 'maxdepth':231 'md':234 'memory/self/coo.md':186 'memory/self/policy.md':189 'memory/self/user.md':187 'miss':191,444 'mm':397,400 'modifi':218 'must':75 'n':403 'name':233,236,387 'new':24,67,333,407,475 'newer':247 'note':142,289,319,334,390 'o':235 'offer':199,447 'ok':434 'one':54,272 'page':432 'patch':324 'path':239,242,245,362 'period':484 'policy.md':181,414 'post':162,294,345,442 'prerequisit':69 'print':378 'profile.name':106 'profile.userid':104 'profile.username':105 'project':214 'prompt':192 'pull':474 'push':65 'queri':178,310 'recent':217 'report':141,376,458 'respons':102 'run':45,441 'scan':211 'search':277,286 'session':472 'set':77,431 'share':150,415,480 'skill':6 'skill-start-aicoo' 'snapshot':321 'source-aicoo-team' 'start':2,30,48,468 'start-aicoo':1 'status':41,381,384 'step':84,123,152,203,275,335,366,374 'summari':377 'sync':23,46,53,147,210,262,285,338,369,394,402,405 'time':148 'titl':312 'topic':314 'topic-agent' 'topic-agent-skills' 'topic-agentic-ai' 'touch':372 'trigger':28 'txt':237 'type':175,307,358 'updat':326,368,409 'url':79 'use':4,467 'user':9,118,194,270,452 'user.md':180,413 'usernam':386 'variabl':74 'verifi':16,57,86 'wake':37 'want':10 'work':471 'workflow':83 'workspac':19,62,126,388,438 'www.aicoo.io':81,92,121,132,164,296,347 'www.aicoo.io/api/v1':80 'www.aicoo.io/api/v1/accumulate':346 'www.aicoo.io/api/v1/identity':91 'www.aicoo.io/api/v1/os/notes/search':163,295 'www.aicoo.io/api/v1/os/status':131 'www.aicoo.io/settings/api-keys.':120 'x':161,293,344,389 'y':391 'yyyi':396 'yyyy-mm-dd':395 'z':417","prices":[{"id":"7e72dc04-4586-482a-bbca-2ab08432d66f","listingId":"f40962f7-7898-49d3-8643-d70a6305a916","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"Aicoo-Team","category":"AICOO-Skills","install_from":"skills.sh"},"createdAt":"2026-05-09T01:05:26.200Z"}],"sources":[{"listingId":"f40962f7-7898-49d3-8643-d70a6305a916","source":"github","sourceId":"Aicoo-Team/AICOO-Skills/start-aicoo","sourceUrl":"https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/start-aicoo","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:26.200Z","lastSeenAt":"2026-05-18T19:07:07.683Z"}],"details":{"listingId":"f40962f7-7898-49d3-8643-d70a6305a916","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"Aicoo-Team","slug":"start-aicoo","github":{"repo":"Aicoo-Team/AICOO-Skills","stars":12,"topics":["agent","agent-skills","agentic-ai"],"license":"mit","html_url":"https://github.com/Aicoo-Team/AICOO-Skills","pushed_at":"2026-05-05T14:10:59Z","description":"An official set of skills to share, maintain and connect personal AI Agents.","skill_md_sha":"7e00d87cebb7a58215c6bb3a22b402e67efdd2a0","skill_md_path":"skills/start-aicoo/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/start-aicoo"},"layout":"multi","source":"github","category":"AICOO-Skills","frontmatter":{"name":"start-aicoo","description":"Use this skill when the user wants to boot their Aicoo agent, verify identity, check workspace health, and incrementally sync new or changed context. Triggers on: 'start aicoo', 'boot my agent', 'launch aicoo', 'wake up aicoo', 'aicoo status', 'is my agent running', 'sync context', 'incremental sync', 'update my agent context', 'refresh agent knowledge'."},"skills_sh_url":"https://skills.sh/Aicoo-Team/AICOO-Skills/start-aicoo"},"updatedAt":"2026-05-18T19:07:07.683Z"}}