ETHGlobal Skills
One command to get 17,180 projects, sponsor/bounty docs, and all Finalist/bounty winners
Project Description
npx skills add ethglobal-skills/repo
One command gives your coding agents access to:
- 17,180 hackathon projects from the past 6 years
- sponsor docs + bounties for upcoming hacks
- all Finalist + bounty winners
Make sure to explicitly say use ethglobal-skills at the end of your prompts. Full example queries and API doc:
https://github.com/ethglobal-skills/repo/blob/main/skills/ethglobal-skills/SKILL.md
Rate limiting is done via x402. If you reach over 10 requests / minute, it'll be $0.05 USDC on Base mainnet. Install AgentCash and transfer a small amount to continue! Small sample txn for x402: h.
x402 API just for agents, always $0.01 - no human in the loop:
https://www.x402scan.com/server/11c90e38-e041-441e-a18f-f6d0a44b4e34
How it's Made
Python scripts
Scraped ETHGlobal's website across all events from ETHWaterloo to present, collecting project showcases, sponsor bounties, prize winners, and qualification requirements. Output structured JSON files totaling ~263k lines of raw hackathon data.
Supabase
JSON data was cleaned and uploaded into a Postgres database with relational tables for events, projects, prizes, sponsors, and sponsor docs. The Next.js API uses the Supabase client to run filtered queries at request time.
Next.js Routes
Four REST endpoints handle search and filtering — by event, keyword, sponsor, or prize. A middleware layer handles rate limiting (10 free req/min per IP) and x402 payments, so requests beyond the free tier automatically prompt for $0.05 USDC on Base mainnet via the CDP facilitator.
SKILL.md
A structured markdown file that serves as living documentation for AI agents. It describes every endpoint, parameter, example query, and workflow — so an agent can discover the API, understand how to call it, and handle edge cases like exact name matching or payment prompts, all without human guidance. It also includes a version check so agents are notified when a newer skill is available, AgentCash instructions for automatically handling x402 payments, and pointers to companion files — SPONSOR_RESOURCES.md for sponsor-specific docs and MCP server setup, and HACKATHON_FAQ.md for event rules, eligibility, and general hackathon questions.
