AOI Hackathon Scout (Lite)

Public-safe hackathon source registry + filtering output (no crawling, no submissions).

Security Scan

The skill's code, instructions, and required resources are consistent with a local, read-only hackathon registry/filtering tool and do not request unrelated credentials or network installs.

Purpose & Capability

Name/description match implementation: the skill reads local markdown registry/shortlist files, filters and ranks entries, and prints JSON; no crawling, form submission, or external credentials are required.

Instruction Scope

SKILL.md and the CLI implementation only instruct the agent to read files under context/ (HACKATHON_SOURCES_REGISTRY.md, HACKATHON_SHORTLIST.md, optional template) and to use the OpenClaw browser for manual inspection. The README's optional Brave Search advice is informational and not required by the code.

Install Mechanism

This is an instruction-only / lightweight node script with no install spec and no dependencies; nothing is downloaded or extracted at install time.

Credentials

No credentials or config paths are declared, which is appropriate. The code reads process.env.WORKSPACE (fallback to cwd) to locate context/ files — WORKSPACE is not documented in SKILL.md as a required env var; this is low-risk but means the skill will read files relative to whichever workspace root is used, so a maliciously-set WORKSPACE could point it at unexpected locations.

Persistence & Privilege

always is false and the skill does not modify other skills or system settings; it only reads local files and prints output.

Assessment

This skill is coherent and appears to only read local markdown files in context/ and print filtered JSON. Before installing, (1) inspect your workspace's context/HACKATHON_SOURCES_REGISTRY.md and context/HACKATHON_SHORTLIST.md for any sensitive data (the skill will read those files), (2) avoid setting WORKSPACE to a directory containing secrets because the script uses that env var to find files, and (3) if you want to be extra cautious, review the included skill.js file yourself (it is short and readable). The optional Brave Search instructions in SKILL.md are informational only and do not grant the skill network access unless you configure OpenClaw tools separately.

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

Quick Start (copy/paste)

# 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

aoi-hackathon sources

Filter (best-effort)

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

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

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:

  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 Brave Search for web_search.

• Get key: https://brave.com/search/api/ (choose Data for Search plan)
• Configure (example):

  openclaw config set tools.web.search.provider brave
  openclaw config set tools.web.search.apiKey "BRAVE_API_KEY_HERE"
  openclaw config set tools.web.search.enabled true
  

• Disable again:

  openclaw config set tools.web.search.enabled false
  

(Full setup guide in repo SSOT: context/HACKATHON_SEARCH_SETUP_GUIDE_V0_1.md)

Support

• Issues / bugs / requests: https://github.com/edmonddantesj/aoi-skills/issues
• Please include the skill slug: aoi-hackathon-scout-lite

Provenance / originality

• AOI implementation is original code.
• Registry content is a curated link list.