How do I install the Snapshots skill?

Run npx skillmds@latest add aicoo-team/snapshots in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Snapshots safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Snapshots?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Snapshots free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Snapshots?

Aicoo-Team (@aicoo-team) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Snapshots by aicoo-team — Agent Skill

Name: Snapshots
Author: Aicoo-Team

Snapshots

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'.

Aicoo-Team cd1295e 2.3 KB Updated Sep 17, 2026

File contents

Snapshots — Note Versioning

Save, list, and restore note versions using Aicoo OS endpoints.

Prerequisites

AICOO_API_KEY must be set
Base URL: https://www.aicoo.io/api/v1

API Endpoints

GET /api/v1/os/snapshots/{noteId}
POST /api/v1/os/snapshots/{noteId}
POST /api/v1/os/snapshots/{noteId}/restore

Save a Snapshot

curl -s -X POST "https://www.aicoo.io/api/v1/os/snapshots/42" \
  -H "Authorization: Bearer $AICOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"Before Q2 update"}' | jq .

List Snapshots

curl -s "https://www.aicoo.io/api/v1/os/snapshots/42?limit=10" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq .

Restore a Snapshot

curl -s -X POST "https://www.aicoo.io/api/v1/os/snapshots/42/restore" \
  -H "Authorization: Bearer $AICOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"versionId":7}' | jq .

Restore auto-backs up current state first.

Snapshot-Before-Edit Pattern

# 1) backup
curl -s -X POST "$PULSE_BASE/os/snapshots/42" \
  -H "Authorization: Bearer $AICOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"Pre-edit backup"}' | jq .

# 2) edit
curl -s -X PATCH "$PULSE_BASE/os/notes/42" \
  -H "Authorization: Bearer $AICOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"# Updated content..."}' | jq .

Scheduled Backup Pattern

# list notes in a folder
NOTES=$(curl -s "$PULSE_BASE/os/notes?folderId=5&limit=200" \
  -H "Authorization: Bearer $AICOO_API_KEY" | jq -r '.notes[].id')

# backup each
for id in $NOTES; do
  curl -s -X POST "$PULSE_BASE/os/snapshots/$id" \
    -H "Authorization: Bearer $AICOO_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"label\":\"Pre-sync $(date +%Y-%m-%d)\"}" | jq .success
done

Guest Access Guidance

Guest write scope still depends on notesAccess on the share link:

read: can view/search notes
write: can create notes
edit: can edit notes and use snapshots

---name: snapshotsdescription: 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'.---# Snapshots — Note VersioningSave, list, and restore note versions using Aicoo OS endpoints.## Prerequisites- `AICOO_API_KEY` must be set- Base URL: `https://www.aicoo.io/api/v1`## API Endpoints- `GET /api/v1/os/snapshots/{noteId}`- `POST /api/v1/os/snapshots/{noteId}`- `POST /api/v1/os/snapshots/{noteId}/restore`## Save a Snapshot```bashcurl -s -X POST "https://www.aicoo.io/api/v1/os/snapshots/42" \ -H "Authorization: Bearer $AICOO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"label":"Before Q2 update"}' | jq .```## List Snapshots```bashcurl -s "https://www.aicoo.io/api/v1/os/snapshots/42?limit=10" \ -H "Authorization: Bearer $AICOO_API_KEY" | jq .```## Restore a Snapshot```bashcurl -s -X POST "https://www.aicoo.io/api/v1/os/snapshots/42/restore" \ -H "Authorization: Bearer $AICOO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"versionId":7}' | jq .```Restore auto-backs up current state first.## Snapshot-Before-Edit Pattern```bash# 1) backupcurl -s -X POST "$PULSE_BASE/os/snapshots/42" \ -H "Authorization: Bearer $AICOO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"label":"Pre-edit backup"}' | jq .# 2) editcurl -s -X PATCH "$PULSE_BASE/os/notes/42" \ -H "Authorization: Bearer $AICOO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"content":"# Updated content..."}' | jq .```## Scheduled Backup Pattern```bash# list notes in a folderNOTES=$(curl -s "$PULSE_BASE/os/notes?folderId=5&limit=200" \ -H "Authorization: Bearer $AICOO_API_KEY" | jq -r '.notes[].id')# backup eachfor id in $NOTES; do curl -s -X POST "$PULSE_BASE/os/snapshots/$id" \ -H "Authorization: Bearer $AICOO_API_KEY" \ -H "Content-Type: application/json" \ -d "{\"label\":\"Pre-sync $(date +%Y-%m-%d)\"}" | jq .successdone```## Guest Access GuidanceGuest write scope still depends on `notesAccess` on the share link:- `read`: can view/search notes- `write`: can create notes- `edit`: can edit notes and use snapshots

Frequently asked questions