$npx -y skills add iOfficeAI/OfficeCLI --skill officecli-academic-paperUse this skill to build academic-style .docx output: journal / conference / thesis chapters carrying formal citation style (APA, Chicago, IEEE, MLA), numbered equations, figure & table cross-references, footnotes/endnotes, bibliography, or multi-column journal layout. Trigger on:
| 1 | # OfficeCLI Academic Paper Skill |
| 2 | |
| 3 | **This skill is a scene layer on top of `officecli-docx`.** Every docx hard rule — style architecture, heading hierarchy, shell quoting, page-break rules, live PAGE field, Delivery Gate, renderer quirks — is inherited, not re-taught. This file adds only what academic papers need on top: citation styles, equations, SEQ / PAGEREF cross-refs, multi-column journal layout, bibliography hanging indent, abstract/keywords/affiliation block. |
| 4 | |
| 5 | When the docx base rules cover it, the text here says `→ see docx v2 §X`. Read docx v2 first if you have not. |
| 6 | |
| 7 | ## Setup |
| 8 | |
| 9 | If `officecli` is missing: |
| 10 | |
| 11 | - **macOS / Linux**: `curl -fsSL https://d.officecli.ai/install.sh | bash` |
| 12 | - **Windows (PowerShell)**: `irm https://d.officecli.ai/install.ps1 | iex` |
| 13 | |
| 14 | Verify with `officecli --version` (open a new terminal if PATH hasn't picked up). If install fails, download a binary from https://github.com/iOfficeAI/OfficeCLI/releases. |
| 15 | |
| 16 | ## ⚠️ Help-First Rule |
| 17 | |
| 18 | **This skill teaches what an academic paper requires, not every command flag.** When a prop name, enum value, or field instruction is uncertain, consult help BEFORE guessing. |
| 19 | |
| 20 | ```bash |
| 21 | officecli help docx # All docx elements |
| 22 | officecli help docx <element> # Full schema (e.g. section, equation, field, footnote) |
| 23 | officecli help docx <element> --json # Machine-readable |
| 24 | ``` |
| 25 | |
| 26 | Help is pinned to the installed CLI version. **When this skill and help disagree, help wins.** Every `--prop X=` in this file has been grep-verified against `officecli help docx <element>` — if help adds / renames a prop in a later version, trust help. |
| 27 | |
| 28 | ## Mental Model & Inheritance |
| 29 | |
| 30 | **Inherits docx v2.** You should have read `skills/officecli-docx/SKILL.md` first. This skill assumes you know how to add paragraphs, set styles, build tables, insert images, manage TOC/footer/headers, force page breaks, and run the Delivery Gate. If any of those are unfamiliar, open a second session on docx v2 before continuing. |
| 31 | |
| 32 | ## Shell & Execution Discipline |
| 33 | |
| 34 | **Shell quoting, incremental execution, `$FILE` convention** → see docx v2 §Shell & Execution Discipline. The same rules apply here verbatim — quote `[N]` paths, single-quote any value containing `$` (including `$2.8B` in a body paragraph or `@` DOIs), never hand-write `\$ \t \n` in executable examples, one command at a time. Academic-paper examples below use `$FILE` as a shell variable (`FILE="thesis.docx"`). |
| 35 | |
| 36 | ## What "academic" means here (identity) |
| 37 | |
| 38 | An academic paper is a docx with a **scholarly layer** on top: verifiable citations, precise equations, cross-refs that stay in sync, a formatted reference list. The base docx rules still apply; academic adds six deltas: |
| 39 | |
| 40 | 1. **Citation style is a contract.** APA / Chicago / IEEE / MLA each dictate author format, date placement, reference-list order, in-text marker shape. Pick one at the start; every later decision (hanging indent, footnote vs parenthetical, `[1]` vs `(Smith, 2024)`) follows. |
| 41 | 2. **Equations are first-class content** — inline `oMath` inside prose, display `oMathPara` as standalone blocks, optionally numbered. |
| 42 | 3. **Figures and tables auto-number.** `SEQ Figure` / `SEQ Table` fields count them; `PAGEREF` links "see Fig. 2" to its live page number. |
| 43 | 4. **Bibliography uses hanging indent** (first line flush left, continuation lines indented). Not first-line indent. Not left indent alone. Hanging. |
| 44 | 5. **Abstract / keywords / affiliation block** is a first-page three-piece, not a cover in the marketing sense. Block-style abstract, no first-line indent, no decoration. |
| 45 | 6. **Multi-column layout** appears in IEEE / ACM / Nature / many journals: single-column abstract + two-column body. |
| 46 | |
| 47 | ### Reverse handoff — when to go BACK to docx |
| 48 | |
| 49 | Stay in **docx v2** for white papers, policy briefs, technical reports, HR templates — anything without a venue / citation style. Use **this skill** only when the document will carry at least TWO of: citation-style biblio, equations, SEQ/PAGEREF cross-refs, multi-column, abstract + keywords block. |
| 50 | |
| 51 | ## Workflow — 5 verbs |
| 52 | |
| 53 | 1. **Read the venue spec.** APA 7 / Chicago 17 / IEEE / MLA 9 / journal-specific. Line spacing, font, citation shape, biblio sort order — everything downstream follows from this one decision. |
| 54 | 2. **Plan the sections.** Abstract → keywords → introduction → methods → results → discussion → conclu |