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: ```bash python scripts/manager.py <command> [args] ``` ## Core Commands ### Add a Hackathon ```bash python scripts/manager.py add "Hackathon Name" "YYYY-MM-DD" "Prize Amount" ``` Example: ```bash 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 ```bash python scripts/manager.py list ``` Shows table with name, deadline, status, and progress for all tracked hackathons. ### View Status ```bash python scripts/manager.py status "Hackathon Name" ``` Shows detailed view including full checklist with completion status. ### Check Off Item ```bash 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 ```bash python scripts/manager.py upcoming [days] ``` Show hackathons due in next N days (default 7). Sorted by urgency with visual indicators. ### Text Calendar View ```bash 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](https://github.com/rubiojr/gog) to be installed and authenticated. ### List Calendar Events ```bash python scripts/manager.py gcal list ``` Show all hackathon-related events currently in Google Calendar. ### Sync to Calendar ```bash 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 ```bash 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: ```json { "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](https://github.com/rubiojr/gog) - Events are prefixed with `[REG]`, `[WORK]`, or `[DEADLINE]` for easy identification - The `gcal remove` command matches hackathon name in event titles