# Introduction Review Skill

> Introduction Review Skill

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

---


# Introduction Review Skill

Core loop: **normalize → run `cite_table.py` → relay table → self-audit**.

1. **LLM normalizes**: convert ANY citation format (`[REF01]`, `\cite{key}`, `[@key]`, bare `[1]`, etc) to `[CITE:descriptiveKey]`.
2. **Script verifies**: `cite_table.py` only reads `[CITE:key]`. Hard-coded, deterministic.
3. **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:

1. **Stacking** — >3 in one bracket? Warn. >5? Block.
2. **Format** — venue mismatch? Load `references/citation-formats.md` (on-demand) when user specifies a venue. Re-check after ref generation.
3. **Order** — gaps or jumps? Script catches this.
4. **Orphan** — in-text count != reference count? Report.
5. **Tone** — `references/diplomatic-critique.md` (loaded at startup). Never "fails to", "ignores", "fundamentally flawed".
6. **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) or `Smith [5] proposed` (author-attached). Script flags these as ⚠️.

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, `--bib` mode.