Changelog Highlights

0.3.4 (2025-12-19)

NEW: Skill Recommendations: Added skrills recommend CLI command and recommend-skills MCP tool for suggesting related skills based on dependency graph relationships (dependencies, dependents, and siblings).
Options: --limit for max recommendations, --include-quality for quality scores, --format for text/json output.

NEW: Metrics Command: Added skrills metrics CLI command and skill-metrics MCP tool for aggregate statistics including quality distribution, dependency graphs, and token usage.
NEW: Makefile Targets: Added make status, make install, make test-coverage, make security, and make deps-update for developer workflows.
Dependency Graph: Metrics include hub skill detection and orphan count from the dependency analysis.

NEW: Dependency Resolution: Skill dependency tracking via YAML frontmatter with semver constraints, circular dependency detection, and source pinning.
NEW: Skill Loading Trace: Diagnostic tools for debugging skill loading (skill-loading-status, skill-loading-selftest, trace enable/disable).
Dependency Syntax: Simple, structured, and compact syntax forms for declaring dependencies.
Optional Dependencies: Configurable behavior for optional dependencies.
Extended Validation: Dependency-related validation issues in the validate crate.
BREAKING: rmcp updated to 0.10 (removed deprecated info() method).
BREAKING: SkillSource enum now requires wildcard pattern matching.

NEW: Validation Crate (skrills-validate): Validate skills for Claude Code (permissive) and Codex CLI (strict frontmatter requirements). Includes auto-fix capability to add missing frontmatter.
NEW: Analysis Crate (skrills-analyze): Token counting, dependency analysis, and optimization suggestions for skills.
NEW: CLI Commands: Added skrills validate and skrills analyze commands for skill quality assurance.
NEW: MCP Tools: Added validate-skills and analyze-skills tools to the MCP server.
Architecture Pivot: Removed redundant skill-serving functionality now that Claude Code and Codex CLI have native skill support. Skrills now focuses on validation, analysis, and sync.
Comprehensive Tests: Added 53 tests for bidirectional skill sync.
REMOVED: Autoload functionality (autoload.rs, emit.rs).
REMOVED: CLI commands: list, list-pinned, pin, unpin, auto-pin, history, emit-autoload, render-preview.
REMOVED: MCP tools: list-skills, autoload-snippet, render-preview, runtime-status, set-runtime-options, pin-skills, unpin-skills, refresh-cache.

NEW: Subagents Module: Comprehensive subagent functionality with MCP server support via list-subagents, run-subagent, and get-run-status tools.
NEW: Backend Support: Dual backend support for both Claude-style and Codex-style subagent execution.
NEW: Sync Infrastructure: Cross-agent sync orchestration with SyncOrchestrator and adapters for Claude/Codex.
Documentation: Added comprehensive AGENTS.md with subagent usage examples.
BREAKING: Removed the gateway crate and related functionality. Replaced with simpler MCP server integration.
Security Fix: Updated rmcp from 0.9.1 to 0.10.0, replacing unmaintained paste with pastey.

Focus on Claude Code: Simplified integration to focus on Claude Code hook-based skill injection.
Installer Improvements: Added --client claude flag and SKRILLS_CLIENT environment variable.
Aligned workspace crates to version 0.3.0.

Publishing: Cargo publishing workflow with dependency validation and dry-run checks.
Release: Automated crate publishing to crates.io.
Testing: Improved test isolation in server module.
Documentation: Updated formatting and clarity.

Refactoring: Reorganized from monolithic to modular architecture.
Renaming: Project renamed from “codex-mcp-skills” to “skrills”.
Modular Architecture: New workspace with discovery, state, and server crates.
CI/CD: Added code coverage workflow and public API change checks.
Documentation: Added Mermaid diagrams for architecture visualization.

See full changelog for details on earlier releases including: