aoi-hackathon-scout-lite

# AOI Hackathon Scout (Lite)

S-DNA: `AOI-2026-0215-SDNA-HACK01`

## Quick Start (copy/paste)
```bash
# 1) install
clawhub install aoi-hackathon-scout-lite

# 2) shortlist view / best-effort recommendations
# (reads context/HACKATHON_SHORTLIST.md)
aoi-hackathon recommend --n 5

# 3) browse sources (no API keys)
aoi-hackathon sources
openclaw browser start
openclaw browser open https://devpost.com/c/artificial-intelligence
openclaw browser snapshot --efficient
```

## Scope (public-safe)
- ✅ Outputs curated **source list** for hackathons / builder programs / grants
- ✅ Provides a filtering view: online-only preference, type tags
- ✅ Provides a paste-ready summary template for the user
- ❌ No crawling, no login, no form-fill, no submission automation
- ❌ No Notion API usage in the public skill (paste template only)

## Data source
- Uses the local registry file:
  - `context/HACKATHON_SOURCES_REGISTRY.md`

## Commands
### Show sources
```bash
aoi-hackathon sources
```

### Filter (best-effort)
```bash
# show only likely-online sources
# (filters Online-only fit = ✅ or ⚠️)
aoi-hackathon sources --online ok

# show only web3 sources
aoi-hackathon sources --type web3
```

### Recommend from shortlist (best-effort)
```bash
# reads context/HACKATHON_SHORTLIST.md and prints top N online-eligible items
# (excludes rejected; prioritizes 🔥 markers and 'applying/watching')
aoi-hackathon recommend --n 5
```

### Print Notion paste template (text only)
```bash
aoi-hackathon template
```

## Setup (early users)
This skill is **public-safe** and does not require API keys by default.

### Recommended default: Browser/web_fetch (no keys)
- Use OpenClaw Browser to open sources and inspect deadlines/details.
- Quick start:
  ```bash
  openclaw browser start
  openclaw browser open https://devpost.com/c/artificial-intelligence
  openclaw browser snapshot --efficient
  ```

### Optional: Brave Search API (fast keyword search)
If you want ultra-fast keyword search, you can enable B...