https://github.com/athola/skrills

Coordinate skills between Codex, Copilot, and Claude Code. Validates, analyzes, and syncs skills, subagents, commands, and configuration between multiple CLIs.
https://github.com/athola/skrills

claude-code claude-skills codex codex-cli codex-skills copilot copilot-skills mcp mcp-server skills

Last synced: 2 months ago
JSON representation

Coordinate skills between Codex, Copilot, and Claude Code. Validates, analyzes, and syncs skills, subagents, commands, and configuration between multiple CLIs.

Host: GitHub
URL: https://github.com/athola/skrills
Owner: athola
License: mit
Created: 2025-11-24T17:23:54.000Z (7 months ago)
Default Branch: master
Last Pushed: 2026-01-27T08:15:21.000Z (5 months ago)
Last Synced: 2026-01-27T21:09:18.385Z (5 months ago)
Topics: claude-code, claude-skills, codex, codex-cli, codex-skills, copilot, copilot-skills, mcp, mcp-server, skills
Language: Rust
Homepage: https://athola.github.io/skrills
Size: 4.96 MB
Stars: 44
Watchers: 1
Forks: 8
Open Issues: 11
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Audit: audit.toml
- Security: docs/security.md
- Agents: AGENTS.md

Awesome Lists containing this project

README

          # Skrills



  



[![Crates.io](https://img.shields.io/crates/v/skrills.svg)](https://crates.io/crates/skrills)

[![Downloads](https://img.shields.io/crates/d/skrills.svg)](https://crates.io/crates/skrills)

[![Docs](https://img.shields.io/github/actions/workflow/status/athola/skrills/book-pages.yml?branch=master&label=docs)](https://athola.github.io/skrills/)

[![CI](https://img.shields.io/github/actions/workflow/status/athola/skrills/ci.yml?branch=master&label=ci)](https://github.com/athola/skrills/actions/workflows/ci.yml)

[![Coverage](https://img.shields.io/github/actions/workflow/status/athola/skrills/coverage.yml?branch=master&label=coverage)](https://github.com/athola/skrills/actions/workflows/coverage.yml)

[![Audit](https://img.shields.io/github/actions/workflow/status/athola/skrills/audit.yml?branch=master&label=audit)](https://github.com/athola/skrills/actions/workflows/audit.yml)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

Skills support engine for Claude Code, Codex CLI, GitHub Copilot CLI,

and Cursor.

[Installation](book/src/installation.md) |

[User Guide](https://athola.github.io/skrills/) |

[CLI Reference](book/src/cli.md) |

[MCP Tutorial](docs/tutorials/mcp.md) |

[FAQ](docs/FAQ.md) |

[Changelog](book/src/changelog.md)

> **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](book/src/changelog.md).

## Demo

![Skrills Demo](assets/gifs/quickstart.gif)

**TUI dashboard** -- navigate skills, activity, and metrics with

keyboard shortcuts:

![TUI Dashboard](assets/gifs/dashboard.gif)

See the [quickstart tutorial](docs/tutorials/quickstart.md) for a

walkthrough, or the [MCP tutorial](docs/tutorials/mcp.md) 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`](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:**

```bash

curl -LsSf https://raw.githubusercontent.com/athola/skrills/HEAD/scripts/install.sh | sh

```

**Windows PowerShell:**

```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](book/src/installation.md) for HTTP transport

setup, systemd services, and advanced options.

## Quickstart

```bash

# 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](book/src/cli.md) 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:

| Asset | Claude Code | Codex CLI | Copilot CLI | Cursor |

|-------|:-----------:|:---------:|:-----------:|:------:|

| Skills | Y | Y | Y | Y |

| Commands | Y | Y | -- | Y |

| Agents | Y | -- | Y | Y |

| MCP Servers | Y | Y | Y | Y |

| Hooks | Y | -- | -- | Y |

| Instructions / Rules | Y | -- | Y | Y |

| Preferences | Y | Y | Y | -- |

Cursor rules (`.mdc` files) are mapped bidirectionally via mode

derivation (`alwaysApply`, glob-scoped, agent-requested).

See [ADR 0006](docs/adr/0006-cursor-rules-mapping.md) for the

mapping strategy and [sync guide](book/src/sync-guide.md) for

workflows.

## Skill Management

```bash

# Deprecate, rollback, import, or score skills

skrills skill-deprecate old-skill --replacement "new-skill"

skrills skill-rollback my-skill --version abc123

skrills skill-import https://example.com/skill.md

skrills skill-score

```

See [CLI reference](book/src/cli.md) for the full set of

`skill-*` subcommands (`skill-catalog`, `skill-profile`,

`skill-usage-report`).

## Architecture

| Crate | Purpose |

|-------|---------|

| `cli` | Binary entry point (delegates to `server` crate) |

| `server` | MCP server, HTTP transport, security middleware |

| `validate` | Validation logic for Claude/Codex/Copilot/Cursor compatibility |

| `analyze` | Token counting, dependency analysis, optimization |

| `intelligence` | Recommendations, project analysis, skill generation |

| `sync` | Multi-directional sync with adapters for each CLI (Claude, Codex, Copilot, Cursor) |

| `dashboard` | TUI and browser-based skill visualization |

| `discovery` | Skill discovery and ranking |

| `state` | Environment config, manifest settings, runtime overrides |

| `metrics` | SQLite-based telemetry for invocations, validations, sync |

| `subagents` | Shared subagent runtime and backends |

| `tome` | Research API orchestration, caching, PDF serving |

| `test-utils` | Shared test infrastructure (fixtures, RAII guards, temp dirs) |

See [architecture docs](docs/architecture.md) for the crate

dependency graph and runtime flow.

## Configuration

Create `~/.skrills/config.toml` for persistent settings:

```toml

[serve]

auth_token = "your-secret-token"

tls_auto = true

cors_origins = "https://app.example.com"

```

Precedence: CLI flags > environment variables > config file.

See [security docs](docs/security.md) for TLS setup (`skrills cert`

subcommand) and [FAQ](docs/FAQ.md) for environment variables.

## Documentation

| Resource | Description |

|----------|-------------|

| [User Guide](https://athola.github.io/skrills/) | Primary documentation (mdBook) |

| [CLI Reference](book/src/cli.md) | All commands with examples |

| [MCP Tutorial](docs/tutorials/mcp.md) | Server setup and tool reference |

| [Sync Guide](book/src/sync-guide.md) | Cross-CLI sync workflows (Claude, Codex, Copilot, Cursor) |

| [Token Optimization](book/src/mcp-token-optimization.md) | Context window management |

| [FAQ](docs/FAQ.md) | Common questions |

| [Security](docs/security.md) | Auth, TLS, threat model |

| [Changelog](book/src/changelog.md) | Release history |

## Limitations

- **No runtime skill injection**: Skrills validates and syncs

  files; it does not inject skills into prompts at runtime.

- **Copilot command sync**: Copilot CLI does not support slash

  commands, so command sync is skipped.

- **Cursor preferences**: Cursor preferences are not yet mapped;

  preference sync is skipped for Cursor targets.

- **Empirical mining**: Session history parsing works best with

  recent Claude Code / Codex CLI versions.

- **LLM generation**: Requires `ANTHROPIC_API_KEY` or

  `OPENAI_API_KEY` for skill creation.

## Plugin Marketplaces

Skrills validates, analyzes, and syncs skills from these exemplar

plugin marketplaces:

- [superpowers](https://github.com/obra/superpowers) -- Opinionated

  skill pack for Claude Code covering TDD, code review, planning,

  debugging, and development workflows.

- [claude-night-market](https://github.com/athola/claude-night-market)

  -- Plugin marketplace for Claude Code with skills, agents, hooks,

  and commands across multiple domains.

## Development

```bash

make lint test --quiet

```

Requires Rust 1.75+. See [development guide](book/src/development.md)

for test coverage, CI, and contribution workflow.

## Contributing

- **Security issues**: See [security policy](docs/security.md) and

  [threat model](docs/threat-model.md)

- **Bug reports**: Include OS, `skrills --version`, and logs

  (`--trace-wire` for MCP)

- **Pull requests**: Follow

  [process guidelines](docs/process-guidelines.md); update docs/tests

  with code

## License

[MIT](LICENSE)

[![Star History Chart](https://api.star-history.com/svg?repos=athola/skrills&type=date&legend=top-left)](https://www.star-history.com/#athola/skrills&type=date&legend=top-left)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/athola/skrills

Awesome Lists containing this project

README