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

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:

• 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
• Manual add: If they provide details:
• Run add command with provided info
• Ask what checklist items to track
• Checking status: If they ask "what's due?" or "what hackathons?":
• Run list or upcoming command
• Show relevant information
• 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