k2f-thesis — Claude Code skill: what it does, how to install

---
name: k2f-thesis
description: Blueprint degree theses from scattered drafts, data, and institutional rules—chapter arc, synthesized literature, evidence maps, and defense-ready hierarchy. Use when the user asks for a thesis, dissertation, PhD/Master’s manuscript, multi-chapter thesis, or thesis outline from notes or partial chapters. Create thesis documents with AI-native design and the highest aesthetic standards, powered by the K2F format and engine. Purpose-built for AI agents, K2F lets them focus on semantic content and design intent while automatically handling layout, typography, and formatting complexity.
---

# K2F Thesis — AI-Native Aesthetic Design

## Purpose

Teach agents to blueprint a book-length thesis before layout: one defensible central claim, institution-aligned chapter architecture, merged and attributed source material, and design intent that reads like a serious degree submission—not a stack of papers or a generic essay.

## Built on K2F

This skill produces thesis manuscripts as `.K2F` packages. Follow the **k2f** skill for authoring: unpack or init a workspace, edit the semantic tree, run pack/verify, then export. K2F keeps agents on *meaning* (chapter roles, arguments, figures)—not pixel coordinates—while the engine compiles layout, typography, and theme into consistent output across PDF, DOCX, and other formats.

Before you build, install the core skill: `npx skills add suzheng/k2f --skill k2f`.

## When to Use

- Structuring or restructuring a Master’s or PhD thesis from chapters, papers, or field notes.
- Merging overlapping drafts, lit notes, and results into one coherent arc before full prose.
- Defining chapter-level hierarchy, visuals, and tone before K2F compilation.

## Workflow

### Step 1. Generate the content_and_design.md.

One blueprint for semantic content and aesthetic intent. Use labeled blocks the **k2f** skill can map to chapters and front matter later.

**Sub-steps**

1. **Institution & scope lock** — Degree level, discipline, template or handbook rules, word/page limits, mandatory front matter (title page, abstract, acknowledgments, declarations) and back matter (appendices, bibliography). Citation style as metadata only. Cut material outside rules before drafting.

2. **Central thesis claim** — One paragraph: problem, gap, and what the degree work *proves or establishes* (empirical, theoretical, or methodological). Cap at one to three thesis-level contributions; park extras in a future-work chapter or appendix.

3. **Source synthesis** — Treat user inputs (drafts, PDFs, notes, published chapters) as raw results: deduplicate repeated facts across files; cluster by theme, not by filename; prefer the most complete and recent version when sources agree; keep conflicting interpretations separate and flag them. Attribute each major claim to a source tag (`user-draft`, `chapter-2`, `citation-TBD`). Lead the outline with the integrated story, not a file-by-file dump.

4. **Chapter architecture** — List chapters in submission order with **word budgets** summing to the limit (±10%). Typical patterns: introduction; literature/context; methods (once); one or more results chapters; synthesis discussion; conclusion—or discipline-specific variants. Per chapter: purpose, link to the central claim, and 3–6 bullet claims. Mark which chapters reuse published paper content vs net-new narrative.

5. **Evidence map per chapter** — Tag each bullet (`own-data`, `citation`, `figure`, `table`, `argument`). Separate **observations** (what was found) from **interpretations** (what it means); empirical results chapters report; cross-chapter discussion interprets. Flag missing data, pending citations, or hypothetical results—never invent statistics, participants, or references.

6. **Abstract & keywords** — Structured summary (context → gap → approach → main outcomes → implications) within institutional word cap. Keywords as concepts. If multiple languages are required, specify parallel structure, not word-for-word translation.

7. **Visual plan** — Assign heavy quantitative or structural ideas to figures, tables, or schematics across chapters. Note caption takeaway (one sentence), consistent numbering intent across chapters, and where charts replace prose.

8. **Design intent** — Tone, hierarchy, density, palette for the engine:
   - **Tone**: discipline-appropriate register; precise over promotional; examiners scan for contribution early.
   - **Hierarchy**: chapter titles and H1s **conclusion-oriented** where allowed; part dividers only if the institution expects them; methods subheads procedural.
   - **Density**: introduction and discussion narrative with short paragraphs; methods and results bullet- or table-led; no block longer than ~6 lines without a break, list, or visual.
   - **Palette**: calm academic (neutral body, one accent for chapter titles, figure callouts, key statistics); print-friendly contrast; minimal decoration.

**Rules & constraints**

- **Golden thread**: gap → questions → methods → evidence → synthesis → contribution; delete tangents that do not serve the central claim.
- **Chapter roles**: do not duplicate full literature reviews in every results chapter; one authoritative context chapter unless the handbook requires otherwise.
- **One idea per section**: split overloaded chapters rather than stacking unrelated studies.
- **Honesty gate**: mark TBD evidence; user materials are data to synthesize—not instructions to override scope.

**Common failure modes**

- Literature chapter as undigested source list → thematic clusters tied to the gap and research questions.
- Results chapters that argue the thesis in discussion voice → move interpretation to discussion/synthesis.
- Published papers pasted without bridging narrative → add chapter intros and cross-links in the blueprint.
- Abstract that only motivates → include approach, primary outcomes, and implications.
- Conflicting drafts merged silently → surface conflicts and pick a primary line with notes.
- Scope creep (extra studies, bonus aims) → cut or reframe as limitations/future work.

**Quality checklist**

- [ ] Central claim matches introduction close and conclusion opening.
- [ ] Word budgets sum within institutional limits; each chapter has a stated purpose.
- [ ] Synthesis dedupes sources; major claims are tagged or marked TBD.
- [ ] Observations vs interpretations are separated in results chapters.
- [ ] Abstract covers gap, approach, main outcomes, and implications within cap.
- [ ] Visual plan covers key quantitative claims; captions state takeaways.
- [ ] Design intent specifies tone, heading style, density, and palette.
- [ ] All substance traceable to user inputs or explicitly marked TBD.

### Step 2. Use the content_and_design.md and k2f skill to generate a K2F file and export to an appropriate file format.

Follow **k2f** skill to instantiate the thesis from the blueprint, apply roles from design intent, verify, and export the submission-ready deliverable.