# maxxing-backup

The maxxing-backup skill for Claude Code saves the agent's memory workspace to a private GitHub repository. It runs on a daily schedule or upon specific user commands.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 285 repo stars
- Author: makushingu
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/maxxing-backup/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/maxxing-backup

## What it does

This tool creates backups of essential workspace files such as task lists, configuration files, and memory logs. An integrated secret scanner inspects data for sensitive credentials or keys before any push, preventing leaks by stopping the upload.

It supports restoring damaged workspace states and migrating installations to new servers. You need a private GitHub repository and a fine-grained token with content write permissions to get started.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-backup -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/maxxing-backup/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/maxxing-backup/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-backup -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/maxxing-backup/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-backup -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/maxxing-backup/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makushingu/harness-maxxing skills/maxxing-backup
```

2. **Manually: put the files in place**
- File: `.github/skills/maxxing-backup/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-backup -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/makushingu/harness-maxxing --path skills/maxxing-backup
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/maxxing-backup/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/maxxing-backup/SKILL.md

## When to use it
- automatically back up agent memory
- migrate setup to a new server
- recover damaged workspace files
- prevent accidental secret commits to git

## Example prompts
- maxxing backup run — to trigger an immediate backup
- maxxing backup status — to check the last successful backup
- maxxing backup restore — to recover files from the repository

## Similar
- [gitbackup-github-desktop](https://affpapa.org/en/nevibecode/skills/gitbackup-github-desktop.md) — skill · 278 installs
- [claudebase](https://affpapa.org/en/nevibecode/plugins/claudebase.md) — plugin · ★ 27 repo stars
- [clawdbot-backup](https://affpapa.org/en/nevibecode/skills/clawdbot-backup.md) — skill · 231 installs
- [recipe-backup-sheet-as-csv](https://affpapa.org/en/nevibecode/skills/recipe-backup-sheet-as-csv.md) — skill · 32100 installs
- [openclaw-backup](https://affpapa.org/en/nevibecode/skills/openclaw-backup.md) — skill · 3100 installs
- [cli-backup-sync](https://affpapa.org/en/nevibecode/skills/cli-backup-sync.md) — skill · 1300 installs

From the same set: [makushingu/harness-maxxing](https://affpapa.org/en/nevibecode/by/makushingu/harness-maxxing.md) — 21 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
