Write a skill once, use it everywhere. Skrills validates and syncs skills, commands, agents, MCP servers, and hooks across **Claude Code, Codex CLI, GitHub Copilot CLI, and Cursor**, all from a single Rust binary. Install · User Guide · CLI Reference · FAQ ·
A plugin marketplace for Claude Code. Install only the plugins you need to run git workflows, code review, spec-driven development, and autonomous agents from inside your Claude Code session.
@atholaFAQ
skrills is a Claude Code plugin with 1 hand-picked skill for development work, indexed on Flowy. Install it with the command on its page. It includes html-portal-generator. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
> /plugin marketplace add athola/skrills> /plugin install skrills@skrills-marketplace
Repo: athola/skrills
Write a skill once, use it everywhere. Skrills validates and syncs skills, commands, agents, MCP servers, and hooks across Claude Code, Codex CLI, GitHub Copilot CLI, and Cursor, all from a single Rust binary.
Install · User Guide · CLI Reference · FAQ · Changelog
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"
Or cargo install skrills. See the
installation guide for HTTP transport and
service setup.
Skrills handles the loop of writing skills and keeping every CLI current. The common jobs:
Make your Claude skills work everywhere. Codex and Copilot are strict about frontmatter; Cursor uses its own rule format. Detect and fix the incompatibilities, then push to the other CLIs:
skrills validate --target both --autofix # fix missing/invalid frontmatter and body
skrills sync-all # mirror everything to all four CLIs
Keep two environments in sync. Edit in one, mirror to another. File hashing preserves manual edits on both sides:
skrills sync --from cursor --to claude
Trim context-window cost. Surface your token-heaviest skills with reduction suggestions:
skrills analyze --min-tokens 1000 --suggestions
Watch what's loaded, live. cold-window continuously re-reads your
plugins, skills, commands, and subagents, applying per-source token
attribution and tiered alerts. Render it as a terminal TUI or a browser
dashboard (or both):
skrills cold-window --tui # live TUI in this terminal (q / Ctrl-C to quit)
skrills cold-window --browser --port 8888 # same engine, browser dashboard at /dashboard
Keep it always-on in Zellij. Dedicate a pane
to the TUI that respawns if it exits. Save as
~/.config/zellij/layouts/skrills.kdl and launch with
zellij --layout skrills:
layout {
tab name="cold-window" focus=true {
pane command="bash" {
// Loop respawns the TUI after a crash or reboot.
args "-c" "until skrills cold-window --tui; do echo restarting...; sleep 2; done"
}
}
}
Already inside a Zellij session? Open it in a split without a layout
file: zellij run -d down -- bash -c 'until skrills cold-window --tui; do sleep 2; done'.
Let other tools call Skrills. The MCP server exposes 36 tools (validation, sync, intelligence, research) over stdio or HTTP:
skrills serve --http 127.0.0.1:3000 --open
See the quickstart tutorial for a full
walkthrough and the CLI reference for every command,
including skill lifecycle tools (skill-deprecate, skill-rollback,
skill-import, skill-score, skill-catalog).
Skrills syncs eight asset types across four CLIs. 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 | -- |
| Plugin Assets | Y | -- | -- | Y |
A dash means that asset doesn't sync to that CLI, either because the CLI
has no equivalent (Copilot CLI has no slash commands) or because the
mapping isn't built yet (Cursor preferences). Plugin assets sync to
Cursor's plugins/local/ so synced plugins appear installed, and
stale entries are pruned automatically. See the
sync guide for details.
Validate skills on every pull request with the reusable GitHub Action:
- uses: athola/skrills/.github/actions/validate-skills@v0.8.2
with:
targets: all
strict: true
path: skills/
Persistent settings live in ~/.skrills/config.toml (precedence: CLI
flags > environment variables > config file):
[serve]
auth_token = "your-secret-token"
tls_auto = true
cors_origins = "https://app.example.com"
See security docs for TLS setup and the FAQ for environment variables.
| Resource | Description |
|---|---|
| User Guide | Primary documentation (mdBook) |
| CLI Reference | All commands with examples |
| Sync Guide | Cross-CLI sync workflows |
| MCP Tutorial | Server setup and tool reference |
| Architecture | Crate graph and runtime flow |
| Security | Auth, TLS, threat model |
| Changelog | Release history |
ANTHROPIC_API_KEY or
OPENAI_API_KEY.make lint test --quiet
Builds on stable Rust. See the
development guide and
process guidelines. Update docs and tests
with code. Report bugs with your OS, skrills --version, and logs
(--trace-wire for MCP). For security, see the
security policy.
.claude-plugin/
marketplace.json
.githooks/
pre-commit
.github/
actions/
validate-skills/
action.yml
entrypoint.sh
FUNDING.yml
workflows/
audit.yml
book-pages.yml
ci.yml
coverage.yml
dependency-monitor.yml
integration-tests.yml
publish-dry-run.yml
release.yml
validate-skills-example.yml
.gitignore
.markdownlint.yaml
AGENTS.md
assets/
demo-skills/
api-designer/
SKILL.md
coding-assistant/
SKILL.md
debug-helper/
SKILL.md
git-workflow/
SKILL.md
test-writer/
SKILL.md
gifs/
cold-window.gif
dashboard.gif
mcp.gif
quickstart.gif
icon.png
tapes/
cold-window-overlay.sh
cold-window.tape
mcp.tape
portal-demo.mjs
quickstart.tape
tui.tape
audit.toml
book/
book.toml
src/
analysis.md
changelog.md
cli.md
cold-window.md
comparison.md
development.md
faq.md
installation.md
mcp-token-optimization.md
observability.md
overview.md
performance.md
persistence.md
playbooks.md
process.md
release.md
runtime-tuning.md
security.md
semver.md
SUMMARY.md
sync-guide.md
testing.md
validation.md
Cargo.lock
Cargo.toml
CONTRIBUTING.md
crates/
analyze/
benches/
tick_budget.rs
Cargo.toml
src/
cold_window/
alert.rs
cadence.rs
diff.rs
engine.rs
mod.rs
plugin_health.rs
skill_collector.rs
traits.rs
deps.rs
graph.rs
lib.rs
optimize.rs
resolve/
graph.rs
mod.rs
resolver.rs
types.rs
tokens.rs
tests/
cadence.rs
chaos.rs
tick_budget_floor.rs
token_attribution.rs
cli/
Cargo.toml
README.md
src/
main.rs
tests/
cli_dispatch_smoke.rs
sync_all.rs
dashboard/
Cargo.toml
README.md
src/
app.rs
cold_window/
alert_pane.rs
focus.rs
hint_pane.rs
keymap.rs
mod.rs
overlay.rs
research_pane.rs
state.rs
status_bar.rs
tui/
input.rs
layout.rs
mod.rs
render.rs
runner.rs
tests.rs
events.rs
lib.rs
ui.rs
tests/
ui_rendering.rs
discovery/
Cargo.toml
README.md
src/
error.rs
lib.rs
scanner.rs
types.rs
tests/
discover_smoke.rs
intelligence/
Cargo.toml
README.md
src/
cold_window_hints.rs
context/
dependencies.rs
detector.rs
git_context.rs
mod.rs
create/
cli_detector.rs
empirical.rs
github_search.rs
llm_generator.rs
mod.rs
error.rs
lib.rs
recommend/
comparative.rs
explainer.rs
mod.rs
scorer.rs
similarity.rs
scaffolding.rs
templates/
code-review.md
debugging.md
documentation.md
refactoring.md
testing.md
test_support.rs
types.rs
usage/
analytics.rs
behavioral.rs
claude_parser.rs
codex_parser.rs
mod.rs
metrics/
Cargo.toml
README.md
src/
baseline.rs
collector.rs
error.rs
lib.rs
schema.rs
types.rs
server/
AGENTS.md
Cargo.toml
README.md
src/
api/
cold_window.rs
mcp_servers.rs
metrics.rs
mod.rs
rules.rs
skills.rs
app/
dispatcher.rs
intelligence.rs
mcp_registry.rs
mod.rs
research.rs
skill_recommendations.rs
tests/
config.rs
dependency.rs
intelligence.rs
mcp.rs
mod.rs
research.rs
resource.rs
search.rs
sync.rs
trace.rs
validation.rs
tools.rs
cache.rs
cli/
enums.rs
mod.rs
cold_window_cli.rs
commands/
agent.rs
analyze.rs
cert.rs
diff.rs
intelligence.rs
metrics.rs
mod.rs
multi_cli_agent.rs
recommend.rs
resolve.rs
serve.rs
setup.rs
skill/
catalog.rs
deprecation.rs
import.rs
mod.rs
pre_commit.rs
profiling.rs
rollback.rs
scoring.rs
sync_pull.rs
usage_report.rs
sync.rs
validate.rs
config.rs
discovery.rs
doctor.rs
handler.rs
http_transport.rs
lib.rs
manifest.rs
mcp_gateway/
mod.rs
registry.rs
stats.rs
tools.rs
metrics_types.rs
runtime.rs
setup/
setup.rs
tests.rs
signals.rs
skill_trace.rs
sync.rs
test_support.rs
tls_auto.rs
tool_schemas.rs
trace.rs
tui.rs
ui/
app.rs
dashboard.js
mod.rs
static/
style.css
tests/
analytics_persistence_integration.rs
cold_window_first_paint.rs
cold_window_parity.rs
dashboard_api_integration.rs
dashboard_browser_integration.rs
http_transport_integration.rs
subagents_end_to_end.rs
snapshot/
Cargo.toml
src/
kill_switch.rs
lib.rs
serde_impls.rs
types.rs
state/
Cargo.toml
README.md
src/
cache.rs
env.rs
lib.rs
network.rs
subagents/
Cargo.toml
README.md
src/
backend/
claude.rs
cli.rs
codex.rs
config.rs
mod.rs
cli_detection.rs
lib.rs
registry.rs
service.rs
settings.rs
store.rs
tool_schemas.rs
tests/
integration_test.rs
store_reload.rs
subagent_basic_tests.rs
subagent_service_integration.rs
sync/
Cargo.toml
src/
adapters/
claude/
agents.rs
commands.rs
hooks.rs
instructions.rs
mod.rs
plugin_assets.rs
settings.rs
skills.rs
codex.rs
copilot/
agents.rs
commands.rs
mcp.rs
mod.rs
paths.rs
preferences.rs
skills.rs
tests.rs
utils.rs
cursor/
agents.rs
commands.rs
hooks.rs
mcp.rs
mod.rs
paths.rs
rules.rs
skills.rs
tests.rs
utils.rs
external.rs
mod.rs
tests_common.rs
traits.rs
utils.rs
common.rs
conflict.rs
error.rs
lib.rs
models.rs
orchestrator.rs
platform_routing.rs
preview.rs
report.rs
snapshot.rs
validation.rs
tests/
copilot_sync_integration.rs
cursor_sync_integration.rs
kill_switch_lock.rs
skills_sync_comprehensive.rs
sync_integration.rs
sync_skip_existing_tests.rs
test-utils/
... 126 more© 2026 Flowy · Free and open source
Built for Claude Code · Not affiliated with Anthropic