SkillsAdd

heyeddi-com/heyeddi-skills

project-engineering

Ensures HeyEddi projects have the right engineering stack: Vue (Vite/Vitest), FastAPI backend, or Firebase tooling.

First seen Jul 6, 2026

Installation

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

Summary

  • Ensures HeyEddi projects have the right engineering stack: Vue (Vite/Vitest), FastAPI backend, or Firebase tooling.
  • Audits gaps, scaffolds as needed, installs deps, runs tests, documents local dev servers.
  • Use when the repo is thin or before design/feature work on any HeyEddi app.

Similar popular skills

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

agent-browser Shared topics
vercel-labs/agent-browser

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

810.4K installs
azure-diagnostics Shared topics
microsoft/azure-skills

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

568.9K installs
azure-validate Shared topics
microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure…

567.7K installs
azure-rbac Shared topics
microsoft/azure-skills 489K installs
supabase-postgres-best-practices Shared topics
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs
building-native-ui Shared topics
expo/skills 59.2K 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 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 primevue-openprops-architect 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

Also listed on

Alternate registries and mirrors of this skill.

Repository health

License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.1.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,389 B
  • docs SUMMARY.md 308 B

History

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

SKILL.md

Project Engineering

Baseline code engineering for HeyEddi Vue apps. For Flutter frontends use @flutter-engineering instead. Detects which stacks apply and adds the correct tooling: not one-size-fits-all.

Subagents (default)

Delegate scaffold/audit/test scripts to Task shell; repo discovery to explore. Main chat picks stack from audit JSON. See reference/subagents.md.

Stacks

Stack When Tooling added
Vue Always for frontend work Vite, Vitest, npm scripts, router
FastAPI REST API backend backend/, pytest, openapi.json, uvicorn
Firebase Firestore / Auth client firebase.json, rules, emulators, env template

Declare intent in .heyeddi/stack.json:

{ "frontend": "vue", "backends": ["fastapi"], "api_port": 8090 }

Flutter projects: "frontend": "flutter", "web_port": 8085: see @flutter-engineering.

Or "backends": ["firebase"] or ["fastapi", "firebase"]. audit_scaffold also infers from openapi.json, firestore.rules, and .heyeddi/product.md (or legacy PRODUCT.md).

.heyeddi/ workspace

Every HeyEddi app should have a .heyeddi/ folder (created by scaffoldstack / scaffoldheyeddi):

Path Purpose
README.md HeyEddi intro (agents + humans workspace), free skills, heyeddi.com/humans
stack.json Declared stacks
product.md Product brief
design.md DESIGN.md format: tokens, rationale, Decision log
designs/<feature>/ Handoff PNGs, briefs, wireframes
docs/ Skill-generated reports (ship, PR tracking, drift audits)

Save all skill-created documents under .heyeddi/docs/ (or the paths above) so the team can reference them later. Root PRODUCT.md / DESIGN.md / designs/ remain supported as legacy fallbacks.

Workflow

  1. audit_scaffold: per-layer JSON (vue / fastapi / firebase).
  2. scaffoldstack --stack auto: fills gaps (preferred over scaffoldvue alone).
  3. ensurenpm + ensurepython as needed.
  4. devserverinfo: all local servers (Vue :5173, API :8090, Firebase emulators :4000).
  5. Implement features (design skills, composables, etc.).
  6. writeteststub + runtests + runbackend_tests.
  7. verify-build + pre-merge-gate.

Local dev servers

Stack Command URL
Vue npm run dev http://localhost:5173
FastAPI cd backend && poetry run uvicorn app.main:app --reload --port 8090 http://localhost:8090/docs
Firebase firebase emulators:start http://localhost:4000 (UI)

Run devserverinfo for project-specific steps. Each server needs its own terminal.

References

  • reference/dev-server.md: Vue
  • reference/fastapi-backend.md: FastAPI
  • reference/firebase-backend.md: Firebase emulators

Related skills

  • backend-type-bridger: OpenAPI / Firestore → TypeScript types
  • composable-patterns: FastAPI JWT vs Firebase client composables
  • verify-build: production frontend build

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 project-engineering --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.