Journey Submit

Final step in the Butterbase journey for hackathon projects. After you've deployed, this walks you through submission: it figures out which hackathon you're entering (asking if multiple are open or you need a submission code), then goes field by field through that hackathon's actual schema, pulling smart defaults from your idea doc and build log where it can. It refuses to run if you haven't deployed yet and always asks for explicit confirmation before firing off the submission. The two-phase prep-then-submit design is careful about not guessing which hackathon you want or what fields it needs, which matters when the platform hosts multiple events. Writes a receipt to your docs folder and ticks the final checkbox.

GitHub stars: 532
last updated: Jun 11, 2026

View on GitHub

Install

$ npx -y skills add butterbase-ai/butterbase-skills --skill journey-submit --agent claude-code

Installs into .claude/skills of the current project.

Files

Journey: Hackathon submission

Stage 5 (final) of the guided journey. Resolve the active hackathon, confirm fields, submit.

When to use

Dispatched by journey when current_stage: submit and hackathon_mode: true.
Directly via /butterbase-skills:submit.
No-op (returns with "submit is disabled outside hackathon mode") if hackathon_mode: false.

Preflight

If docs/butterbase/03-preflight.md is missing, older than 24 hours, or 00-state.md has app_id: null, invoke butterbase-skills:journey-preflight first. Wait for it to return successfully before proceeding.

Additionally: refuse to run unless deploy is ticked in 00-state.md. If it is not, tell the user to run /butterbase-skills:journey-deploy first.