SkillAtlas

SkillAtlas

The open marketplace for AI Agent Skills.

[English](#english) | [中文](#中文)

---

English

What is SkillAtlas?

**SkillAtlas** is a self-hostable marketplace and registry for **AI agent skills** — the modular packages (like `SKILL.md`, prompt kits, scripts, and small workflows) that you drop into Claude Code, Codex, OpenCode, Hermes, and other coding agents to extend their capabilities.

It's the registry we wished existed while we were stitching together half a dozen skill repos every weekend. Single source of truth, search, install manifests, ratings, reviews, and a built-in **test harness** that deterministically checks a skill is well-formed before you ship it to your agent.

Features

• Browse & search — full-text search across name, summary, tags, description; filters by category, author, "featured".
• Publish a skill — POST /api/skills with a SKILL-style manifest and your handle; SkillAtlas stores it, builds an install manifest, and increments install counts.
• Install manifest — every skill exposes a SkillManifest document (GET /api/skills/{slug}/install) that any CL
• Reviews & 1–5 ratings — community feedback, helpful votes, top-rated board.
• Test harness — /api/harness/run runs deterministic offline checks (format_valid, input_within_scope, no_secrets_present) against any skill before you install it.
• Stats & dashboards — aggregated counts, downloads, avg rating, top categories.
• Beautiful dark-mode SPA — built in React 18 + TypeScript, served by FastAPI as static assets.
• Self-contained deployment — single FastAPI server + SQLite, zero external services. Multi-stage Dockerfile (Node 22 → Python 3.13) ships the static UI alongside the API.

Quick start

Option A: local Python

git clone https://github.com/Eileenes/SkillAtlas.git
cd SkillAtlas
python3.13 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# (one-time) buil