DavidROliverBA/ArchitectKB / .claude/skills/archive-attachments
archive-attachments
Verified| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.3 KB |
SKILL.md
View on GitHub# Skill: Archive Orphaned Attachments
**Command:** `/archive-attachments [--dry-run]`
**Model:** 🟢 Haiku
**Agent:** None (direct execution)
## Purpose
Find and archive attachments that are not referenced in any vault note. Orphaned attachments waste storage and clutter the vault without adding value.
## When to Use
- During quarterly vault maintenance
- After bulk PDF/PPTX conversions that leave unreferenced files
- When Attachments folder grows unexpectedly
- Before committing large changes to reduce repo size
## Usage
```bash
# Preview what would be archived (recommended first step)
/archive-attachments --dry-run
# Archive orphaned files
/archive-attachments
```
## What It Does
1. **Scans all markdown and canvas files** for attachment references
2. **Identifies orphaned files** in `Attachments/` not referenced anywhere
3. **Moves orphans** to `Archive/Attachments/` preserving folder structure
4. **Updates manifest** at `Archive/Attachments/archive-manifest.json`
## Protected Files
These files are never archived:
- `.gitkeep`
- `.DS_Store`
- `README.md`
## Output
The script reports:
- Total orphaned files and size
- Breakdown by file type
- Files moved (or would move in dry-run)
## Implementation
Run the Python script:
```bash
python3 .claude/scripts/archive-orphan-attachments.py [--dry-run] [--verbose]
```
### Flags
| Flag | Description |
|------|-------------|
| `--dry-run` | Show what would be archived without moving files |
| `--verbose` | Show detailed file list |
## Manifest Format
The manifest tracks all archive operations:
```json
{
"created": "2026-02-01T08:26:26",
"last_updated": "2026-02-01T08:26:26",
"archives": [
{
"date": "2026-02-01T08:26:26",
"files_moved": 1176,
"total_bytes": 826369700,
"files": [
{
"filename": "example.png",
"original_path": "subfolder/example.png",
"size_bytes": 12345
}
]
}
]
}
```
## Restoring Files
If a file was archived by mistake:
1. Check the manifest for the original path
2. Move the file back from `Archive/Attachments/` to `Attachments/`
3. The next run will skip it if it's now referenced
## Related
- `/vault-maintenance` - Full quarterly health check
- `/quality-report` - Comprehensive vault metrics
- `npm run health` - Quick health check
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |