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.

Text Calendar View

python scripts/manager.py calendar [month] [year]

Display a text calendar with hackathon markers:

• R = Registration opens
• W = Work period starts
• D = Submission deadline

Google Calendar Integration

Sync hackathons to Google Calendar using the gog CLI. Requires gog to be installed and authenticated.

List Calendar Events

python scripts/manager.py gcal list

Show all hackathon-related events currently in Google Calendar.

Sync to Calendar

python scripts/manager.py gcal sync

Create Google Calendar events for all tracked hackathons:

• [REG] - Registration opens (timed event)
• [WORK] - Work period (all-day event)
• [DEADLINE] - Submission deadline (timed event)

Remove from Calendar

python scripts/manager.py gcal remove "Hackathon Name"

Delete all calendar events matching the hackathon name.

Note for Windows: The skill auto-configures the Go timezone database. If you get timezone errors, ensure ~/.gog/zoneinfo.zip exists.

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

• Data stored in ~/.openclaw/workspace/hackathons.json
• Google Calendar integration requires gog CLI
• Events are prefixed with [REG], [WORK], or [DEADLINE] for easy identification
• The gcal remove command matches hackathon name in event titles