Update to Devpost Hackathons

{
  "name": "hackathon-map",
  "description": "Orient the participant — show the command map, current project progress, deadline/readiness context, and the next recommended command. Use when the user asks what commands are available or what this can do, asks how to get started with the hackathon or Devpost, seems confused, stuck, or unsure what to do next, wants to resume after context loss, or wants to know what to do next.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 202
    },
    {
      "relative_path": "references/SETUP.md",
      "size_in_bytes": 1231
    },
    {
      "relative_path": "references/config/hackathon.json",
      "size_in_bytes": 1897
    },
    {
      "relative_path": "references/content/learning/build.md",
      "size_in_bytes": 939
    },
    {
      "relative_path": "references/content/learning/checklist.md",
      "size_in_bytes": 618
    },
    {
      "relative_path": "references/content/learning/onboard.md",
      "size_in_bytes": 1333
    },
    {
      "relative_path": "references/content/learning/prd.md",
      "size_in_bytes": 972
    },
    {
      "relative_path": "references/content/learning/scope.md",
      "size_in_bytes": 403
    },
    {
      "relative_path": "references/content/learning/spec.md",
      "size_in_bytes": 356
    },
    {
      "relative_path": "references/content/steps/check.md",
      "size_in_bytes": 1150
    },
    {
      "relative_path": "references/content/steps/help.md",
      "size_in_bytes": 2595
    },
    {
      "relative_path": "references/content/steps/map.md",
      "size_in_bytes": 948
    },
    {
      "relative_path": "references/content/steps/prepare.md",
      "size_in_bytes": 1599
    },
    {
      "relative_path": "references/content/steps/resources.md",
      "size_in_bytes": 1601
    },
    {
      "relative_path": "references/content/steps/rules.md",
      "size_in_bytes": 840
    },
    {
      "relative_path": "references/content/steps/start.md",
      "size_in_bytes": 1868
    },
    {
      "relative_path": "references/plugin-runtime.md",
      "size_in_bytes": 11707
    }
  ],
  "skill_md_contents": "---\nname: hackathon-map\ndescription: Orient the participant — show the command map, current project progress, deadline/readiness context, and the next recommended command. Use when the user asks what commands are available or what this can do, asks how to get started with the hackathon or Devpost, seems confused, stuck, or unsure what to do next, wants to resume after context loss, or wants to know what to do next.\n---\n\n# Hackathon Map\n\n## Purpose\n\nOrient the participant. For a brand-new user this is the friendly tour: what this is, the commands, and where to start. For a returning user it reads the local state file, tells them where they are, and points to the next command in the main chat body.\n\nChat is the primary participant interface. Keep responses text-first so they render in any Codex host; the bundled `devpost` MCP server supplies rich inline visuals on hosts that support them.\n\nUnlike the step commands, `$hackathon-map` does not mark workflow stages complete.\n\n## Required Data Source\n\nOfficial event data comes from the `devpost` MCP server — follow **Devpost MCP Server** in `references/plugin-runtime.md` (call only what you need, never verify or set up the server, degrade in one line on failure).\n\nDraw on these only as needed: `devpost.get_hackathon_overview`, `devpost.get_key_dates`, `devpost.get_announcements`.\n\n## Required References\n\nRead:\n\n- `references/plugin-runtime.md`\n- `references/content/steps/map.md` (the page content when state exists)\n- `references/content/steps/help.md` (the welcome tour when no state exists or the user asks for orientation)\n- `.devpost-hackathon-state.json` when present\n- `references/config/hackathon.json`\n\nIf the state file does not exist:\n\n- do not create files from this skill alone unless the user explicitly asks\n- present the welcome tour from `references/content/steps/help.md`: the entry point is\n  `$find-hackathon` (see what's open in this app), then `$start-hackathon` (register and\n  begin) and the rest of the five-step journey\n- keep it warm and skimmable — a tour guide, not a wall of documentation\n\n## Tailoring\n\nAdapt to what prompted the command:\n\n- **They asked a specific \"how do I…\" question:** answer that first in a sentence or two,\n  name the command that handles it, then offer the map or tour compactly.\n- **They seem stuck or frustrated:** acknowledge it, give the single most likely command or\n  fix first, and keep the rest short.\n- Do not call `devpost` MCP tools for a plain orientation response — only if the user's\n  question also asks about dates, rules, or other event specifics, and then only what that\n  question needs.\n\n## State Shape\n\nExpect the state file to stay small:\n\n- `current_stage`\n- `completed_stages`\n- `rules_acknowledged`\n- `registration`\n- `project`\n- `learning`\n- `submission`\n- `deadlines`\n- `next_command`\n\nIf an older state file references removed prototype fields like `dashboard`, `reminders`, or `deadline-reminders`, treat them as legacy. Do not reintroduce those concepts into the participant-facing output.\n\n## Presentation Output\n\nWhen state exists, compose the recovery response in-context per `references/plugin-runtime.md` (\"Composing the Response\"): read `references/content/steps/map.md`, strip maintainer `<!-- -->` comments, interpolate the event name, then present a short stage headline, the page content, and the next-step callout. Do not run any script.\n\nWhen no state exists (or the user asked for orientation), compose from `references/content/steps/help.md` the same way — trimming sections irrelevant to what the user asked is fine; do not invent commands that are not in the page content.\n\nThe response should show the current top-level stage, completed stages, optional guided build tool state, deadline status, and next command without marking anything complete.\n\n## Chat Output\n\nKeep chat output compact.\n\nDo not hand-write a separate dashboard. Let the CLI composer render the response.\n\nRespond with:\n\n- current stage\n- completed stages, summarized\n- next recommended command — **unless the journey is complete** (every stage done and the\n  submission verified submitted): then never print a next-command line at all (\"Next\n  command: None\" reads as a dead end). Instead say plainly that the journey is complete,\n  and list what they can still do before the deadline: improve the public project page,\n  add screenshots or an optional video, invite teammates, share the project. Close with\n  the anytime-offer line from `references/plugin-runtime.md` (\"That's everything — type\n  `$hackathon-map` anytime…\").\n- deadline status if known, otherwise `official deadline to be confirmed`\n- **submission truth:** if the participant has been through `$prepare-submission` or\n  `$submit-project` but `submission.status` is not `submitted`, include, verbatim, next to\n  the deadline status, the ⏳ block from **Submission Status Blocks** in\n  `references/plugin-runtime.md`.\n  Local state never proves a submission — if the user asks whether they submitted,\n  verify live via `devpost.get_project` / `devpost.list_my_projects` (AUTH-REQUIRED) and\n  answer from that. Treat a legacy `submission` entry in `completed_stages` as the\n  `submit-project` stage, not as proof of submission.\n\nIf state does not exist, respond with the welcome tour (from `references/content/steps/help.md`):\n\n- one friendly line about what this is\n- entry command: `$find-hackathon`\n- the five-step command journey, compactly\n- the optional guided build track, in one line\n\n## Command Map\n\nEntry point, before any state exists:\n\n`$find-hackathon`\n\nCore sequence:\n\n`$start-hackathon -> $review-hackathon-rules -> $resources -> $prepare-submission -> $submit-project`\n\nOptional build sequence inside Step 3:\n\n`$build-onboard -> $build-scope -> $build-prd -> $build-spec -> $build-checklist -> $build-project -> $prepare-submission`\n\nOnly show the full command map when the user asks for commands or when no state exists. Otherwise show only the next recommended command.\n"
}