#SkillHub.md — Agent Skill Registry
Project Overview
#SkillHub.md is a Single-Page Application (SPA) built for the 2026 Product Cadet Challenge by insightfactory.ai . It lets users upload, manage, and share markdown-based skill files for AI agents like Claude Code — the files contain instructions and metadata that guide agents in performing specific tasks.
Features
Essential
- User authentication with username/password
- Upload markdown skill files (private by default) with automatic frontmatter parsing (
name,description,allowed-tools) - Edit and delete skill files
- Tag assignment and management
- Publish skills as public and browse/search/download public skills from other users
Nice-to-Have
- Download and view count tracking
- Version history with last-edited timestamps
- GitHub-style diff viewer between versions
- Clone public skills with source attribution
- Analytics dashboard (activity trends, top tags)
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | Vite + React + Tailwind CSS |
| Backend | FastAPI (Python) |
| Database | SQLite |
| Infra | Docker + Docker Compose |
Architecture: SPA with a dedicated REST API backend. FastAPI was chosen for strong typing, async support, and auto-generated Swagger docs. React + Vite for fast iteration; SQLite for simplicity with a storage-agnostic design ready for future migration.
Demo
Quick Start (Docker)
docker compose up --build
# Frontend: http://localhost:5173
# Backend (Swagger): http://localhost:8000/docs
Demo account — Username: demo / Password: Password123@