SkillsAdd

heyeddi-com/heyeddi-skills

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

First seen Jul 8, 2026

Installation

$ npx skills add heyeddi-com/heyeddi-skills --skill heyeddi-intake
View on skills.sh ↗ GitHub repository ↗

Summary

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

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

frontend-design Same topic
anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existi…

866.4K installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-diagnostics Same topic
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs

Also in this package

Other skills from heyeddi-com/heyeddi-skills · top by installs.

npx skills add heyeddi-com/heyeddi-skills
flutter-engineering 72 project-engineering 71 ux-flow-auditor 70 design-handoff-flutter 69 engineering-excellence 69 pre-merge-gate 69 design-system-generalizer 69 heyeddi-design 69 visual-auditor 69 verify-build 69

Browse all from heyeddi-com/heyeddi-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.3.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,720 B
  • docs SUMMARY.md 358 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 61 installs

SKILL.md

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_wireframe per 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 generatewireframe → refine wireframe.md for this product → seedbrief --force
No images, polished PNG handoff needed preparemockupprompts → 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:

  1. load_intake
  2. Draft product-translation.json (reference/audience-intake.md): template: reference/product-translation.template.json
  3. write_product --json … --force: validates schema; writes product.md + saves JSON
  4. write_translation
  5. Handoff features: generatewireframe (or ingestmockups / AI PNGs per strategy) → seed_brief --force
  6. build_routing --write --save-input
  7. verify_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.vue shell on scaffolded repos is OK)
  • Delete src/App.vue or break npm run build to pass verify
  • Use writerouting unless overriding buildrouting output
  • 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 preparemockupprompts (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:

  1. Run:

``bash python .agents/skills/heyeddi-orchestrator/scripts/suggestnextskill.py --current-skill heyeddi-intake --project-root . ``

Add --route /path if you worked a specific route.

  1. Include the script's ### Next step block 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-orchestrator → reference/next-skill-handoff.md.

Related

  • reference/audience-intake.md: JSON schema
  • reference/downstream-routing.md: routing examples
  • reference/mockup-strategy.md: when wireframe vs ingest vs AI PNG
  • reference/ai-mockup-images.md: AI generation workflow (no bundled PNGs)
  • reference/mockup-quality.md: quality bar per format
  • @heyeddi-orchestrator: writeskillsindex after intake (integration eval)