使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/suzheng/k2f --skill k2f-menu开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
K2F Menu — AI-Native Aesthetic Design
Purpose
Teach agents to author content_and_design.md for hospitality menus: category and item structure, inclusion cuts, and aesthetic intent (tone, hierarchy, density)—not K2F packaging or export.
Built on K2F
This skill produces menus as .K2F packages. Follow the k2f skill for authoring: unpack or init a workspace, edit the semantic tree, pack/verify, and export. K2F keeps agents on meaning (sections, dishes, prices, dietary notes)—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
- Restaurants, cafés, bars, bakeries, food trucks, hotels, catering, or private dining.
- Boards, folded inserts, food/drink splits, wine or cocktail lists, kids or brunch add-ons.
- Print or digital PDF—not full websites or POS exports.
Workflow
Step 1. Generate the contentanddesign.md
One blueprint pairing information architecture with design intent. Long menus: one file per major section slug (e.g. content_and_design_mains.md).
Sub-steps
- Menu lock — Venue type, service style, daypart, language(s), currency, brand constraints. Guest job: pick a dish or drink quickly while seated or at a board.
- Section map — Order categories as guests decide (starters → mains → desserts → drinks, or bar-first). Label each Open, Featured (2–6 heroes), or Omit (verbal, QR, other card). Split food/drinks or lunch/dinner when one scan path fails.
- Item anatomy — Consistent fields: Name, Description (length scales with venue), Price (one grammar site-wide), Tags (only user-supplied or required), Modifiers (sizes, add-ons) nested under one parent—not duplicate dishes.
- Content tiers — Identity (name, logo direction), Navigation (section titles), Catalog (items + prices), Guidance (one short chef or pairing note max), Compliance (allergens, service charge). Keep essays out of Catalog.
- Genre fit — Fine dining: brevity, seasonal focus. Casual: moderate density, combos. Bar/wine: column-friendly; glass | bottle. Hotel/catering: packages, per-person lines, tray or service notes in Compliance.
- Cut pass — Drop duplicates, unpriced market items without confirmation, mismatched price formats, and naming inconsistency within sections.
- Design intent (no coordinates) — Tone: one adjective pair from cuisine/venue cues. Hierarchy: sections > item names > descriptions; prices in one scan band (column or dot leaders). Density: board vs booklet vs fine dining whitespace; note two-column intent for bar lists. Brand: contrast on photos/dark boards (panel intent); 2–3 colors; display vs detail roles. Channel: print header scale vs mobile PDF section breaks.
Rules & constraints
- Prices and names scannable within ~10 s per section.
- One price grammar; each dish listed once.
- No invented dishes, prices, or allergen claims; label placeholders.
- Compliance stays short unless the user requires more.
Common failure modes
| Failure | Fix |
|---|---|
| Flyer creep | Promos → separate flyer; menu = Identity + Catalog. |
| Adjective walls | One description line; move story to Guidance. |
| Price chaos | Unify format; state alignment intent. |
| Category soup | Merge small sections; Featured for orphans. |
| Website paste | Strip nav/SEO; keep menu tiers only. |
Quality checklist
- [ ] Menu lock and guest job; section map with Open/Featured/Omit.
- [ ] Item anatomy + unified prices; tiers assigned.
- [ ] Genre density; design intent (tone, hierarchy, density, channel).
- [ ] Facts traceable to user input; placeholders marked.
Step 2. Use the contentanddesign.md and k2f skill to generate a K2F file and export to an appropriate file format.
Follow k2f to map the blueprint into the semantic tree, apply theme roles from design intent, verify, and export (typically PDF).


