academic-writing-setup

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
name: academic-writing-setup
description: Set up Claude for academic writing — thesis, paper, or dissertation. Configures LaTeX/Typst stack, bibliography (Zotero + Better BibTeX), citation style, and strict no-invented-citations rules so Claude helps you write without hallucinating references.
---

# Academic Writing Setup

This skill configures Claude for the **output side** of academic work: writing theses, journal papers, conference submissions, dissertations, and abstracts. It pairs with `research-setup` (input side — reading papers, notes) and `knowledge-base-setup` (personal notes) but focuses on producing manuscripts.

Use this skill when the project is primarily a LaTeX or Typst document, not a literature survey or a generic research notebook.

**Handoff context:** Read `skills/_shared/consume-handoff.md` and run it with the handoff block (if any). The helper guarantees the following locals: `detected_language`, `existing_claude_md`, `inferred_use_case`, `repo_signals`, `graphify_candidate`. Use `detected_language` for all user-facing prose; generated file content stays in English.

**Cascade mode:** When the handoff context carries `source_skill: "research-setup"`, this skill is running as the second leg of a cascade invoked from `research-setup`. In that mode:

- Do NOT re-run language detection — use the parent's `detected_language` directly.
- If `superpowers_offered: true`, SKIP the Superpowers offer in Step 1 entirely. Treat `superpowers_installed` as whatever the parent resolved it to. Do not re-prompt the user.
- All other steps (toolchain probe, Q1–Q6 context questions, artifact generation, subagent offer, hook offer) still run. The user explicitly opted into the writing-side setup; they still need to answer discipline / stack / citation-style questions.

On direct or orchestrator dispatch, both markers are absent and this skill behaves exactly as before.

**Existing CLAUDE.md:** If `existing_claude_md: true`, DO NOT overwrite it. Append a new delimited section at the end of the file:

```
<!-- onboarding-agent:start setup=academic-writing skill=academic-writing-setup section=claude-md -->
## Claude Onboarding Agent — Academic Writing Setup
...generated content...
<!-- onboarding-agent:end -->
```

If the delimited block already exists from a previous run (either the attributed form above or the legacy unattributed `<!-- onboarding-agent:start -->` form), replace only the content between the markers; leave the rest of the file untouched. Upgrade the opening marker to the attributed form — `/upgrade-setup` depends on it for detection.

## Supporting Files

Read these on-demand at the step that invokes them. Do not read eagerly.

- `rule-file-templates.md` — bodies of the `.claude/rules/*.md` files (Step 4)
- `document-skeletons.md` — directory scaffold, `main.tex`, `main.typ`, `bib/references.bib` (Step 4)
- `gitignore-block.md` — the `.gitignore` block (Step 4)
- `optional-integrations.md` — `.pre-commit-config.yaml`, Overleaf instructions, template pointer, KB bridge (Step 4)
- `skills/_shared/consume-handoff.md` — orchestrator handoff parse + inline fallback (preamble, before Step 1)
- `skills/_shared/offer-superpowers.md` — canonical Superpowers opt-in (Step 1)

## Step 1: Install Dependencies

If cascade mode is active (`source_skill: "research-setup"` AND `superpowers_offered: true` on the handoff context), skip this step entirely — the parent already asked the user and `superpowers_installed` / `superpowers_scope` / `superpowers_method` are already resolved. Do not re-prompt.

Otherwise: read `skills/_shared/offer-superpowers.md` and run it with `skill_slug: academic-writing-setup`, `mandatory: false`, `capability_line: "A widely used free Claude Code skills library. Brainstorming and planning skills help structure long arguments, chapter outlines, and multi-section revisions."` The helper asks the user, delegates to `skills/_shared/installation-protocol.md` on `yes`, and sets `superpowers_installed`