HackBarna

Skillathon API Docs

Submit and browse Skillathon projects programmatically via REST API or Claude skill.

Overview

The Skillathon API lets you submit Claude skill demos programmatically โ€” perfect for automated submission scripts or the Skillathon Claude skill. All project data is stored in Convex and updates in real time on the site.

Base URL: https://hackbarna-skillathon.netlify.app

Authentication

The submission endpoint requires a personal API key passed as a Bearer token. Keys don't expire โ€” you can revoke them anytime from your account page.

  1. 1Sign in to Skillathon with your email (magic link).
  2. 2Go to your Account page and generate a new API key.
  3. 3Copy the key immediately โ€” it's shown only once.
bash
# Set your key as an env var
export SKILLATHON_API_KEY=sk_your_key_here

Submit a project

POST /api/submit

bash
curl -X POST https://hackbarna-skillathon.netlify.app/api/submit \
  -H "Authorization: Bearer $SKILLATHON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Awesome Skill",
    "description": "A skill that does amazing things with Claude.",
    "authorName": "Jane Doe",
    "installCommand": "janedoe/my-awesome-skill",
    "tags": ["Developer Tools", "AI/ML"],
    "teamMembers": [],
    "githubUrl": "https://github.com/janedoe/my-awesome-skill"
  }'

Response:

json
{ "id": "j57abc123xyz..." }

Update a project

PATCH /api/update โ€” requires auth. Only the original submitter can update their project.

Pass the project id (returned from submit) plus any fields you want to change. Omitted fields are left unchanged.

bash
curl -X PATCH https://hackbarna-skillathon.netlify.app/api/update \
  -H "Authorization: Bearer $SKILLATHON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "j57abc123xyz...",
    "description": "Updated description with more detail.",
    "installCommand": "janedoe/my-awesome-skill",
    "mediaType": "youtube",
    "mediaUrl": "https://youtube.com/watch?v=..."
  }'

Response:

json
{ "id": "j57abc123xyz..." }

List projects

GET /api/projects โ€” public, no auth required.

bash
curl https://hackbarna-skillathon.netlify.app/api/projects

Submit via Claude skill

The easiest way to submit is via the Skillathon submit skill. Claude will guide you through the submission interactively.

1. Install the skill

bash
npx skills add hackbarna/skillathon

2. Set your API key

bash
export SKILLATHON_API_KEY=sk_your_key_here

3. Run it in Claude Code

text
/submit-project

If SKILLATHON_API_KEY is not set, Claude will prompt you to generate one from the account page.

Field reference

FieldTypeRequiredDescription
titlestringrequiredProject / skill name
descriptionstringrequiredWhat your skill does (up to 2000 chars)
authorNamestringrequiredYour display name
installCommandstringoptionalowner/repo โ€” becomes npx skills add owner/repo
teamMembersstring[]optionalList of collaborator names
tagsstring[]optionalOne or more of: Productivity, Developer Tools, AI/ML, Data, Design, Communication, Education, Fun, Utilities, Integration
githubUrlstringoptionalLink to GitHub repo or Gist
mediaType'youtube' | 'vimeo' | 'image'optionalType of demo media
mediaUrlstringoptionalURL to YouTube video, Vimeo video, or image