Phase 1: Extract Footnotes

SkillDocs & knowledge

Phase 1: Extract footnotes from DOCX with formatting annotations

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Phase 1: Extract Footnotes skill

What this skill tells your AI

The instructions your AI receives, as published by edwinhu/workflows in skills/bluebook-audit/skills/audit-extract/SKILL.md and read by ahel’s review.

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)"

Parse the DOCX file and build structured data for all subsequent phases.

What This Phase Does

  1. Parse word/footnotes.xml via lxml
  2. Extract each footnote's runs with formatting flags (italic, small caps, bold)
  3. Parse word/_rels/footnotes.xml.rels for hyperlink URLs
  4. Build citation registry (hereinafter definitions, author-to-first-cite mapping)
  5. Resolve cross-references (supra note [_] placeholders)
  6. Extract all URLs for archiving inventory

Script

uv run python3 "${CLAUDE_SKILL_DIR}/../../../../skills/bluebook-audit/scripts/extract_footnotes.py" --docx <path>

Output: scratch/footnotes_data.json

Gate: Exit Extract

Before proceeding to Check phase:

  • scratch/footnotes_data.json exists
  • Contains entries for ALL footnotes in the document (verify count)
  • Each entry has formatted_text field with inline markup
  • Citation registry has hereinafter definitions
  • URL inventory extracted

If footnote count doesn't match document: STOP. Investigate missing footnotes before proceeding.

Next Phase

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

Signals

GitHub stars
21
Forks
4
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
audit-extract
Source
github.com/edwinhu/workflows