Teach agents to author
for forms people actually complete: explicit static copy, a complete field inventory with types and constraints, logical section flow, and aesthetic intent tuned for scanning and typing—not a generic questionnaire dump or a static PDF with boxes pasted on.
This skill produces fillable documents 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 (labels, field roles, instructions, grouping)—not pixel coordinates—while the engine compiles layout, typography, and interactive fields into consistent output.
Before you build, install the core skill:
npx skills add suzheng/k2f --skill k2f
.
-
Completion scenario — Who fills it (applicant, staff, patient), alone or with attachments, estimated time, submission path, and required vs optional sections. Drop fields that do not change an outcome.
-
Static layer — Title, version or effective date, issuer identity, short “how to complete” steps, privacy or retention notice only from user text, section introductions, and footers (page x of y, contact). Never invent legal clauses.
-
Field inventory — Table or structured list: stable id, human label, control kind (single-line text, multiline, checkbox, radio group, dropdown, date, signature attestation), required flag, placeholder or format hint, options for choice fields, max length or line count, help text one line max. Group radios and checkbox sets under one question with mutually exclusive or multi-select semantics spelled out.
-
Information architecture — Order for cognitive flow: identify → details → choices → authorization → review. Cluster 5–9 fields per section; start a new section when the topic shifts. Pair short labels with inputs in two-column rows; use full width for paragraphs, multiline answers, and declaration blocks. Specify conditional blocks (“show employer block only if Employment = Yes”) as explicit rules, not implied layout.
-
Design intent — Tone (institutional, clinical calm, friendly intake), hierarchy (title largest; section H2; labels medium weight; help text smaller/lighter), density (generous vertical rhythm; avoid wall-of-boxes), alignment (labels flush right or top-aligned in pairs; choice groups indented under question), accent (one color for section bars or required markers), contrast (WCAG AA on labels and instructions). State where checkboxes need a clear hit target vs inline legal text.