suzheng/k2f

k2f-case-study

Create portfolio- or client-ready case studies from project notes, resume bullets, or outcome data—with a credible narrative arc, process evidence, quantified impact, and visual storytelling intent.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/suzheng/k2f --skill k2f-case-study

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

K2F Case Study — AI-Native Aesthetic Design

Purpose

Teach agents to blueprint case studies before layout: show how and why work happened—not a resume repeat—with honest scope, evidence-backed results, and hierarchy that hooks skimmers and rewards deep readers.

Built on K2F

This skill produces case studies 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 (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.

When to Use

  • Expanding bullets or slide decks into a portfolio or interview-ready project story.
  • Documenting a client or internal win for sales, marketing, or leadership audiences.
  • Tailoring one project for PM, design, engineering, or marketing emphasis without rewriting from scratch.

Workflow

Step 1. Generate the contentanddesign.md

Single blueprint for semantic content and aesthetic intent. Use labeled blocks the k2f skill can map to sections and visuals later.

Sub-steps

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

Rules & constraints

  • Show thinking, not just output: every major solution block links to a stated problem or insight.
  • Evidence ladder: separate fact (user data), interpretation (your reading), and projection (expected impact)—never upgrade guesses to results.
  • Process proportion: enough to prove judgment; omit ceremonial steps with no decision or learning.
  • Contribution honesty: no “we” vagueness for interview-facing work; no solo heroics for team-owned delivery.
  • Skim path: a reader who stops after hero + problem + results still understands value.

Common failure modes

  • Resume bullet paste without narrative arc → add problem stakes and decision moments.
  • Solution gallery with no “so what” → tie each artifact to a pain point or metric.
  • Process encyclopedia → collapse to research insight, option trade-off, chosen path.
  • Missing or vague results → quantify where data exists; label NEEDS USER INPUT where it does not.
  • Undifferentiated team story → sharpen “I led / I built / I validated” boundaries.
  • Only final mocks → plan before/after or iteration figures in the asset list.
  • Generic case study length → match charter depth; cut reflection if the reader is a prospect skimming one win.

Quality checklist

  • [ ] Charter names audience, read depth, and hook outcome.
  • [ ] Hero facts match overview and results; no contradictory metrics.
  • [ ] Problem states goals and constraints; solution explicitly addresses them.
  • [ ] Process includes at least one decision with rationale and one iteration or test signal.
  • [ ] Results separate measured vs inferred; timeframe and baseline stated.
  • [ ] Visual asset list covers essential story beats with caption intent.
  • [ ] Design intent specifies hierarchy for hero, results, and figure rhythm.

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 sections and figure roles from the blueprint, apply design intent, verify, and export the audience-ready case study.

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills
suzheng
커뮤니티

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

1시간 설치 수
19
GitHub Stars
5
업데이트
11월 7일
suzheng
커뮤니티

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

1시간 설치 수
20
GitHub Stars
5
업데이트
11월 7일
suzheng
커뮤니티

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

1시간 설치 수
19
GitHub Stars
5
업데이트
11월 7일
suzheng
커뮤니티

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

1시간 설치 수
8
GitHub Stars
5
업데이트
11월 7일