Product translator
Translates vague user prompts into HeyEddi product docs (personas, route intent, voice), professional mockups, mockup briefs, and skill-routing under .heyeddi/. Use first on new projects before @heyeddi-design, @heyeddi-handoff, or @flutter-engineering. Never hand-write product.md — use write_product.From its SKILL.md
npx -y skills add HeyEddi-com/skills --skill product-translatorAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.5 KB, 589 tokens by cl100k_base, as published. Nobody here has run it
Product Translator
Upstream intake agent — turns user language into structured artifacts other HeyEddi skills consume.
You are not the implementer. You interpret, document, produce mockups/briefs, route, and verify.
When to use
- New project or empty / thin
.heyeddi/product.md - User describes an app in plain language
- User attaches mockups →
ingest_mockups; no mockups →generate_mockups+seed_brief - Before any
@heyeddi-design/@heyeddi-handoff/ scaffold work
Mandatory pipeline
See reference/pipeline.md. Summary:
load_intake- Draft
product-translation.json(reference/audience-intake.md) — template:reference/product-translation.template.json write_product --json … --force— validates schema; writesproduct.md+ saves JSONwrite_translation- Handoff features:
generate_mockups→seed_brief --force build_routing --write --save-inputverify_intake --check— must pass before you stop
Never
- Hand-write
product.md(missing personas breaks@heyeddi-design) - Skip
verify_intake - Implement Vue/Flutter/FastAPI features in this skill (baseline
src/App.vueshell on scaffolded repos is OK) - Delete
src/App.vueor breaknpm run buildto pass verify - Use
write_routingunless overridingbuild_routingoutput
Outputs (.heyeddi/)
| Path | Tool |
|---|---|
docs/intake/product-translation.json | write_product (canonical) |
product.md | write_product |
docs/intake/translation-*.md | write_translation |
docs/intake/skill-routing.json | build_routing --write |
designs/<feature>/desktop.png | generate_mockups / ingest_mockups |
designs/<feature>/mockup-brief.md | seed_brief (Audience + Implementation spec) |
Clarify before act
Read reference/clarify-before-act.md. One round if personas/competitors missing from user prompt.
Related
reference/audience-intake.md— JSON schemareference/downstream-routing.md— routing examplesreference/mockup-quality.md— PNG quality bar@heyeddi-orchestrator—write_skills_indexafter intake (integration eval)
What ships with it: 23 files
65.8 KB alongside SKILL.md, 13 of them executable
context/
- ANTI_PATTERNS.md558 B
- EXAMPLES.md1016 B
- VOCABULARY.md355 B
reference/
- audience-intake.md2.4 KB
- clarify-before-act.md1.1 KB
- downstream-routing.md1.3 KB
- mockup-quality.md696 B
- pipeline.md1.7 KB
- product-translation.template.json3.1 KB
scripts/
- build_routing.pyruns4.8 KB
- generate_mockups.pyruns2.9 KB
- _heyeddi_paths.pyruns1.2 KB
- ingest_mockups.pyruns2.7 KB
- _layout_mockups.pyruns5.8 KB
- load_intake.pyruns4.6 KB
- _product_schema.pyruns5.2 KB
- seed_brief.pyruns4.6 KB
- _skill_cli.pyruns593 B
- verify_intake.pyruns5.5 KB
- write_product.pyruns7.1 KB
- write_routing.pyruns1.5 KB
- write_translation.pyruns2.1 KB
- manifest.json5.0 KB