haiyichen001 Introduction Review Skill
Core loop: normalize → run cite_table.py → relay table → self-audit.
- LLM normalizes: convert ANY citation format (
[REF01],\cite{key},[@key], bare[1], etc) to[CITE:descriptiveKey]. - Script verifies:
cite_table.pyonly reads[CITE:key]. Hard-coded, deterministic. - Table proves: every normalized citation appears in the output — nothing missed or invented.
When NOT to Use
Single-paper summary, pure grammar polishing, non-academic writing, format conversion only.
Phase 0: Environment Check
Run bash ${CLAUDE_SKILL_DIR}/scripts/setup.sh. Checks Python 3.10+, rich, MCP servers (arxiv, scholar, paper-search, pdf-reader). Warn if missing, don't block.
Four Scenarios
| User says | Agent does |
|---|---|
| New review | Draft with [CITE:xxx] → script → table |
| Add citation | Insert [CITE:xxx] → re-run script → table |
| Remove citation | Remove [CITE:xxx] → re-run script → table |
| Audit | Re-run script → checks → table |
Every scenario ends: cite_table.py → Read cite_output.txt → paste table + checks.
Always-On Checks
After every citation change, re-run cite_table.py and walk through:
- Stacking — >3 in one bracket? Warn. >5? Block.
- Format — venue mismatch? Load
references/citation-formats.md(on-demand) when user specifies a venue. Re-check after ref generation. - Order — gaps or jumps? Script catches this.
- Orphan — in-text count != reference count? Report.
- Tone —
references/diplomatic-critique.md(loaded at startup). Never "fails to", "ignores", "fundamentally flawed". - Citation depth — most citations: who + did what + found what + [N]. Opening/transition sentences can be broad. Body paragraphs: each cited paper gets its own sentence.
- Two valid positions: sentence-end (
...reduced errors by 23% [5].) or natural pause (...as shown in prior work [5,6], the trend...). - NEVER:
, [5],(comma sandwich) orSmith [5] proposed(author-attached). Script flags these as ⚠️.
- Two valid positions: sentence-end (
Report: one line per check, ✅ or ⚠️. Then full re-scan (never fix one and skip the rest). Then read all [N] aloud to catch awkward flow.
Table Protocol (Mandatory)
Auto-detect .bib file in project dir. If found, use --bib mode.
python ${CLAUDE_SKILL_DIR}/scripts/cite_table.py <draft> [--bib <bib_file>]
Read: ${CLAUDE_SKILL_DIR}/scripts/cite_output.txt
→ Paste table + audit. Then: "Need to add, remove, or change any citations?"
Without --bib: 5 columns (# | Author | Body Context | Reference | Status). With --bib: 6 columns comparing body order, bib key, bib position, and reference list order. Bilingual (中文/English auto-detected). Repeated citations get ↳ sub-rows.
Reference Files
anti-laziness-protocol.md— loaded at startup. Mandatory 5-step verification gate. Itemized only, no batching.citation-placement-rules.md— loaded at startup. Per-citation placement enforcement.diplomatic-critique.md— loaded at startup. Mandatory tone guard.citation-formats.md— loaded on-demand when user specifies a venue. IEEE/SCI/EI/GB7714/APA/MLA/Chicago/ACM rules.
Script
cite_table.py— single core engine. Scan, number, table, position check, bilingual,--bibmode.