SKILL.md for Agents

Give your AI agent a SKILL.md file and it will set up ClawKeep automatically — install the CLI, create a workspace, and back up before risky changes. You don't configure anything.

What is a skill file?

A SKILL.md is a markdown file that teaches an AI agent how to use a tool. When you add it to your agent's context (Claude, Cursor, Copilot, etc.), the agent reads it and knows exactly what to do.

ClawKeep's skill file tells the agent:

  • When to create backups (before refactors, dependency updates, risky changes)
  • How to install and authenticate ClawKeep
  • How to create workspaces and run syncs
  • How to restore if something goes wrong

Download the skill file

curl -o SKILL.md https://raw.githubusercontent.com/taco-devs/clawkeep/main/skills/clawkeep-cloud/SKILL.md

Or view it on GitHub: skills/clawkeep-cloud/SKILL.md

How to use it

With Claude Code

Place the file in your project root or add it to your CLAUDE.md:

# In your project root
cp SKILL.md .claude/skills/clawkeep.md

# Or reference it in CLAUDE.md
# See skills/clawkeep.md for backup instructions

With Cursor

Add to your project's .cursorrules or paste the content into the system prompt.

With any agent

Any agent that reads markdown context can use the skill file. Just include it in the agent's context window before starting work.

What the agent does

Once the agent has the skill file in context, it will automatically:

  1. Check if ClawKeep is installed — if not, runsnpm install -g clawkeep
  2. Check authentication — if not logged in, asks you for an API key
  3. Create a workspace — one per project, named after the project directory
  4. Back up before risky changes — the agent runsclawkeep backup sync before refactors, dependency updates, or config changes
  5. Restore if needed — if something breaks, the agent knows how to restore from a snapshot

Example session

You: "Refactor the auth module to use JWT instead of sessions"

Agent: I'll back up the project first in case we need to roll back.

$ clawkeep backup sync
Encrypted 1,247 files (32 MB)
Uploaded to workspace in 2.1s
✓ Backup complete

Now I'll start the refactor...

[...agent refactors code...]

Agent: The refactor introduced a type error in 3 files. Let me
restore the auth module and try a different approach.

$ clawkeep restore ./src/auth/ --at 2026-02-09T14:30
Restored 12 files to snapshot feb-9-1430
✓ Restored

Prerequisites

Before using the skill file, make sure:

  • You have a ClawKeep account (sign up free)
  • You've generated an API key from the dashboard
  • Node.js 18+ is available in the agent's environment

The skill file will prompt you for the API key if the agent isn't authenticated yet.

Customizing the skill

The skill file is just markdown. You can customize it for your workflow:

  • Backup frequency — change when the agent backs up (e.g., before every commit, only before major changes)
  • Exclude patterns — tell the agent to add specific patterns to .clawkeepignore
  • Workspace naming — customize how workspaces are named
  • Restore policy — define when the agent should auto-restore vs. ask you first

Security considerations

  • The skill file never contains your API key — the agent stores it in~/.clawkeep/credentials after you provide it once
  • Backups are encrypted before upload — the agent can't read other users' data even if it tried
  • The agent only has access to workspaces associated with your API key