# Hackathon Manager

> Track hackathon deadlines, manage submission checklists, and monitor progress. Use when managing multiple hackathons, checking what's due soon, marking requirements complete, or extracting hackathon information from URLs to auto-populate deadlines and requirements.

- Skill: `tonbistudio/hackathon-manager` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tonbistudio/hackathon-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tonbistudio/hackathon-manager/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tonbistudio (https://skillmd.com/u/tonbistudio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tonbistudio/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.

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

The skill focuses on tracking and checklists. For calendar integration, manually create events in Google Calendar or use gog CLI directly.