suzheng/k2f

k2f-invoice

Create payment-ready invoices from line items, rates, client details, tax rules, and terms—structured so totals reconcile and AP can pay without back-and-forth.

소스 보기

사용 방법

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

시작 전 확인

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

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

K2F Invoice — AI-Native Aesthetic Design

Purpose

Teach agents to blueprint invoices before layout: legally and operationally complete party and reference data, a reconciled line-item and tax math story, and visual hierarchy that surfaces what is owed, by when, and how to pay—without inventing banking, tax IDs, or amounts the user did not supply.

Built on K2F

This skill produces invoices 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 (parties, line roles, totals, payment block)—not pixel coordinates—while the engine compiles layout, typography, and theme into consistent output across PDF and other formats.

Before you build, install the core skill: npx skills add suzheng/k2f --skill k2f.

When to Use

  • Issuing a new invoice from a quote, timesheet, contract, or pasted line items.
  • Rebuilding a messy or generic AI invoice so math, references, and payment details align.
  • Pro forma or deposit invoices where due date and amount semantics differ from a standard bill.

Workflow

Step 1. Generate the contentanddesign.md

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

Sub-steps

  1. Invoice type & jurisdiction lock — Standard bill, pro forma, deposit/partial, or credit-style adjustment. Note currency, locale (date and number formatting), and whether tax is inclusive or exclusive. Omit sections the type does not need (e.g., skip “amount due” hero on non-collecting pro forma).
  1. Party & identity block — Seller: legal name, address, contact, logo intent, tax/VAT ID only if user provided. Buyer: bill-to name and address; optional ship-to or attention line. Never fabricate registration numbers or bank details.
  1. Reference metadata — Invoice number, issue date, due date (or explicit “Due on receipt / Net N”). PO, project, contract, or customer reference when supplied. One currency code for the whole document; flag missing due date before layout.
  1. Line-item architecture — Table-first, not prose paragraphs. Per row: clear description, quantity, unit, unit price, line amount. Group optional sections (services vs expenses, milestones) only when the user’s data already splits that way. Discounts as explicit negative lines or percent note tied to a subtotal rule—never hidden in copy.
  1. Totals story (write the math in the doc) — Subtotal → each tax/discount line with rate label → total → optional amount paid / balance due. State rounding rule (per line vs invoice-level) and reconcile: line sums, tax base, and total must match within one cent of stated rule. If inputs conflict, mark NEEDS USER CONFIRMATION instead of guessing.
  1. Payment & compliance footer — Payment terms in plain language; methods the user named (wire, ACH, card link, check). Bank/wallet fields verbatim from user; pay-link call-to-action when a hosted URL exists. Late-fee or remittance notes only if provided. Keep legal boilerplate minimal unless user supplied text.
  1. Design intent — Document tone, hierarchy, density, palette for the engine:
  • Tone: calm, trustworthy B2B; no marketing fluff on a collection document.
  • Hierarchy: document title + invoice number scannable in header; amount due and due date strongest emphasis in totals/payment zone; line table secondary; footer tertiary.
  • Density: generous table row rhythm; right-align money columns; tabular numerals for all amounts; avoid more than one short notes block.
  • Palette: restrained neutrals with one accent on total/due; WCAG AA; logo space without decorative clutter.

Rules & constraints

  • Payability gate: no send-ready blueprint without invoice number, dates, currency, reconciled total, and user-confirmed pay instructions when payment is expected.
  • Single source of truth: line items drive subtotal; tax rates apply to the documented base only.
  • Reference discipline: PO/project IDs appear once in metadata and optionally on lines—not repeated in random paragraphs.
  • Honesty gate: mark missing tax treatment or FX; never infer statutory rates without user input.

Common failure modes

  • Paragraph line items → rewrite as table rows with qty/rate/amount.
  • Tax on wrong base or double-counted → restate base, rate, and rounded tax lines explicitly.
  • Generic “Invoice” with no due date or number → fill from user or flag gaps.
  • Amount due buried below fold in design intent → promote total/due in hierarchy notes.
  • Invented IBAN, VAT, or pay links → strip and replace with TBD — user must supply.
  • Mixed currencies on one invoice → split or escalate unless user confirms FX line.

Quality checklist

  • [ ] Parties and tax IDs match user-supplied data only.
  • [ ] Line amounts × qty reconcile to subtotal under stated rounding.
  • [ ] Tax/discount lines sum to total; balance due correct if partial payment noted.
  • [ ] Due date and payment instructions align with terms.
  • [ ] Design intent names emphasis for amount due, table, and payment block.
  • [ ] All figures traceable to user inputs or explicit formulas in the doc.

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 the invoice from the blueprint, apply roles from design intent, verify, and export the payment-ready deliverable.

관련 작업

같은 저장소의 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일