Skrills
Skills support engine for Claude Code, Codex CLI, GitHub Copilot CLI,
and Cursor.
Installation |
User Guide |
CLI Reference |
MCP Tutorial |
FAQ |
Changelog
What's new in 0.7.3 -- MCP tool filtering
(allowed_tools/disabled_tools) synced across all adapters,
MCP servers panel in TUI and browser dashboards,
/api/mcp-servers REST endpoint, configurable Unpaywall email,
OffsetDateTime for discussion timestamps, and SQL upsert fix.
See changelog.
Demo
TUI dashboard -- navigate skills, activity, and metrics with
keyboard shortcuts:
See the quickstart tutorial for a
walkthrough, or the MCP tutorial for server
setup.
Features
- Cross-CLI validation -- validates skills against Claude Code
(permissive), Codex CLI (strict), Copilot CLI (strict), and Cursor
rules. Auto-derives missing YAML frontmatter from file paths and
content.
- Multi-directional sync -- syncs skills, commands, agents, MCP
servers, rules, and preferences across all four environments. Uses
file hashing to respect manual edits so user changes are not
overwritten.
- Token analytics -- measures token usage per skill and suggests
reductions to fit context windows.
- Dependency resolution -- resolves skill dependencies with cycle
detection and semantic versioning constraints.
- MCP server -- 27 tools for validation, sync, intelligence, and
project-aware skill generation over stdio or HTTP transport.
- Session mining -- parses Claude Code and Codex CLI session
history to improve recommendations based on actual usage.
- Visualization -- TUI and browser dashboard showing discovered
skills, validation status, usage metrics, and MCP server
configurations with tool filter indicators. The browser dashboard
supports light and dark modes. The standalone
skrills-portal.html can be opened directly
in a browser or uploaded to integration platforms without a running
server.
- Discovery deduplication -- frontmatter identity matching
consolidates the same skill installed in multiple locations.
Installation
macOS / Linux:
curl -LsSf https://raw.githubusercontent.com/athola/skrills/HEAD/scripts/install.sh | sh
Windows PowerShell:
powershell -ExecutionPolicy Bypass -NoLogo -NoProfile -Command ^
"Remove-Item alias:curl -ErrorAction SilentlyContinue; iwr https://raw.githubusercontent.com/athola/skrills/HEAD/scripts/install.ps1 -UseBasicParsing | iex"
crates.io: cargo install skrills
See installation guide for HTTP transport
setup, systemd services, and advanced options.
Quickstart
# Validate skills for Codex/Copilot/Cursor compatibility
skrills validate --target both --autofix
# Analyze token usage
skrills analyze --min-tokens 1000 --suggestions
# Sync from Claude to all other CLIs
skrills sync-all
# Sync between specific environments
skrills sync --from cursor --to claude
# Start MCP server and open the browser dashboard
skrills serve --http 127.0.0.1:3000 --open
# Interactive TUI dashboard
skrills tui
# Launch an agent with automatic backend routing (Claude -> Codex fallback)
skrills multi-cli-agent my-agent
See CLI reference for all commands including
skill lifecycle management.
Supported Environments
Skrills syncs seven asset types across four CLI environments.
Each cell reflects what the adapter reads and writes today:
