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

Changelog Highlights

0.7.7 (2026-04-15)

  • Refactor: Manifest-Only Plugin Sync: write_plugin_assets now writes manifests to plugins/local/<plugin>/.cursor-plugin/plugin.json instead of mirroring the full cache. Cursor discovers plugin content natively from ~/.claude/plugins/cache/. Stale plugin directories are pruned automatically.
  • NEW: Plugin-Aware Skill Writing: Skills from plugins write to plugins/local/<plugin>/skills/ so Cursor’s plugin system discovers them. Manifests are auto-created per plugin.
  • NEW: PluginOrigin Type: Tracks which plugin an artifact came from (name, publisher, version). Enables plugin-aware writing in target adapters.
  • NEW: Validation Cache: SQLite-backed cache for offline skrills validate with staleness indicators (fresh/recent/aging/stale).
  • NEW: Network Detection: NetworkStatus module detects connectivity with configurable timeout for graceful offline degradation.
  • NEW: GitHub Action: Reusable composite action (.github/actions/validate-skills/) validates skills in PRs with configurable targets, strictness, and annotation output.
  • NEW: Interactive Sync Preview: SyncParams.interactive field enables per-file accept/reject before writing (scaffolded, CLI wiring pending).
  • Refactor: strum Derives: NodeKind and EdgeKind use strum::EnumIter and strum::EnumCount instead of manual all() methods.
  • Fix: cargo fmt: Resolved formatting violations in claude adapter, cursor tests, and knowledge graph timestamp parser.
  • Fix: Marketplace Manifest: Updated .claude-plugin/marketplace.json from stale 0.6.1 to 0.7.7 with correct tool count (36) and Cursor mention.
  • Testing: 8 manifest-sync and stale-plugin pruning tests. Snake_case normalization tests for async research tools. 21 validation cache tests. 5 network detection tests.

0.7.6 (2026-04-12)

  • NEW: Plugin Assets Sync: Cursor sync now mirrors plugin runtime scripts, binaries, and source packages from ~/.claude/plugins/cache/ to ~/.cursor/plugins/cache/. Preserves directory hierarchy so skills can reference companion scripts at the same relative paths.
  • NEW: PluginAsset Type: Sync schema type with publisher, plugin name, version, relative path, content, hash, and executable permission tracking.
  • NEW: Claude Adapter read_plugin_assets(): Walks the plugin cache collecting all files except those handled by other sync paths (skills/, commands/, agents/) and runtime artifacts.
  • NEW: Cursor Adapter write_plugin_assets(): Writes plugin assets with hash-based change detection and executable permission preservation.
  • Testing: 18 new tests covering plugin asset read/write, exclusion rules, version picking, executable detection, and integration flows.

0.7.5 (2026-04-07)

  • Refactor: Research Handlers: Serde-based enum parsing, module-level imports, and hardened error handling for research MCP tools.
  • Fix: Error Reporting: search-papers now returns is_error: true when all sources fail. PDF downloads validate HTTP status. Unpaywall errors are logged.
  • Refactor: Knowledge Graph Timestamps: Node.created_at uses OffsetDateTime with RFC 3339 serde instead of raw strings.
  • Fix: Snake-Case Tool Names: All 36 MCP tools accept both kebab-case and snake_case names via universal normalization in call_tool() dispatch.
  • Fix: Legacy Timestamp Fallback: parse_rfc3339 falls back to SQLite’s datetime('now') format for pre-0.7.5 knowledge graph databases, treating legacy timestamps as UTC.
  • Refactor: Cache Directory Dedup: ResearchCache::open() delegates to Self::cache_dir(), eliminating duplicated path logic.
  • Testing: Enum round-trip tests for NodeKind and EdgeKind, cache directory creation test, legacy and RFC 3339 timestamp parse tests.

0.7.4 (2026-04-02)

  • NEW: Research MCP Tools: 9 tools expose the tome crate over MCP – search-papers, search-discussions, resolve-doi, fetch-pdf, query-knowledge-graph, add-knowledge-node, link-knowledge, track-citations, resolve-contradiction (27 → 36 tools).
  • Fix: Paper Model: Refined Paper model fields and research handler argument parsing.

0.7.3 (2026-03-29)

  • NEW: MCP Tool Filtering: allowed_tools/disabled_tools fields on McpServer synced across all four adapters.
  • NEW: MCP Servers Dashboard: TUI and browser dashboards show MCP server name, source, transport, and tool filters. New /api/mcp-servers REST endpoint.
  • Fix: Configurable Unpaywall Email: UnpaywallClient::new() accepts a custom email, replacing the hardcoded default.
  • Fix: OffsetDateTime for Discussions: Discussion::created_at uses time::OffsetDateTime with RFC 3339 serde instead of a raw string.
  • Fix: SQL Upsert: Knowledge graph and citation tracker INSERT OR REPLACE replaced with ON CONFLICT DO UPDATE to preserve timestamps and metadata.
  • Refactor: Promoted split_frontmatter to shared adapter utilities for cross-adapter reuse.
  • Testing: Parser tests for five tome API clients, Cursor adapter edge cases, sync error paths, serde roundtrip tests, MCP tool-filtering roundtrip tests, dashboard MCP panel tests, and API integration tests.

0.7.2 (2026-03-25)

  • Fix: Cursor Sync Reliability: Hardened bidirectional sync for Cursor adapter across agents, commands, rules, and skills.
  • NEW: Shorthand Sync Commands: /sync-from-cursor, /sync-from-claude, /sync-from-copilot slash commands.
  • NEW: tome Research Crate: Academic paper search, citation extraction, knowledge graph, and PDF retrieval.
  • CLI: --open enforces --http; all sync commands accept Cursor as source/target.
  • Testing: Extended Cursor adapter and CLI test coverage.

0.7.1 (2026-03-21)

  • NEW: multi-cli-agent Command: Agent launching with automatic Claude/Codex backend routing.
  • NEW: --open Flag: Auto-launch browser dashboard on skrills serve.
  • HTTP Transport: Port fallback (up to 10 consecutive ports) when default port is busy.
  • Dashboard: Light-mode support for the browser dashboard.
  • Testing: Edge-case coverage for dashboard navigation, CLI backend resolution, and port binding.

0.7.0 (2026-03-19)

  • NEW: Cursor IDE Support: Full bidirectional sync for .cursor/ (rules, skills, commands, agents, hooks, MCP).
  • NEW: Rules Sync: Maps Cursor .mdc files with mode derivation (alwaysApply, glob-scoped, agent-requested) to/from Claude and Copilot instruction formats.
  • NEW: MCP Tools: sync-from-cursor and sync-to-cursor (25 → 27 tools).
  • NEW: CLI Flags: --from cursor and --to cursor for sync commands.
  • Refactor: Extracted shared adapter utilities and reworked orchestrator for four-way sync routing.
  • Architecture: ADR 0006 documents the Cursor rules mapping strategy.

0.6.1 (2026-03-05)

  • Fix: Tests now use distinct filenames instead of case-only differences to avoid collisions on case-insensitive filesystems (macOS APFS/HFS+).
  • Internal: Bumped all workspace crate versions to 0.6.1 and updated MCP tool count to 25.

0.6.0 (2026-02-15)

  • Discovery: Frontmatter-based skill deduplication across roots using name field and Jaccard similarity on descriptions. Skills with matching frontmatter identity are consolidated regardless of path differences.
  • Dashboard: Sortable skills panel (press s to toggle alphabetical/discovery order), stateful list scrolling, and multi-location display showing all roots where a skill was discovered.
  • Dashboard: Extracted SkillLocation struct to track per-skill discovery sources and paths. Metrics panel shows location count and source details.
  • Fix: Corrected plugin.json command paths from ../commands/ to ./commands/.

0.5.6 (2026-01-28)

  • Testing: Added BDD-style unit tests for skill management modules (deprecation, pre-commit, profiling, rollback, usage-report) covering serialization, parsing, and validation logic.

0.5.5 (2026-01-26)

  • NEW: TLS Certificate Management: Added skrills cert subcommand with status, renew, and install operations. Certificate validity is shown on server startup.
  • Refactor: Copilot Adapter: Split monolithic copilot.rs into focused modules (agents, commands, mcp, paths, preferences, skills, utils, tests) for improved maintainability.
  • Testing: Added unit tests for certificate parsing including missing file handling, valid PEM parsing, and invalid PEM detection.

0.5.4 (2026-01-25)

  • Testing: Added BDD-style tests for configuration loading and directory validation
  • Documentation: Updated README command count to 37 and added skill management section

0.5.3 (2026-01-23)

  • Docs: Streamlined README with navigation links and simplified installation section.
  • NEW: Config File Support: Added --config flag and skrills.toml config file for persistent server settings.
  • NEW: TLS Auto-Generation: Generate self-signed TLS certificates with --tls-generate for development HTTPS.

0.5.2 (2026-01-22)

  • NEW: HTTP Transport for MCP Servers: Added support for HTTP-type MCP servers (like context7) which use type="http" with url and headers fields instead of command/args/env.
  • Dependency Cleanup: Removed unused dependencies (pastey, sha2, flate2) from crates/server, regex from crates/intelligence, anyhow from crates/analyze, thiserror from crates/sync and crates/subagents.
  • Dead Code Removal: Removed unused methods from SkillCache and unused imports from metrics and test modules.
  • Bug Fix: Filter whitespace-only descriptions at extraction point (not just empty strings).
  • Improved: Skill discovery summary log changed from debug to info level for better observability.
  • Testing: Added 5 new tests for multi-word description matching (first/middle/last word, special characters, long descriptions).

0.5.1 (2026-01-21)

  • Refactor: Skill Trace Commands: Split monolithic /skill-trace into three focused commands:
    • /skill-trace-enable - Enable tracing with instrumentation
    • /skill-trace-disable - Disable tracing and cleanup
    • /skill-trace-status - Check current tracing state
  • Refactor: Test Utils Crate: Extracted shared test infrastructure into crates/test-utils/.
  • Code Quality: Sorted command registrations alphabetically in plugin.json.
  • Docs: Cleaned up docs/audit-logging.md.

0.5.0 (2026-01-20)

  • NEW: GitHub Copilot CLI Support: Full bidirectional sync for ~/.copilot (skills, MCP servers, preferences).
  • NEW: Agent Sync: Sync Claude Code subagents to Copilot with format transformation (removes model/color, adds target: github-copilot).
  • NEW: CLI Flags: Added --from copilot and --to copilot for sync commands.
  • NEW: MCP Tools: sync-from-copilot, sync-to-copilot, all 6 source→target skill sync combinations.
  • NEW: Validation Target: --target copilot for skill validation.
  • Testing: 20 Copilot sync integration tests.

0.4.12 (2026-01-16)

  • Testing: Added 59 new tests across tool_schemas (20), sync report (20), and validation common (19) modules.

0.4.11 (2026-01-15)

  • Refactor: Improved test infrastructure with RAII guards (EnvVarGuard, TestFixture).
  • Bug Fix: Logging for silent failure path in skill validation; saturating_mul for timestamp overflow.
  • Docs: Consolidated 14 documentation files from bulleted lists to flowing prose.

0.4.10 (2026-01-15)

  • NEW: Confidence Type: Type-safe Confidence newtype with clamping (0.0-1.0) for recommendations.
  • Improved: Observability: Added tracing for behavioral and comparative recommendation modules.
  • NEW: Auto-Persist: --auto-persist flag and SKRILLS_AUTO_PERSIST env var for automatic analytics caching.

0.4.9 (2026-01-12)

  • NEW: MCP Gateway: Context-optimized tool loading via lazy schema loading.
  • NEW: Analytics Persistence: Export/import analytics via export-analytics and import-analytics.
  • NEW: HTTP Security Options: Added --auth-token, --tls-cert, --tls-key, --cors-origins flags.

0.4.8 (2026-01-10)

  • NEW: Skill Description Caching: Optional description field in SkillMeta for richer fuzzy search.
  • Improved: Fuzzy Search: Matches against descriptions in addition to names.

0.4.7 (2026-01-09)

  • Version bump to republish after v0.4.6 tag protection issue.

0.4.6 (2026-01-08)

  • Bug Fixes: Address 14 issues including warnings for skipped deps, YAML line/column info, SAFETY comments.
  • Testing: Add 282 new tests across multiple modules.
  • Documentation: Add audit-logging.md covering security events and SIEM integration.

0.4.5 (2026-01-03)

  • Testing: Added tests for tool handler functions.

0.4.4 (2026-01-02)

  • NEW: Empirical Skill Creation: Generate skills from session patterns via --method empirical. Mines Claude Code/Codex CLI history for successful tool sequences and failure anti-patterns.
  • NEW: Comparative Recommendations: Deviation scoring compares actual vs expected outcomes per skill category (Testing, Debugging, Documentation, etc.).
  • NEW: Behavioral Analytics: Extract tool calls, file access patterns, and session outcomes from history.
  • Improved: Install Script: User-scoped MCP registration (--scope user) with better error capture.

0.4.3 (2025-12-31)

  • NEW: HTTP Transport: --http flag for HTTP transport instead of stdio.
  • Runtime Configuration: HTTP flag is runtime-checked, not compile-time gated.
  • Default: HTTP transport enabled by default in release builds.

0.4.2 (2025-12-29)

  • NEW: Fuzzy Skill Search: Added search-skills-fuzzy MCP tool with trigram-based similarity matching for typo-tolerant skill discovery.
  • Example: Query “databas” will find skills named “database” with high similarity scores.
  • Parameters: query (search term), threshold (similarity cutoff, default 0.3), limit (max results).

0.4.1 (2025-12-27)

  • Hashing: Switched file hash algorithm to blake2b-256 for improved performance and security.
  • CI/CD: Improved error handling in publish verification workflow.
  • Documentation: Added README for the intelligence crate.

0.4.0 (2025-12-24)

  • NEW: Intelligent Skills: Added skrills-intelligence crate with project context analysis, skill recommendations, and skill creation.
  • NEW: Project Context Detection: Automatically detect languages, frameworks, and project type from README and git history.
  • NEW: Smart Recommendations: Context-aware skill recommendations based on project profile and usage analytics.
  • NEW: Skill Creation: Create new skills via GitHub search or LLM generation with project context.
  • NEW: Usage Analytics: Parse Claude Code and Codex CLI history for skill usage patterns.
  • Security: Path traversal guard, GitHub query injection sanitization, CLI binary name validation.

0.3.5 (2025-12-21)

  • NEW: Agent Discovery: Added list-agents MCP tool for discovering available agents with metadata caching.
  • NEW: Run Events Polling: Added get-run-events MCP tool for polling-based event retrieval.
  • NEW: Codex CLI Adapter: Subprocess execution of Codex CLI agents via CodexCliAdapter.
  • NEW: Smart Routing: Automatic backend selection based on agent_id parameter.
  • NEW: Model Mapping: Cross-platform model preference sync for consistent agent configuration.
  • Error Handling: Structured CliError enum with better error messages; logging for silent failures.
  • Testing: Integration tests for subagent workflow.

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.

0.3.3 (2025-12-18)

  • 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.

0.3.2 (2025-12-17)

  • 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.

0.3.1 (2025-12-13)

  • 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.
  • 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.

0.3.0 (2025-12-12)

  • NEW: Subagents Module: 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 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.

0.2.2 (2025-12-04)

  • 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.

0.2.1 (2025-11-26)

  • 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.

0.2.0 (2025-11-26)

  • 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.

0.1.x Releases

See full changelog for details on earlier releases including:

  • 0.1.14: Doctor diagnostics, --trace-wire logging
  • 0.1.13: Installer archive filtering improvements
  • 0.1.12-0.1.0: Initial releases with installer, mdBook, and CI/CD setup