All notable changes to Skill Router are documented here. The format is based on Keep a Changelog, and this project uses semantic versioning.
.github/workflows/tests.yml— CI test matrix (Python 3.10–3.13).github/workflows/lint.yml— CI validation and syntax checks.github/workflows/benchmark.yml— Benchmark CI on main branch pushes.github/CODEOWNERS— Code ownership definitions.github/ISSUE_TEMPLATE/bug_report.md— Bug report template.github/ISSUE_TEMPLATE/feature_request.md— Feature request template.github/PULL_REQUEST_TEMPLATE.md— PR checklistSECURITY.md— Security policy and vulnerability reporting processCODE_OF_CONDUCT.md— Contributor Covenant Code of Conductdocs/— Documentation structure (architecture, routing, configuration, agents, benchmarking, troubleshooting, development)benchmark-baseline.json— Saved baseline for regression detection--save-baseline,--baseline,--gateflags to benchmark runner--scalingmode with preset corpus sizes (16/100/500/1000/5000)ambiguity_recall,latency_p95_ms,metadata_reduction_pctmetricspyproject.toml— Standard Python packagingsrc/skill_router/__init__.py— Packaging shim for pip installmodels.py— Extracted model layer (Skill, load_manifest)
- Branding unified to "Skill Router" throughout public-facing files
manifest.jsonaliases cleaned up (removed "Skill_by_Satya" alias)CONTRACT_MARKERupdated to<!-- Skill Router:routing-contract -->CONTRIBUTING.mdexpanded with routing behavior change guidelines.gitignoreexpanded with.coverage,htmlcov/,.tox/,benchmark-results/,*.egg-info/,dist/,build/,wheels/- Windows path test failure fixed in
test_install.py - Benchmark accuracy language scoped to reflect gold-set limitations
- Troubleshooting table entry for benchmark accuracy clarified
skill.pybuilt-in benchmark includes per-case latency and p95 reporting- Scaling results documented with honest interpretation
- Test failure on Windows due to path separator in
test_install.py
2.0.0 — 2025-01-15
- Two-stage deterministic routing (cheap filtering + structured ranking)
- Three-way decisions:
route,ambiguous,no_route - Multi-skill plans with disjoint-dimension detection
- Positive and negative routing boundaries (
use_when,not_when) - Explicit call bonus with anchor requirement (adversarial protection)
- Three-pass penalty system (not_when, object mismatch, conflicts)
- Result caching with fingerprint-based invalidation
- Drift detection between corpus and routing manifest
- Conservative bootstrap for existing or empty repositories
- Validation with exit codes
- Gold-set benchmark (36 cases, 16-skill corpus)
- Global/project installer with agent-specific layouts
--version,--debug,--no-cacheCLI flags- Host-AI sanity check in maintenance contract