Teach agents to author
for
single-page decision and narrative documents: what belongs on one page, how to tier information for executive scan, and aesthetic intent (tone, hierarchy, density)—not K2F packaging or export.
This skill produces one pagers as
packages. Follow the
k2f skill for authoring: unpack or init a workspace, edit the semantic tree, pack/verify, and export. K2F keeps agents on
meaning (sections, claims, evidence shapes, CTA)—not coordinates—while the engine compiles layout, typography, and theme into export-ready output.
Before you build, install the core skill:
npx skills add suzheng/k2f --skill k2f
.
-
One-pager lock — The one job (approval, release summary, solution sell). Audience, channel (print PDF, email, wiki), and genre—pick one archetype; do not merge incompatible skeletons.
-
Archetype & section order — Fixed vertical stack with headings:
- Decision / product: thesis → problem (pain + why now) → solution (what, not UI) → users → metrics (baseline + target) → in/out scope → constraints → open questions → optional owner/next step.
- Release / changelog: version, date, summary → Added → Fixed → Breaking → Known issues → Upgrade note → CTA only with a real destination.
- Solution / company: audience → one-line offer → three differentiators → proof → optional pricing → one next step.
- Initiative pitch: problem → approach → impact → resources/timeline → ask → risks.
-
Scan layers — Glance: title, thesis, hero metric or version. Scan: 2–4 bullet blocks. Detail: sources and fine print—subordinate to thesis.
-
Content tiers — Thesis (page story), Evidence (numbers, quotes, lists), Boundary (scope, constraints, explicit “none”). Second-page material → cut or appendix link.
-
Honesty — No invented metrics, dates, customers, or breaking changes. Missing input →
,
, or
; unknown version/date →
with label.
-
Cut pass — Drop essays, feature catalogs, APIs, duplicate metrics. Replace vague goals with measurable outcomes or TBD. One primary CTA; extras in a contact line.
-
Design intent (no coordinates):
- Tone: evidence-led for decisions; factual for releases; confident solution voice only with proof—one adjective pair.
- Hierarchy: thesis largest; consistent section labels; hero metric/version as anchor; boundaries smallest.
- Density: ~250–450 words unless user overrides; bullets over prose; ~5 bullets max per block; short parallel columns for in/out scope only.
- Rhythm: mix bullets with one visual intent (metric row, logo band, timeline chips)—avoid bullet walls.
- Contrast: light ground, accent on thesis/metrics/CTA; readable brand colors.