suzheng/k2f

k2f-fillable-pdf

Blueprint professional fillable PDF forms—applications, registrations, intake packets, and compliance worksheets—with clear field inventory, section flow, and print-friendly hierarchy before layout.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/suzheng/k2f --skill k2f-fillable-pdf

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

K2F Fillable Pdf — AI-Native Aesthetic Design

Purpose

Teach agents to author content_and_design.md 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.

Built on K2F

This skill produces fillable documents 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 (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.

When to Use

  • New application, registration, intake, onboarding, or compliance forms from requirements or an existing paper PDF.
  • Restructuring a cluttered legacy form before rebuild.
  • Splitting one long form into scannable sections while preserving exact legal or policy wording supplied by the user.

Workflow

Step 1. Generate the contentanddesign.md

One blueprint merging what readers see (static) and what they enter (interactive), plus design intent the engine can interpret. Use labeled blocks; map pages later in k2f.

Sub-steps

  1. 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.
  1. 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.
  1. 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.
  1. 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.
  1. 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.

Rules & constraints

  • Label clarity: every field answers “of what?” (“Work email”, not “Email”).
  • One question, one control pattern: exclusives = radio; multi = checkboxes; don’t mix.
  • Required honesty: mark optional fields; don’t default everything required.
  • Verbatim gate: policy, consent, and certification language copied from user sources only.
  • Completion path: last section includes certification name/date/signature fields when the use case needs it.

Common failure modes

  • Placeholder replaces the label → add visible labels; placeholders are hints only.
  • Fishing-expedition forms → cut fields without a stated reviewer or system use.
  • Random field order → reorder to scenario flow; group related rows.
  • Duplicate asks (city in two sections) → merge or cross-reference once.
  • Unspecified radio/checkbox options → list every option label explicitly.
  • Dense single-column marathon → split sections; use label+field pairs for short items.
  • Missing conditional logic → document show/hide rules beside affected fields.
  • Generic “form template” voice → set tone and issuer context in design intent.

Quality checklist

  • [ ] Every interactive control appears in the field inventory with type and required flag.
  • [ ] Section order matches completion scenario; tab flow is top-to-bottom, left-to-right within pairs.
  • [ ] Static instructions precede the fields they govern.
  • [ ] Choice fields list complete, non-overlapping options.
  • [ ] Legal or policy text is user-supplied and unchanged.
  • [ ] Design intent covers tone, hierarchy, density, and accent without layout coordinates.
  • [ ] No orphan labels or fields lacking purpose in the scenario.

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

Follow k2f to instantiate pages from the blueprint, bind field roles from the inventory, verify, and export the fillable PDF deliverable.

Related by task

from this repository

More skills

All skills
suzheng
Community

k2f-event-poster

Turn event briefs into wall- or screen-ready posters with headline zone, hero visual intent, and scannable logistics—not programs, slide decks, or handout flyers. Use when the user asks for an event poster, concert poster, festival promo, exhibition poster, meetup banner, or large-format promo. Create event posters 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

1h installs
19
GitHub stars
5
Updated
Nov 7
suzheng
Community

k2f-cv

Compile a complete academic or senior professional curriculum vitae from notes, publication lists, and appointment history—with correct section order, honest bibliographic detail, and readable long-list hierarchy (not a one-page job resume). Use when the user asks for a CV, curriculum vitae, academic vita, faculty application CV, or multi-page career record. Create cvs with AI-native design and the highest aesthetic standards, powered by the K2F format and engine. Purpose-built for AI agents, K2

1h installs
20
GitHub stars
5
Updated
Nov 7
suzheng
Community

k2f-sales-deck

Turn discovery notes, proposals, and product proof into buyer-ready sales decks with a prospect-centered story, one objective per meeting, and evidence-backed slides. Use when the user asks for a sales deck, demo presentation, proposal deck, executive briefing, or sales slides (not a fundraising pitch deck or generic company overview). Create sales decks with AI-native design and the highest aesthetic standards, powered by the K2F format and engine. Purpose-built for AI agents, K2F lets them foc

1h installs
19
GitHub stars
5
Updated
Nov 7
suzheng
Community

k2f-exam-paper

Design formal exam papers—midterms, finals, unit tests, or take-home assessments—from a syllabus, rubric, past papers, or source readings, with weighted coverage, unambiguous calls for response, and intentional answer space. Use when the user asks for an exam paper, test, quiz, final, midterm, or printable assessment to distribute to students. Create exam papers with AI-native design and the highest aesthetic standards, powered by the K2F format and engine. Purpose-built for AI agents, K2F lets

1h installs
8
GitHub stars
5
Updated
Nov 7