audit-archive

Phase 6: Archive URLs via perma.cc

SKILL.md

GitHub

Phase 6: Archive

What this skill carries — grep references/ for any subject the names below miss: !d=${CLAUDE_SKILL_DIR}; command -v skill-toc >/dev/null 2>&1 && exec skill-toc "$d"; s=$HOME/.claude/skills/plugin-utils/bin/skill-toc; [ -x "$s" ] && exec "$s" "$d"; echo "(skill-toc unavailable: references and scripts are NOT listed here — install the plugin-utils plugin, or start a new session so its bin/ reaches PATH)"

Archive all non-permanent URLs in footnotes via perma.cc API.

What This Phase Does

  1. Extract URL inventory from footnotes data
  2. Deduplicate URLs (same URL across multiple footnotes)
  3. Archive each URL via perma.cc API
  4. Write perma.cc links back to DOCX footnotes
  5. Save progress after each successful archive

Prerequisites

  • Perma.cc API key in .env file (project-level or user home directory)
  • For institutional accounts: organization folder ID (unlimited archives)
  • Free accounts: 10 links/month limit

Script

uv run python3 "${CLAUDE_SKILL_DIR}/../../../../skills/bluebook-audit/scripts/permacc_archive.py" --docx <path> --data scratch/footnotes_data.json

Institutional Account Setup

# Find your organization and folder ID
curl -H "Authorization: ApiKey YOUR_KEY" https://api.perma.cc/v1/organizations/

Use the folder parameter when creating archives:

requests.post("https://api.perma.cc/v1/archives/", json={
    "url": url,
    "folder": FOLDER_ID,  # enables institutional limits
})

Gate: Exit Archive

  • All non-perma.cc URLs archived
  • perma.cc links written to DOCX
  • scratch/permacc_archives.json contains all mappings

Next Phase

Read ${CLAUDE_SKILL_DIR}/../../../../skills/bluebook-audit/skills/audit-crossrefs/SKILL.md and follow its instructions.