Teach agents to blueprint publishable manuscripts before layout: a sharp contribution claim, venue-appropriate structure, mapped evidence, and design intent that reads like a serious journal—not a generic essay or oversized blog post.
This skill produces manuscripts as
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 (section roles, arguments, figures)—not pixel coordinates—while the engine compiles layout, typography, and theme into consistent output across PDF, DOCX, PPTX, and IDML.
Before you build, install the core skill:
npx skills add suzheng/k2f --skill k2f
.
One blueprint for semantic content and aesthetic intent. Use labeled blocks the k2f skill can map to document structure later.
-
Venue & scope lock — Paper type (empirical IMRaD, theory, review, case study, short conference), discipline, target venue or rubric, word/page limits, required back matter (ethics, data availability, contributions). Note citation style as metadata only. Cut anything outside limits before drafting.
-
Contribution thesis — One paragraph: research question, gap, and what this paper adds (finding, method, dataset, or framework). Cap at one to three concrete contributions; demote extras to future work.
-
Structure selection — Pick a pattern that matches the paper type (e.g., IMRaD; review with thematic sections; theory with formal claims). List top-level sections in submission order with word budgets summing to the limit (±10%).
-
Section outline & evidence map — Per section: purpose, 3–6 bullet claims, and evidence tags (
,
,
,
,
). Introduction ends with contribution preview; Methods holds reproducibility detail; Results reports outcomes without interpretation; Discussion interprets, limits, and situates—no new primary results.
-
Argument blueprint — Chain claims to support: each major claim names its evidence source. Flag absence claims only when the user supplied a documented search scope. Plan limitations and threats to validity explicitly.
-
Abstract & keywords — Structured abstract (background → gap → approach → main result → implication) with a word cap from the venue. Keywords as concepts, not sentence fragments. If two abstract languages are required, specify both as independent compositions aligned in structure, not literal translation.
-
Visual plan — Assign each quantitative or structural idea to figure, table, or schematic—not a long paragraph. Note caption takeaway (one sentence), colorblind-safe palette intent, and where a chart replaces prose in Results.
-
Design intent — Tone, hierarchy, density, palette for the engine:
- Tone: discipline-appropriate register; precise terms over promotional language.
- Hierarchy: title and abstract highest contrast; section headings conclusion-oriented (“X reduces Y under Z”) where the venue allows; Methods subheads procedural.
- Density: Introduction and Discussion narrative with short paragraphs; Methods and Results bullet- or table-led; no paragraph longer than ~6 lines without a break, list, or visual.
- Palette: calm academic (neutral body, one accent for headings, figure callouts, and key statistics); high contrast for print; minimal decoration.