This skill produces case studies 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, narrative beats, visual placeholders)—not pixel coordinates—while the engine compiles layout, typography, and theme into consistent output across PDF, PPTX, DOCX, and other formats.
Before you build, install the core skill:
npx skills add suzheng/k2f --skill k2f
.
Single blueprint for semantic content and aesthetic intent. Use labeled blocks the k2f skill can map to sections and visuals later.
-
Story charter — Primary reader (recruiter skim, hiring manager, client prospect), target read depth (3–5 min essential path vs 10–15 min optional depth), and the one outcome that earns attention. List inputs the user provided; mark gaps instead of inventing metrics, quotes, or artifacts.
-
Role clarity — Your title, team size, timeline, scope, and your contributions vs collective work. Write contribution claims in first person; attribute team-owned areas explicitly.
-
Information architecture — Default spine (shorten for skim-only audiences):
- Hero / quick facts: project name, hook metric or outcome, role, timeline, team—scannable metadata strip.
- Overview: 2–3 sentences; what was delivered and why it mattered.
- Problem / challenge: business context, user or customer pain, goals, constraints—why this work was worth doing.
- Process: research and discovery, options explored (breadth), decisions and rationale (depth), iteration from feedback or tests—highlight pivots and insights, not a diary of every meeting.
- Solution: walkthrough of what shipped; key features or deliverables tied back to stated pains; note where visuals carry the story (before/after, flows, architecture diagram).
- Results / impact: quantitative outcomes with timeframe and baseline; qualitative signals; business impact; optional “what we’d do differently.”
- Reflection (optional for portfolio): learnings, skills grown, influence on later work.
- Visual asset list: each planned image with caption intent, sensitivity redactions, and whether it is essential or nice-to-have.
-
Audience emphasis — Adjust depth without changing facts: PM/strategy (prioritization, trade-offs, metrics); design/UX (research, iterations, usability); engineering (architecture, constraints, performance); marketing (audience, creative, ROI). Cut sections that do not serve the charter reader.
-
Design intent — Document tone, hierarchy, density, and palette for the engine:
- Tone: credible storyteller—specific, modest where evidence is thin; no hype or generic “passion” filler.
- Hierarchy: lead with the strongest outcome in hero and overview; process subheads surface decisions and insights; results use numbers as visual anchors.
- Density: short paragraphs and bullets; one idea per block; tables for metric before/after; push long methodology to optional subsections or appendix intent.
- Visual rhythm: alternate narrative blocks with figure roles; favor journey (sketch → iteration → final) over a single polished screenshot; consistent figure sizing and explanatory captions in the blueprint.
- Palette: clean portfolio or editorial (neutral body, one accent for metrics and callouts); WCAG AA; restrained use of pull quotes for user or stakeholder voice.