{"id":"17ff3575-9d18-4d83-a2e1-6ba6993c8735","shortId":"ZsKLTZ","kind":"skill","title":"snapshots","tagline":"Use this skill when the user wants to save a version of a note, create a backup before editing, list previous versions, restore a note to an earlier state, or manage note history. Triggers on: 'save version', 'snapshot', 'backup note', 'restore', 'rollback', 'version history', 'u","description":"# Snapshots — Note Versioning\n\nSave, list, and restore note versions using Aicoo OS endpoints.\n\n## Prerequisites\n\n- `AICOO_API_KEY` must be set\n- Base URL: `https://www.aicoo.io/api/v1`\n\n## API Endpoints\n\n- `GET /api/v1/os/snapshots/{noteId}`\n- `POST /api/v1/os/snapshots/{noteId}`\n- `POST /api/v1/os/snapshots/{noteId}/restore`\n\n## Save a Snapshot\n\n```bash\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\":\"Before Q2 update\"}' | jq .\n```\n\n## List Snapshots\n\n```bash\ncurl -s \"https://www.aicoo.io/api/v1/os/snapshots/42?limit=10\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" | jq .\n```\n\n## Restore a Snapshot\n\n```bash\ncurl -s -X POST \"https://www.aicoo.io/api/v1/os/snapshots/42/restore\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"versionId\":7}' | jq .\n```\n\nRestore auto-backs up current state first.\n\n## Snapshot-Before-Edit Pattern\n\n```bash\n# 1) backup\ncurl -s -X POST \"$PULSE_BASE/os/snapshots/42\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"label\":\"Pre-edit backup\"}' | jq .\n\n# 2) edit\ncurl -s -X PATCH \"$PULSE_BASE/os/notes/42\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"content\":\"# Updated content...\"}' | jq .\n```\n\n## Scheduled Backup Pattern\n\n```bash\n# list notes in a folder\nNOTES=$(curl -s \"$PULSE_BASE/os/notes?folderId=5&limit=200\" \\\n  -H \"Authorization: Bearer $AICOO_API_KEY\" | jq -r '.notes[].id')\n\n# backup each\nfor id in $NOTES; do\n  curl -s -X POST \"$PULSE_BASE/os/snapshots/$id\" \\\n    -H \"Authorization: Bearer $AICOO_API_KEY\" \\\n    -H \"Content-Type: application/json\" \\\n    -d \"{\\\"label\\\":\\\"Pre-sync $(date +%Y-%m-%d)\\\"}\" | jq .success\ndone\n```\n\n## Guest Access Guidance\n\nGuest write scope still depends on `notesAccess` on the share link:\n\n- `read`: can view/search notes\n- `write`: can create notes\n- `edit`: can edit notes and use snapshots","tags":["snapshots","aicoo","skills","aicoo-team","agent","agent-skills","agentic-ai"],"capabilities":["skill","source-aicoo-team","skill-snapshots","topic-agent","topic-agent-skills","topic-agentic-ai"],"categories":["AICOO-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/Aicoo-Team/AICOO-Skills/snapshots","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 (2,038 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.603Z","embedding":null,"createdAt":"2026-05-09T01:05:26.069Z","updatedAt":"2026-05-18T19:07:07.603Z","lastSeenAt":"2026-05-18T19:07:07.603Z","tsv":"'/api/v1':71 '/api/v1/os/snapshots':75,78,81 '/api/v1/os/snapshots/42':94 '/api/v1/os/snapshots/42/restore':137 '/api/v1/os/snapshots/42?limit=10':119 '/restore':83 '1':167 '2':193 '200':234 '5':232 '7':151 'access':283 'aicoo':57,61,98,123,141,178,204,238,262 'api':62,72,99,124,142,179,205,239,263 'application/json':105,148,185,211,269 'author':96,121,139,176,202,236,260 'auto':155 'auto-back':154 'back':156 'backup':18,40,168,191,218,245 'base':67 'base/os/notes':230 'base/os/notes/42':200 'base/os/snapshots':257 'base/os/snapshots/42':174 'bash':87,114,130,166,220 'bearer':97,122,140,177,203,237,261 'content':103,146,183,209,213,215,267 'content-typ':102,145,182,208,266 'creat':16,302 'curl':88,115,131,169,195,227,252 'current':158 'd':106,149,186,212,270,278 'date':275 'depend':289 'done':281 'earlier':29 'edit':20,164,190,194,304,306 'endpoint':59,73 'first':160 'folder':225 'folderid':231 'get':74 'guest':282,285 'guidanc':284 'h':95,101,120,138,144,175,181,201,207,235,259,265 'histori':34,45 'id':244,248,258 'jq':111,126,152,192,216,241,279 'key':63,100,125,143,180,206,240,264 'label':107,187,271 'limit':233 'link':295 'list':21,51,112,221 'm':277 'manag':32 'must':64 'note':15,26,33,41,48,54,222,226,243,250,299,303,307 'noteid':76,79,82 'notesaccess':291 'os':58 'patch':198 'pattern':165,219 'post':77,80,91,134,172,255 'pre':189,273 'pre-edit':188 'pre-sync':272 'prerequisit':60 'previous':22 'puls':173,199,229,256 'q2':109 'r':242 'read':296 'restor':24,42,53,127,153 'rollback':43 'save':10,37,50,84 'schedul':217 'scope':287 'set':66 'share':294 'skill':4 'skill-snapshots' 'snapshot':1,39,47,86,113,129,162,310 'snapshot-before-edit':161 'source-aicoo-team' 'state':30,159 'still':288 'success':280 'sync':274 'topic-agent' 'topic-agent-skills' 'topic-agentic-ai' 'trigger':35 'type':104,147,184,210,268 'u':46 'updat':110,214 'url':68 'use':2,56,309 'user':7 'version':12,23,38,44,49,55 'versionid':150 'view/search':298 'want':8 'write':286,300 'www.aicoo.io':70,93,118,136 'www.aicoo.io/api/v1':69 'www.aicoo.io/api/v1/os/snapshots/42':92 'www.aicoo.io/api/v1/os/snapshots/42/restore':135 'www.aicoo.io/api/v1/os/snapshots/42?limit=10':117 'x':90,133,171,197,254 'y':276","prices":[{"id":"eee3fe4f-d6dd-4fcb-8ae3-d5197bc0a92d","listingId":"17ff3575-9d18-4d83-a2e1-6ba6993c8735","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.069Z"}],"sources":[{"listingId":"17ff3575-9d18-4d83-a2e1-6ba6993c8735","source":"github","sourceId":"Aicoo-Team/AICOO-Skills/snapshots","sourceUrl":"https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/snapshots","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:26.069Z","lastSeenAt":"2026-05-18T19:07:07.603Z"}],"details":{"listingId":"17ff3575-9d18-4d83-a2e1-6ba6993c8735","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"Aicoo-Team","slug":"snapshots","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":"8f1c66d2e156d28062ada2c73598a5fcafbaf952","skill_md_path":"skills/snapshots/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/Aicoo-Team/AICOO-Skills/tree/main/skills/snapshots"},"layout":"multi","source":"github","category":"AICOO-Skills","frontmatter":{"name":"snapshots","description":"Use this skill when the user wants to save a version of a note, create a backup before editing, list previous versions, restore a note to an earlier state, or manage note history. Triggers on: 'save version', 'snapshot', 'backup note', 'restore', 'rollback', 'version history', 'undo changes', 'previous version'."},"skills_sh_url":"https://skills.sh/Aicoo-Team/AICOO-Skills/snapshots"},"updatedAt":"2026-05-18T19:07:07.603Z"}}