# Pr Cache Cleanup

> Clean up local PR review cache files for merged or closed PRs. Use when user says "clean up cache", "cleanup merged PR caches", "remove old caches", "clear review cache", or wants to free up space from stale cache files.

- Skill: `marxbiotech/pr-cache-cleanup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add marxbiotech/pr-cache-cleanup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/marxbiotech/pr-cache-cleanup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: marxbiotech (https://skillmd.com/u/marxbiotech)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/marxbiotech/pr-cache-cleanup

---


# PR Cache Cleanup

Remove cache files for PRs that have been merged or closed.

## When to Use

Invoke this skill when:
- User wants to clean up stale cache files
- User says "clean up cache", "cleanup merged PR caches", "remove old caches", or "clear review cache"
- User wants to free up space from old cache files

**Note:** This skill has `disable-model-invocation: true` because it deletes files and should only be user-triggered.

## Workflow

### Step 1: Preview (Dry Run)

Always start with a dry run to show what would be deleted:

```bash
${CLAUDE_PLUGIN_ROOT}/scripts/cache-cleanup.sh --dry-run
```

### Step 2: Confirm with User

Present the preview results to the user:
- How many files would be deleted
- Which PRs they belong to
- PR states (MERGED, CLOSED, NOT_FOUND)

Ask for confirmation before proceeding.

### Step 3: Execute Cleanup

Only after user confirmation:

```bash
${CLAUDE_PLUGIN_ROOT}/scripts/cache-cleanup.sh
```

### Step 4: Report Results

Inform the user:
- Number of files deleted
- Number of files kept (open PRs)
- Any errors encountered

## Options

| Flag | Description |
|------|-------------|
| `--dry-run` | Preview only, don't delete |
| `--all` | Remove ALL cache files including open PRs (use with caution) |

## Example Output

```
=== PR Review Cache Cleanup ===

DRY RUN - no files will be deleted

Scanning cache files...

Would delete: .pr-review-cache/pr-123.json (PR #123, state: MERGED, cached: 2026-02-01T10:00:00Z)
Would delete: .pr-review-cache/pr-124.json (PR #124, state: CLOSED, cached: 2026-02-02T10:00:00Z)
Keeping: .pr-review-cache/pr-125.json (PR #125 is still open)

=== Summary ===
Would delete: 2 files
Kept: 1 files
```

## See Also

完整工作流程說明請參閱 [pr-review-workflow.md](../../docs/pr-review-workflow.md)。