---
name: Academic Reference Inserter
slug: academic-reference-inserter-2
category: Writing
description: Academic Reference Inserter inserts, formats, and cross-references citations in Word .docx documents. Use it to switch styles like GB/T 7714, IEEE, or APA 7th and validate reference order.
github: "https://github.com/fuwenhao12/academic-ref-inserter/tree/main/.kimi/skills/academic-ref-inserter"
language: Python
stars: 55
forks: 1
install: "npx degit https://github.com/fuwenhao12/academic-ref-inserter/tree/main/.kimi/skills/academic-ref-inserter ~/.claude/skills/academic-ref-inserter"
installs_to: ~/.claude/skills/academic-ref-inserter
source_path: .kimi/skills/academic-ref-inserter/SKILL.md
collection_size: 4
category_size: 1012
collection_url: "https://dirskills.com/collections/fuwenhao12/academic-ref-inserter"
added: 2026-08-12T04:44:06.477Z
last_synced: 2026-08-12T04:44:06.477Z
canonical_url: "https://dirskills.com/skills/academic-reference-inserter-2"
---

# Academic Reference Inserter

Academic Reference Inserter inserts, formats, and cross-references citations in Word .docx documents. Use it to switch styles like GB/T 7714, IEEE, or APA 7th and validate reference order.

**Install:**

```bash
npx degit https://github.com/fuwenhao12/academic-ref-inserter/tree/main/.kimi/skills/academic-ref-inserter ~/.claude/skills/academic-ref-inserter
```

## README

# Academic Reference Inserter

Insert, format, and cross-reference academic citations in Word (.docx) documents.

## When to Use

Use this skill when the user asks to:
- Insert or format academic citations in a .docx paper
- Change citation style (e.g., to IEEE, GB/T 7714, or APA)
- Add clickable cross-reference hyperlinks for citations
- Validate reference formatting
- Reorder references to match citation order

## CLI Reference

All commands support `--json` for structured output.

```bash
# Full pipeline (recommended)
python scripts/insert_refs.py fix --input paper.docx --format gbt7714

# Analyze current state
python scripts/insert_refs.py analyze --input paper.docx --json

# Change format
python scripts/insert_refs.py reformat --input paper.docx --format ieee

# Reorder references
python scripts/insert_refs.py reorder --input paper.docx

# Add hyperlinks
python scripts/insert_refs.py hyperlink --input paper.docx

# Validate
python scripts/insert_refs.py validate --input paper.docx --format gbt7714 --json
```

## Supported Formats

| Format | Flag | Ordering |
|--------|------|----------|
| GB/T 7714-2015 (Chinese) | `gbt7714` | Sequential [1] |
| IEEE (Engineering/CS) | `ieee` | Sequential [1] |
| APA 7th (Social Sciences) | `apa7` | Author-Year alphabetical |

## Workflow

1. Always run `analyze --json` first to understand the document state
2. Choose format based on user's target journal
3. Run `fix --format <name>` for the full pipeline
4. Validate with `validate --json`
5. Report summary to user

## File Locations

- Main script: `scripts/insert_refs.py`
- Format implementations: `scripts/formats/`
- Utilities: `scripts/utils/`
- Full skill definition: `.trae/skills/academic-ref-inserter/SKILL.md`

## Requirements

```bash
pip install python-docx
```

Python 3.8+ required.