{"id":"d5cd9ec3-3856-4166-979c-21453636c1b6","shortId":"c6Tpxx","kind":"skill","title":"context-sync","tagline":"Use this skill when the user wants to upload files to Aicoo, sync context, add knowledge to their agent, update what their agent knows, push local files to Aicoo, search or read existing notes, browse folders, or accumulate context. Triggers on: 'sync files', 'upload to Aicoo', '","description":"# Context Sync\n\nYou help users sync local files, notes, and context into Aicoo so their shared agent has the right knowledge to represent them.\n\n## Prerequisites\n\n- `AICOO_API_KEY` environment variable must be set\n- Base URL: `https://www.aicoo.io/api/v1`\n\n## API Model\n\n- Use `/api/v1/os/*` for workspace-native operations (notes/folders/snapshots/memory/todos/network/share)\n- Use `/api/v1/tools` only for non-OS tools (calendar/email/web/messaging/quality/MCP)\n\n## Core Workflow\n\n### Step 1: Check current state\n\n```bash\ncurl -s -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  \"https://www.aicoo.io/api/v1/os/status\" | jq .\n```\n\n### Step 2: Browse workspace\n\n```bash\n# folders\ncurl -s -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  \"https://www.aicoo.io/api/v1/os/folders\" | jq .\n\n# notes in folder\ncurl -s -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  \"https://www.aicoo.io/api/v1/os/notes?folderId=5&limit=20\" | jq .\n\n# note content\ncurl -s -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  \"https://www.aicoo.io/api/v1/os/notes/42\" | jq .\n```\n\n### Step 3: Search existing notes first\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\":\"project roadmap\"}' | jq .\n\n# deterministic grep (regex/literal + context lines)\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/notes/grep\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"pattern\":\"roadmap|timeline\",\"mode\":\"regex\",\"caseSensitive\":false,\"contextBefore\":3,\"contextAfter\":3}' | jq .\n```\n\n### Step 4: Create or update notes\n\n```bash\n# create\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/notes\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"title\":\"Project Roadmap Q2\",\"content\":\"# Q2 Roadmap\\n\\n## Goals\\n- Launch v2 API\"}' | jq .\n\n# snapshot before edit\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/snapshots/42\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"label\":\"Pre-edit\"}' | jq .\n\n# edit\ncurl -s -X PATCH \"https://www.aicoo.io/api/v1/os/notes/42\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"content\":\"# Updated Roadmap\\n\\n...\"}' | jq .\n\n# move (mv)\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/notes/42/move\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"folderName\":\"Technical\"}' | jq .\n\n# copy (cp)\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/notes/42/copy\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"folderName\":\"Archive\"}' | jq .\n```\n\n### Step 5: Bulk file sync\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\":\"Technical/architecture.md\",\"content\":\"# Architecture\\n\\n...\"},\n      {\"path\":\"General/team-info.md\",\"content\":\"# Team\\n\\n...\"}\n    ]\n  }' | jq .\n```\n\n### Step 6: Manage folders\n\n```bash\n# list\ncurl -s -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  \"https://www.aicoo.io/api/v1/os/folders\" | jq .\n\n# create\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/folders\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\":\"Investor Materials\"}' | jq .\n```\n\n### Step 7: Delete 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 '{\"delete\":[{\"path\":\"Technical/old-doc.md\"}]}' | jq .\n```\n\n## Identity Files (`memory/self/`)\n\nUse `/accumulate` to manage:\n\n- `memory/self/COO.md`\n- `memory/self/USER.md`\n- `memory/self/POLICY.md`\n\n## Links Folder Policy (`links/`)\n\nTo customize per-link behavior, edit link notes in `links/`:\n\n```bash\n# find link note\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\":\"For-Investors\"}' | jq .\n```\n\nThen patch that note via `PATCH /api/v1/os/notes/{id}`.\n\n## When to Use What\n\n| Scenario | Endpoint |\n|----------|----------|\n| Browse folders | `GET /os/folders` |\n| List notes in folder | `GET /os/notes?folderId=...` |\n| Search notes | `POST /os/notes/search` |\n| Grep notes (exact/regex + context) | `POST /os/notes/grep` |\n| Read note | `GET /os/notes/{id}` |\n| Create note | `POST /os/notes` |\n| Edit note | `PATCH /os/notes/{id}` |\n| Move note | `POST /os/notes/{id}/move` |\n| Copy note | `POST /os/notes/{id}/copy` |\n| Snapshot save/list/restore | `/os/snapshots/{noteId}` + `/restore` |\n| Bulk upload/delete | `POST /accumulate` |\n\n## Best Practices\n\n1. Search before creating to avoid duplicates.\n2. Snapshot before major edits.\n3. Use `/accumulate` for multi-file sync.\n4. Keep identity and link policy files up to date.","tags":["context","sync","aicoo","skills","aicoo-team","agent","agent-skills","agentic-ai"],"capabilities":["skill","source-aicoo-team","skill-context-sync","topic-agent","topic-agent-skills","topic-agentic-ai"],"categories":["AICOO-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/Aicoo-Team/AICOO-Skills/context-sync","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 (4,981 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:06.918Z","embedding":null,"createdAt":"2026-05-09T01:05:25.281Z","updatedAt":"2026-05-18T19:07:06.918Z","lastSeenAt":"2026-05-18T19:07:06.918Z","tsv":"'/accumulate':496,614,631 '/api/v1':87 '/api/v1/accumulate':395,475 '/api/v1/os':91 '/api/v1/os/folders':143,438,447 '/api/v1/os/notes':254,551 '/api/v1/os/notes/42':172,316 '/api/v1/os/notes/42/copy':367 '/api/v1/os/notes/42/move':343 '/api/v1/os/notes/grep':215 '/api/v1/os/notes/search':187,527 '/api/v1/os/notes?folderid=5&limit=20':158 '/api/v1/os/snapshots/42':291 '/api/v1/os/status':125 '/api/v1/tools':99 '/copy':605 '/move':599 '/os/folders':562 '/os/notes':568,583,588,592,597,603 '/os/notes/grep':579 '/os/notes/search':573 '/os/snapshots':608 '/restore':610 '1':110,617 '2':128,624 '3':175,236,238,629 '4':241,637 '5':384 '6':423 '7':465 'accumul':41 'add':18 'agent':22,26,66 'aicoo':15,32,49,62,75,120,138,153,167,191,219,258,295,320,347,371,399,433,451,479,531 'api':76,88,121,139,154,168,192,220,259,280,296,321,348,372,400,434,452,480,532 'application/json':198,226,265,302,327,354,378,406,458,486,538 'architectur':412 'archiv':381 'author':118,136,151,165,189,217,256,293,318,345,369,397,431,449,477,529 'avoid':622 'base':83 'bash':114,131,180,246,388,426,468,517 'bearer':119,137,152,166,190,218,257,294,319,346,370,398,432,450,478,530 'behavior':511 'best':615 'brows':38,129,559 'bulk':385,611 'calendar/email/web/messaging/quality/mcp':106 'casesensit':233 'check':111 'content':161,196,224,263,271,300,325,329,352,376,404,411,417,456,484,536 'content-typ':195,223,262,299,324,351,375,403,455,483,535 'context':2,17,42,50,60,207,577 'context-sync':1 'contextaft':237 'contextbefor':235 'copi':359,600 'core':107 'cp':360 'creat':242,247,440,585,620 'curl':115,133,148,162,181,209,248,285,310,337,361,389,428,441,469,521 'current':112 'custom':507 'd':199,227,266,303,328,355,379,407,459,487,539 'date':646 'delet':466,488 'determinist':204 'duplic':623 'edit':284,307,309,512,589,628 'endpoint':558 'environ':78 'exact/regex':576 'exist':36,177 'fals':234 'file':13,30,46,57,386,408,467,493,635,643 'find':518 'first':179 'folder':39,132,147,425,503,560,566 'folderid':569 'foldernam':356,380 'for-investor':541 'general/team-info.md':416 'get':561,567,582 'goal':276 'grep':205,574 'h':117,135,150,164,188,194,216,222,255,261,292,298,317,323,344,350,368,374,396,402,430,448,454,476,482,528,534 'help':53 'id':552,584,593,598,604 'ident':492,639 'investor':461,543 'jq':126,144,159,173,203,239,281,308,334,358,382,421,439,463,491,544 'keep':638 'key':77,122,140,155,169,193,221,260,297,322,349,373,401,435,453,481,533 'know':27 'knowledg':19,70 'label':304 'launch':278 'line':208 'link':502,505,510,513,516,519,641 'list':427,563 'local':29,56 'major':627 'manag':424,498 'materi':462 'memory/self':494 'memory/self/coo.md':499 'memory/self/policy.md':501 'memory/self/user.md':500 'mode':231 'model':89 'move':335,594 'multi':634 'multi-fil':633 'must':80 'mv':336 'n':274,275,277,332,333,413,414,419,420 'name':460 'nativ':95 'non':103 'non-o':102 'note':37,58,145,160,178,245,514,520,548,564,571,575,581,586,590,595,601 'noteid':609 'notes/folders/snapshots/memory/todos/network/share':97 'oper':96 'os':104 'patch':313,546,550,591 'path':409,415,489 'pattern':228 'per':509 'per-link':508 'polici':504,642 'post':184,212,251,288,340,364,392,444,472,524,572,578,587,596,602,613 'practic':616 'pre':306 'pre-edit':305 'prerequisit':74 'project':201,268 'push':28 'q2':270,272 'queri':200,540 'read':35,580 'regex':232 'regex/literal':206 'repres':72 'right':69 'roadmap':202,229,269,273,331 'save/list/restore':607 'scenario':557 'search':33,176,570,618 'set':82 'share':65 'skill':6 'skill-context-sync' 'snapshot':282,606,625 'source-aicoo-team' 'state':113 'step':109,127,174,240,383,422,464 'sync':3,16,45,51,55,387,636 'team':418 'technic':357 'technical/architecture.md':410 'technical/old-doc.md':490 'timelin':230 'titl':267 'tool':105 'topic-agent' 'topic-agent-skills' 'topic-agentic-ai' 'trigger':43 'type':197,225,264,301,326,353,377,405,457,485,537 'updat':23,244,330 'upload':12,47 'upload/delete':612 'url':84 'use':4,90,98,495,555,630 'user':9,54 'v2':279 'variabl':79 'via':549 'want':10 'workflow':108 'workspac':94,130 'workspace-n':93 'www.aicoo.io':86,124,142,157,171,186,214,253,290,315,342,366,394,437,446,474,526 'www.aicoo.io/api/v1':85 'www.aicoo.io/api/v1/accumulate':393,473 'www.aicoo.io/api/v1/os/folders':141,436,445 'www.aicoo.io/api/v1/os/notes':252 'www.aicoo.io/api/v1/os/notes/42':170,314 'www.aicoo.io/api/v1/os/notes/42/copy':365 'www.aicoo.io/api/v1/os/notes/42/move':341 'www.aicoo.io/api/v1/os/notes/grep':213 'www.aicoo.io/api/v1/os/notes/search':185,525 'www.aicoo.io/api/v1/os/notes?folderid=5&limit=20':156 'www.aicoo.io/api/v1/os/snapshots/42':289 'www.aicoo.io/api/v1/os/status':123 'x':183,211,250,287,312,339,363,391,443,471,523","prices":[{"id":"1cb5d212-46d3-4918-a695-19a4d452f437","listingId":"d5cd9ec3-3856-4166-979c-21453636c1b6","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:25.281Z"}],"sources":[{"listingId":"d5cd9ec3-3856-4166-979c-21453636c1b6","source":"github","sourceId":"Aicoo-Team/AICOO-Skills/context-sync","sourceUrl":"https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/context-sync","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:25.281Z","lastSeenAt":"2026-05-18T19:07:06.918Z"}],"details":{"listingId":"d5cd9ec3-3856-4166-979c-21453636c1b6","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"Aicoo-Team","slug":"context-sync","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":"fbf4db5858d1d8d7a9c2515fe5f614e0d268e338","skill_md_path":"skills/context-sync/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/context-sync"},"layout":"multi","source":"github","category":"AICOO-Skills","frontmatter":{"name":"context-sync","description":"Use this skill when the user wants to upload files to Aicoo, sync context, add knowledge to their agent, update what their agent knows, push local files to Aicoo, search or read existing notes, browse folders, or accumulate context. Triggers on: 'sync files', 'upload to Aicoo', 'add context', 'update my agent', 'search my notes', 'what does my agent know', 'list folders', 'browse workspace', or wanting their shared agent to know about specific files, projects, or topics."},"skills_sh_url":"https://skills.sh/Aicoo-Team/AICOO-Skills/context-sync"},"updatedAt":"2026-05-18T19:07:06.918Z"}}