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.
- 1Sign in to Skillathon with your email (magic link).
- 2Go to your Account page and generate a new API key.
- 3Copy the key immediately โ it's shown only once.
# Set your key as an env var export SKILLATHON_API_KEY=sk_your_key_here
Submit a project
POST /api/submit
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:
{ "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.
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:
{ "id": "j57abc123xyz..." }List projects
GET /api/projects โ public, no auth required.
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
npx skills add hackbarna/skillathon
2. Set your API key
export SKILLATHON_API_KEY=sk_your_key_here
3. Run it in Claude Code
/submit-project
If SKILLATHON_API_KEY is not set, Claude will prompt you to generate one from the account page.
Field reference
| Field | Type | Required | Description |
|---|---|---|---|
| title | string | required | Project / skill name |
| description | string | required | What your skill does (up to 2000 chars) |
| authorName | string | required | Your display name |
| installCommand | string | optional | owner/repo โ becomes npx skills add owner/repo |
| teamMembers | string[] | optional | List of collaborator names |
| tags | string[] | optional | One or more of: Productivity, Developer Tools, AI/ML, Data, Design, Communication, Education, Fun, Utilities, Integration |
| githubUrl | string | optional | Link to GitHub repo or Gist |
| mediaType | 'youtube' | 'vimeo' | 'image' | optional | Type of demo media |
| mediaUrl | string | optional | URL to YouTube video, Vimeo video, or image |