AI Hackathon Skill — AI skill for Claude Code

ai-hackathon-skill

**AI 와 만들고 AI 와 채점한다 — 1 운영자가 AI 에이전트와 함께 굴리는 해커톤.**

이건 **Anthropic Claude Skills 표준 Self-contained Skill** 입니다. 호스트 코딩 에이전트(Claude Code · Cursor · Codex CLI)에 fork 해두면 자연어 한 줄로 기획 · 채점 · 리더보드까지 자동. 운영자는 dashboard 에서 결과만 본다.

3 모델 (Claude · Gemini · OpenAI) 이 팀 설명 · GitHub 코드 · YouTube 시연 영상을 **함께 검토** 하여 독립 채점, 동료 평가 · 심사위원과 가중 합산. MIT.

미리보기

소개 페이지	대시보드
제출물 — 4-step UX (markdown + URL → evidence → 검토 → 채점)	리더보드 — 메달 카드 + AI · 동료 · 심사위원 가중 합산

Self-contained Skill 이란

**SKILL.md** 한 파일이 진입점. 호스트 코딩 에이전트가 자연어 명령을 받으면 이 파일의 frontmatter `description` 으로 매칭, 안의 절차대로 셸을 호출합니다.

일반 Anthropic Skill (prompt + template 만) 과 다른 점: 이 스킬은 `scripts/` (3 LLM API 셸 호출) · `dashboard/` (Next.js UI) · `tests/` (셀프 테스트) 까지 포함한 **self-contained** 형태. 운영자는 자연어 한 줄, 결과는 브라우저 dashboard 로.

사용 방법 (호스트 환경별)

1. Claude Code (Anthropic) ⭐ 권장 — 1급

# 사전 준비 (1 회)
brew install jq curl bun git
git clone https://github.com/gd452/ai-hackathon-skill ~/Development/ai-hackathon-skill
ln -s ~/Development/ai-hackathon-skill ~/.claude/skills/ai-hackathon   # 글로벌 등록
cd ~/Development/ai-hackathon-skill/dashboard && bun install
cat > .env.local <<'EOF'                                                # API 키 3 개
ANTHROPIC_API_KEY=sk-ant-...
GEMINI_API_KEY=...
OPENAI_API_KEY=sk-...
EOF
chmod 600 .env.local

이후부터 Claude Code 안에서:

"ai-hackathon 시작해줘"

→ Claude Code 가 `SKILL.md` description 으로 자동 매칭 → 안내된 절차대로 `bun run dev` 실행 → `http://localhost:3000` 자동 오픈 → 운영자는 dashboard 에서 작업.

2. Cursor / Windsurf ⭐ 권장

• 프로젝트 .cursorrules 에 SKILL.md 내용 import (또는 agent context 로 첨부)
• 그 후 같은 자연어 흐름 — "ai-hackathon 시작해줘"

3. Codex CLI (ChatGPT 계정) — 가능

codex exec --sandbox workspace-write \
  --cd ~/Deve