Skip to content

Skillnote

The open-source skill registry for AI coding agents. Create, manage, and distribute SKILL.md files across Openclaw, Claude Code, Cursor, Codex, OpenHands, Antigravity, and more.

Install

$npx skillnote start
Claude Code
claude mcp add skillnote -- npx skillnote start
Cursor / Claude Desktop (mcp.json)
{
  "mcpServers": {
    "skillnote": {
      "command": "npx",
      "args": [
        "skillnote",
        "start"
      ]
    }
  }
}

Install command taken from the project's README or registry entry. Always review code before running it.

S K I L L N O T E

The open-source skill registry for AI coding agents.

Self-host your team's SKILL.md library. Version it, scope it, and ship it to Claude Code and OpenClaw from one CLI.

Quick start  ·  Why  ·  Features  ·  Agents  ·  Architecture  ·  FAQ  ·  Discord


The 8,000-character problem

Claude Code shares ~8,000 characters across every active skill description (docs). Past that limit, descriptions silently truncate. The system prompt forbids using skills that aren't listed in context, so truncated skills are both invisible and explicitly off-limits (#13343, #40121).

In practice, past ~15 active skills your skills stop working and you can't tell which ones. New teammates have no way to discover what skills the project depends on. Updating a shared skill means re-zipping and re-uploading for everyone. And private skills, like deploy procedures, compliance workflows, or internal API patterns, have nowhere safe to live.

SkillNote is a self-hosted registry that fixes that. Per-project collections scope which skills load. Live sync pushes browser edits to every connected agent within 60 seconds. Agents rate skills 1 to 5 after using them, so you finally have signal on what works. Your skills stay on your infrastructure. Your servers, your rules.

Without SkillNote With SkillNote
Skills truncate past ~15 active Collections scope to 15 per project
~/.claude/skills/ per laptop One registry, every agent
Re-zip + re-upload to share an edit Edit in browser, every session picks it up in 60s
No signal on what actually works Agents rate every skill they use, 1-5 + comment
Private skills have nowhere safe Self-hosted; never leaves your network

Quick start

npx skillnote start

Opens http://localhost:3000.

Requires Docker (running) and Node.js 20+. The CLI pulls the published images from GHCR, brings up the web + API + Postgres stack, waits for healthchecks, and opens the dashboard. About 30 seconds on a warm cache.

┌────────────────────────────────────────────┐
│  SkillNote ▸  the skill registry for AI    │
│  v0.5.2 · github.com/luna-prompts/skillnote│
└────────────────────────────────────────────┘
◇  Prerequisites ok
◇  Images pulled
◇  Containers running
◇  Services healthy

╭────────┬──────────────────────────────╮
│ Web UI │ http://localhost:3000        │
│ API    │ http://localhost:8082        │
╰────────┴──────────────────────────────╯

Other ways to install

Docker Compose directly (no Node):

curl -fsSL https://raw.githubusercontent.com/luna-prompts/skillnote/cli-v0.5.4/deploy/docker-compose.yml -o docker-compose.yml
docker compose up -d

LAN-accessible for teammates on the same network:

SKILLNOTE_HOST=<your-lan-ip> docker compose up -d

Podman: npx skillnote start is Docker-only, but the Compose path and install.sh both work with podman compose (Podman 4+) or podman-compose.

Building from source (contributors):

git clone https://github.com/luna-prompts/skillnote.git
cd skillnote && ./install.sh

Similar plugs

Open-source AI job search agent and job finder: scan job boards, score each job 1-5 against your CV before you apply, tailor an ATS-friendly resume and cover letter, get…

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, and Pi. 44 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

Secure, fast, efficient, battle-tested at Alibaba's scale. Hybrid architecture code review tool: deterministic pipelines + LLM Agent, precise line-level comments, built-in…

Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection…