Skip to main content

​
Better Skills

Better Skills is an agent second brain system that helps you manage, sync, and reuse skills across AI coding agents through an intelligent skill graph architecture.

CLI Interface

Command-line tool built with tRPC for local skill management and sync

Web Dashboard

Next.js web console for browsing skills, managing vaults, and visualizing your skill graph

Skill Vaults

Organize skills in personal, enterprise, or system-default vaults with fine-grained access control

Graph Links

Build a knowledge graph with skill-to-skill and skill-to-resource relationships

​
What are Skills?

Skills are reusable knowledge artifacts that agents can load and execute. Each skill contains:
  • A SKILL.md file with structured instructions and metadata
  • Optional reference documents, scripts, and assets
  • Links to related skills and resources through a graph structure
  • Frontmatter metadata for routing and agent context
Skills are scoped to vaults (personal, enterprise, or system-default) and can be synced across your local development environment and the web dashboard.

​
Platform Overview

Better Skills provides three ways to interact with your skill graph:

​
CLI

The command-line interface connects to your Better Skills server via tRPC and supports:
  • Authentication with device flow login
  • Syncing skills to local .agents/skills/ directories
  • Creating, updating, and deleting skills
  • Cloning skills for local editing
  • Searching and listing skills across vaults
  • Validating skill structure and markdown mentions

​
Web Dashboard

The Next.js web application provides:
  • Visual skill browser with vault organization
  • Skill editor with markdown preview
  • Interactive graph visualization
  • Vault membership and invitation management
  • Account settings and preferences
Access the dashboard at better-skills.dev

​
API

Built with Hono and tRPC, the Better Skills API offers:
  • End-to-end type-safe endpoints
  • Better Auth authentication
  • PostgreSQL storage with Drizzle ORM
  • Skill CRUD operations
  • Graph query and link management
  • Vault and membership operations

​
Key Features

Multi-Vault Architecture

Separate personal, enterprise, and system skills with role-based access control

Markdown Mentions

Link skills and resources with [[skill:uuid]] and [[resource:uuid]] syntax

Auto Link Sync

Automatically maintain graph edges from markdown mention tokens

Resource Management

Organize reference docs, scripts, and assets within each skill

Local Clone & Edit

Clone skills to local directories, edit with your tools, then push updates

Skill Discovery

Search across vaults, list by ownership, and explore the knowledge graph

​
Technology Stack

Better Skills is built with the Better-T-Stack:
  • TypeScript for type safety across the entire stack
  • Next.js for the web frontend
  • Hono for the lightweight, performant API server
  • tRPC for end-to-end type-safe APIs
  • Bun as the runtime and package manager
  • Drizzle ORM with PostgreSQL (Neon)
  • Better Auth for authentication
  • TailwindCSS and shadcn/ui for the UI
  • Turborepo for monorepo builds

​
Use Cases

Load domain-specific skills into your coding agent’s context (OpenCode, Cursor, Windsurf, etc.) for specialized knowledge on frameworks, best practices, and workflows.
Create enterprise vaults to share company-specific patterns, APIs, and conventions across your engineering team.
Build your own library of reusable skills for frameworks, tools, and techniques you use frequently.
Version control your skills as markdown files, sync them to your agents, and maintain a living knowledge graph.

​
Getting Started

1

Install the CLI

Install the Better Skills CLI with the one-line installer:
curl -fsSL https://better-skills.dev/install | bash
2

Login

Authenticate with device flow:
better-skills login
3

Sync Your Skills

Sync your vault skills to local .agents/skills/ directories:
better-skills sync
4

Explore

List your skills, search, and clone for editing:
better-skills list
better-skills clone <skill-slug>

Ready to dive in?

Follow the quickstart guide to install Better Skills and sync your first skill.

​
Architecture

Better Skills follows a feature-first monorepo structure: 
better-skills/
├── apps/
│   ├── cli/         # Command-line interface (@clack/prompts)
│   ├── web/         # Next.js web console
│   └── server/      # Hono API + Better Auth
├── packages/
│   ├── api/         # tRPC router and business logic
│   ├── auth/        # Authentication configuration
│   ├── db/          # Drizzle schema and migrations
│   ├── env/         # Runtime environment contracts
│   ├── markdown/    # Markdown parsing and mention utilities
│   └── config/      # Shared TypeScript config
└── resources/
    └── default-skills/  # System-default skill templates
Better Skills uses Bun workspaces and Turborepo for optimized builds. All commands use bun (not npm/yarn/pnpm).

​
Community and Support

​
Next Steps

Quickstart

Install and sync your first skill in under 5 minutes

CLI Reference

Complete CLI command reference and usage examples

Concepts

Learn about vaults, skills, resources, and the skill graph

API Reference

Explore the tRPC API endpoints and schemas

Build docs developers (and LLMs) love

Get started for freeTalk to us