Onboarding

Eva

25 cards ~ 1.7 h Foundational

Foundational walk through the eva project. Read top to bottom if you're new; no prior context assumed.

  1. eva beginner 4 min

    Prompt Artefact Directory Layout

    Use when: scaffolding a new prompt under prompts/; auditing an unfamiliar prompt directory; wiring a guard or verifier into an existing prompt

  2. eva beginner 5 min

    meta.yml Schema & Required Fields

    Use when: authoring a new meta.yml; debugging eva doctor failures on required fields; preparing a prompt for skill export

  3. eva intermediate 5 min

    kick Variable Resolution Pipeline

    Use when: debugging why a {{var}} did not substitute; deciding between --var, --var-file, and --case; writing a guard.sh that overlays variables

  4. eva intermediate 4 min

    guard.sh & verify.sh Hook Contract

    Use when: writing a pre-send validator that aborts bad inputs; writing a post-send checker that drives the verified counter; debugging why kick aborted before sending

  5. eva beginner 4 min

    .usage.jsonl Append Format

    Use when: computing prompt usage stats outside of eva show; debugging promotion gate counts; auditing performance medians for a prompt

  6. eva intermediate 5 min

    Promotion Lifecycle Gates

    Use when: promoting a prompt from draft to tested; promoting a prompt from tested to ready; diagnosing why eva promote refuses to bump status

  7. eva intermediate 6 min

    eva eval Cases, Assertions & Judges

    Use when: adding a new case to eval.yml; choosing between assertions and a rubric judge; debugging a failing eva eval run

  8. eva intermediate 4 min

    Triggering Tests for Skill Auto-Load

    Use when: tuning meta.description so the right queries auto-load the skill; adding negative examples to eval.yml.triggering; diagnosing a should_match failure

  9. eva intermediate 5 min

    eva doctor Validation Rules

    Use when: diagnosing a doctor FAIL line; deciding whether a warning will block skill export; chasing an alias collision across prompts

  10. eva beginner 4 min

    eva index: README & kick-aliases Generation

    Use when: regenerating the README catalog after adding a prompt; wiring a new shell verb into the kick-aliases.sh source; understanding which section of kick-aliases.sh is hand-edited

  11. eva intermediate 6 min

    Skill Export Pipeline

    Use when: exporting a ready prompt as an Anthropic skill; debugging an export-skill blocked by doctor; understanding the SKILL.md frontmatter eva produces

  12. eva intermediate 4 min

    Skill Export Shape Gates

    Use when: fixing an 'id contains reserved skill token' failure; trimming meta.description to fit the 1024-char cap; deciding whether to split prompt.xml before export

  13. eva beginner 3 min

    eva venv Self-Bootstrap Re-exec

    Use when: diagnosing a missing-ruamel error from eva; running eva from a system Python instead of the project venv; moving the eva-hq checkout to a new machine

  14. eva beginner 4 min

    Eleventy Catalog Site Build

    Use when: running the prompt catalog locally before publishing; adding a new template under site/prompts/; understanding which data source the catalog reads

  15. eva beginner 3 min

    The One-Engineer Prompt Library

    Use when: writing the EVA tagline or homepage hero; explaining EVA to someone who builds with LLMs

  16. eva beginner 3 min

    Who EVA Is For

    Use when: qualifying inbound interest; deciding whether to feature EVA in a developer newsletter

  17. eva beginner 4 min

    The Pitch in One Screen

    Use when: writing the homepage hero copy; drafting a tweet or Show HN post for EVA

  18. eva beginner 4 min

    Launching to a Single User

    Use when: explaining why EVA does not have a launch campaign; deciding what counts as 'shipped' for EVA

  19. eva beginner 4 min

    Why Not Just a Notes App

    Use when: responding to 'couldn't you do this in Obsidian?'; comparing EVA against Notion, GitHub gists, or a scratch directory

  20. eva beginner 3 min

    Free, Personal, Forever

    Use when: answering 'is there a paid tier?'; explaining EVA's sustainability story

  21. eva beginner 3 min

    Personal LLM tooling is the next IDE-shaped category

    Use when: framing why a single-user prompt catalog is a venture-shaped opportunity; answering 'why now' for personal AI tooling

  22. eva beginner 3 min

    5M daily-LLM developers by 2027 is the addressable wedge

    Use when: sizing the addressable market for personal prompt tooling; answering 'how big can a single-user tool get?'

  23. eva beginner 3 min

    52 prompts indexed, 38 production-ready, used daily by the operator

    Use when: showing diligence-grade traction for a single-operator tool; answering 'what has actually been built?'

  24. eva beginner 4 min

    The moat is the structured prompt — not the catalog UI

    Use when: answering 'couldn't a notes app or GitHub do this?'; explaining what compounds as the catalog grows

  25. eva beginner 4 min

    From one operator to a shared registry — a 12-month roadmap

    Use when: explaining what the next round of capital actually buys; answering 'how do you go from a single user to a market?'