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  [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:

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:

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:

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:

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:

Notes

Run commands using the manager.py script:

python scripts/manager.py  [args]