Live v0.2.1

skillc

The development kit for Agent Skills — create, validate, and optimize skills that extend AI agent capabilities.

Agent Skills define what a skill is. skillc provides the how: tooling to author, lint, build, and trace skills throughout their lifecycle.

Documentation GitHub

Install

cargo install skillc

# Creates the `skc` binary

Who is this for?

Two Workflows

Skill Authors

Create, validate, and test skills locally before publishing with confidence.

1. skc init → scaffold

2. skc lint → validate

3. skc build → test locally

4. skc stats → trace usage

5. git push → publish

Power Users

Compile any skill to unlock full-text search and usage analytics.

1. skc build → enable indexing

2. skc search → find content

3. skc stats → track usage

Note: Building is optional for consumers. Published skills work without compilation.

Capabilities

What skillc Does

Scaffolding

Create new skills with skc init. Project-local or global, properly structured from the start.

Linting

17 lint rules (SKL1xx-SKL4xx) validate frontmatter, structure, links, and file organization.

Compilation

Build skills to runtime format with search index. Deploy to Claude, Cursor, or custom targets.

Full-Text Search

FTS5-indexed search over skill content. Find anything instantly with skc search.

Usage Analytics

Track which sections agents actually read. Group by sections, files, commands, or search terms.

MCP Integration

All read commands exposed as MCP tools. Direct agent integration via skc mcp server.

Reference

CLI Commands

Authoring

author

skc init my-skill

skc lint my-skill

skc build my-skill --target cursor

skc list

Reading

read

skc outline my-skill --level 2

skc show my-skill --section "API"

skc search my-skill "borrow checker"

Analytics

stats

skc stats my-skill --group-by sections

skc stats my-skill --group-by search

skc sync --dry-run

MCP Server

mcp

skc mcp

# Exposes: skc_outline, skc_show,

# skc_search, skc_build, skc_lint...

Quality

Lint Rules

17 rules across 4 categories ensure skill quality before publishing.

SKL1xx

Frontmatter

name, description, format

SKL2xx

Structure

size, headings, hierarchy

SKL3xx

Links

file exists, anchors, escapes

SKL4xx

Files

orphan detection

Storage

Where Skills Live

.skillc/skills/

Project-local skills

~/.skillc/skills/

Global source store

~/.claude/skills/

Claude runtime (deployed)

~/.cursor/skills/

Cursor runtime (deployed)