heyeddi-intake
Translates vague user prompts into HeyEddi product docs (personas, route intent, voice), route-specific handoff artifacts (wireframes, user mockups, or 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.
How do I install this agent skill?
npx skills add https://github.com/heyeddi-com/heyeddi-skills --skill heyeddi-intakeIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a development tool for translating user requirements into product documentation and project structure. It performs local file operations and executes build commands ('npm run build') for project verification. A minor risk of indirect prompt injection exists as it processes untrusted user input to generate structured data for downstream agents.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
HeyEddi Intake
Upstream intake agent: turns vague user language into .heyeddi/product.md, handoff artifacts, and skill routing for downstream HeyEddi skills.
You are not the implementer. You interpret, document, produce handoff artifacts, route, and verify.
When to use
- New project or empty / thin
.heyeddi/product.md - User describes an app in plain language
- User attached images →
ingest_mockups(screenshots, sketches, competitor refs) - No images →
generate_wireframeper handoff route (default) - Before any
@heyeddi-design/@heyeddi-handoff/ scaffold work
Mockup decision tree
Read reference/mockup-strategy.md (mandatory).
| Situation | Action |
|---|---|
| User gave screenshots / mockups | ingest_mockups → tailor mockup-brief.md to their layout |
| No images, route needs handoff | generate_wireframe → refine wireframe.md for this product → seed_brief --force |
| No images, polished PNG handoff needed | prepare_mockup_prompts → AI-generate desktop.png / mobile.png (see reference/ai-mockup-images.md) → seed_brief --force |
| No images, route needs visual design first | Route @heyeddi-design: do not emit template PNGs |
The skill package does not ship sample PNGs and has no Pillow/template PNG drawer. Eval hub tooling (uv run poe mockups) is maintainer-only: not part of this skill.
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_wireframe(oringest_mockups/ AI PNGs per strategy) →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 - Bundle or draw cookie-cutter PNG mockups from skill scripts
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>/wireframe.md | generate_wireframe (default without user images) |
designs/<feature>/mockup-prompts.json | prepare_mockup_prompts (before AI image gen) |
designs/<feature>/desktop.png | ingest_mockups or agent AI image gen after prompts |
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.
When the task is complete: suggest next skills
When you have finished the user's request for this skill (not after every tool call or subagent phase), suggest what to run next:
-
Run:
python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill heyeddi-intake --project-root .Add
--route /pathif you worked a specific route. -
Include the script's
### Next stepblock in your final reply. The user copies the Prompt line into chat (e.g.@heyeddi-design craft /settings).
Pass --mode shape (or craft, audit, etc.) when you know which sub-command just finished.
See @heyeddi → reference/next-skill-handoff.md.
Related
reference/audience-intake.md: JSON schemareference/downstream-routing.md: routing examplesreference/mockup-strategy.md: when wireframe vs ingest vs AI PNGreference/ai-mockup-images.md: AI generation workflow (no bundled PNGs)reference/mockup-quality.md: quality bar per format@heyeddi:write_skills_indexafter intake (integration eval)
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/heyeddi-com/heyeddi-skills/heyeddi-intake">View heyeddi-intake on skillZs</a>