Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Project Comparison

This table compares skrills against alternative approaches for managing and deploying skills across Claude Code and Codex CLI.

Project TypeKey ComponentsTransport/RuntimeAutomation InterfaceKey StrengthsDistinguishing Gaps (vs. skrills)
skrillsMCP server, CLI, validation/analysis crates, skill synchronization utilitiesMCP over stdio; single binaryCLI, MCP tools, release artifacts per targetUnified MCP layer, cross-agent synchronization, skill validation with autofix, token analysis, TUI/CLI feature parity
Static skill bundlesReady-to-use skill filesNone (static)Manual copyStraightforward, drop-in content deploymentLacks validation, analysis, or synchronization. No MCP server or Codex bridging.
CI doc/render pipelinesBuild-time convertersBuild-time onlyCI (GitHub Actions, custom pipelines)Automates documentation renderingNo runtime server, skill discovery, or synchronization; limited to prompt-only operations.
Shared rules repositoriesCurated collections of rules and skillsNot applicable (static)Manual consumptionProvides common baseline rulesetLacks installer, automation, or MCP bridge.
Local skill sync CLIsCLI or TUI for local skill synchronizationLocal synchronization only; no MCPCLI/TUIAllows effective local curation and mirroringNo MCP server, no validation/analysis, limited to basic file sync.
Tutorials/how-to guidesInstructional content for authoring skillsNot applicableArticle/docsEducationalLacks integrated tooling; relies on manual steps.

Core Differentiators

Validation Engine

Skrills validates skills against two targets:

  • Claude Code: Permissive - accepts any markdown with optional frontmatter
  • Codex CLI: Strict - requires YAML frontmatter with name and description

The --autofix flag automatically adds missing frontmatter.

Token Analysis

Skrills analyzes skills for:

  • Token count estimation
  • Dependency tracking
  • Optimization suggestions for large skills

Bidirectional Sync

Unlike tools that only copy files one way, skrills supports full bidirectional sync:

  • Skills, commands, MCP servers, and preferences
  • Byte-for-byte command sync preserves non-UTF-8 content
  • --skip-existing-commands protects local customizations

Areas for Improvement

  • Add signed artifacts and version pinning for synced skills
  • Improve Windows path detection and default configurations
  • Add skill dependency resolution

Summary

Skrills is a skills support engine focused on quality and portability. It validates skills for cross-CLI compatibility, analyzes token usage, and synchronizes configurations bidirectionally. The MCP server enables integration with both Claude Code and Codex CLI environments.