Hackathon Manager

Hackathon Manager

Track multiple hackathons with deadlines, prizes, and submission checklists. Automatically extract hackathon details from URLs and manage progress toward submission.

Quick Start

Run commands using the manager.py script:

python scripts/manager.py <command> [args]

Core Commands

Add a Hackathon

python scripts/manager.py add "Hackathon Name" "YYYY-MM-DD" "Prize Amount"

Example:

python scripts/manager.py add "Solana Agent Hackathon" "2026-02-12" "$50K"

From URL: When given a hackathon URL, use web_fetch to extract:

• Hackathon name
• Deadline date
• Prize pool
• Submission requirements

Then call add command with extracted info and populate checklist.

List All Hackathons

python scripts/manager.py list

Shows table with name, deadline, status, and progress for all tracked hackathons.

View Status

python scripts/manager.py status "Hackathon Name"

Shows detailed view including full checklist with completion status.

Check Off Item

python scripts/manager.py check "Hackathon Name" "Item text or number"

Mark a checklist item as complete. Accepts either:

• Full item text: check "Solana Agent" "Deploy to devnet"
• Item number: check "Solana Agent" "2"

View Upcoming

python scripts/manager.py upcoming [days]

Show hackathons due in next N days (default 7). Sorted by urgency with visual indicators.

Workflow

When user mentions hackathons:

1. Adding from URL: If they provide a hackathon link:

   • Use web_fetch to get the page
   • Extract name, deadline, prize, requirements
   • Run add command
   • Populate checklist with requirements

2. Manual add: If they provide details:

   • Run add command with provided info
   • Ask what checklist items to track

3. Checking status: If they ask "what's due?" or "what hackathons?":

   • Run list or upcoming command
   • Show relevant information

4. Managing progress: If they mention completing something:

   • Identify the hackathon and item
   • Run check command
   • Confirm completion

Data Storage

Hackathons stored in JSON at: ~/.openclaw/workspace/hackathons.json

Structure:

{
  "hackathons": [
    {
      "name": "Hackathon Name",
      "deadline": "YYYY-MM-DD",
      "prize": "$50K",
      "status": "active",
      "checklist": ["Item 1", "Item 2"],
      "completed": ["Item 1"]
    }
  ]
}

Integration with HACKATHONS.md

When HACKATHONS.md exists in workspace:

• Read it to discover hackathons not yet in the JSON store
• Suggest importing them
• Keep both files in sync when adding new hackathons

Notes

The skill focuses on tracking and checklists. For calendar integration, manually create events in Google Calendar or use gog CLI directly.