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:

CODEBLOCK0

Core Commands

Add a Hackathon

CODEBLOCK1

Example:
CODEBLOCK2

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

CODEBLOCK3

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

View Status

CODEBLOCK4

Shows detailed view including full checklist with completion status.

Check Off Item

CODEBLOCK5

Mark a checklist item as complete. Accepts either:

• - Full item text: INLINECODE0
• Item number: INLINECODE1

View Upcoming

CODEBLOCK6

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

Text Calendar View

CODEBLOCK7

Display a text calendar with hackathon markers:

• - R = Registration opens
• INLINECODE3 = Work period starts
• INLINECODE4 = Submission deadline

Google Calendar Integration

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

List Calendar Events

CODEBLOCK8

Show all hackathon-related events currently in Google Calendar.

Sync to Calendar

CODEBLOCK9

Create Google Calendar events for all tracked hackathons:

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

Remove from Calendar

CODEBLOCK10

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. 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

1. 2. Manual add: If they provide details:

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

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

- Run list or upcoming command - Show relevant information

1. 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: INLINECODE9

Structure:
CODEBLOCK11

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 INLINECODE10
• 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