Torafirma Skill Router
A deterministic, content-addressed skill algebra for agentic systems. No vector databases. No model drift. Just SHA-256, SQLite, and a closed-form ranking function derived from bounded utility.
Automatic routing — no user interaction required: once connected through MCP or the included interface skill, the agent searches a bounded local metadata catalogue, selects an explainable ranked candidate, exact-fetches the selected SHA-256 revision, and continues the user's original task.
Skill Router keeps one small interface skill in context and leaves the full library on disk. Version 1.1.0 formalizes the ranking function, emits replayable decision records, pins skill bodies by revision and catalogue generation, separates read-only consumers from privileged publishers, and exposes a stable C ABI.
Why this is different
Three problems are resolved by one explicit contract:
- Version integrity: skill bodies are identified by SHA-256 revisions and re-hashed immediately before fetch.
- Semantic routing without opaque inference: exact lexical tiers, FTS5/BM25, bounded edit distance, telemetry, and lifecycle state are combined in one published equation.
- Catalog consensus: one SHA-256 generation commits to the canonical publication-relevant catalog.
There is no embedding model, vector database, learned classifier, random tie-break, capability-graph distance, or hidden manual priority.
Technical contracts:
- Ranking and Load-Time Identity Contract
- Stable C ABI
What changed in 1.1.0
- Public ranking policy: tf.skillrouter.hybrid-lexical.v1.
- Full score decomposition in search output and append-only decision receipts.
- SHA-256 revisionid for exact skill-body identity.
- Deterministic cataloggeneration for the ranked catalogue snapshot.
- Fail-closed search-to-fetch verification.
- Pin-on-fetch semantics; no implicit hot reload during an active task.
- Read-only consumer catalogue connections.
- Separate writable telemetry database.
- Operator-only registration, indexing, deprecation, and archival.
- Revision-pinned MCP tools and resources.
- Stable C ABI with explicit status and buffer ownership.
- pybind11, N-API, and Rust bindgen binding scaffolds.
- C++ contract tests and C ABI drift/fetch smoke tests.
- Linux and Windows CI.
- Signed release-manifest workflow.
The packaged 1.0.0 Windows artifact remains available while the 1.1.0 release workflow produces the new executable and C ABI library.
One executable, four interfaces
| Interface | Intended use | Catalogue access | |---|---|---| | MCP stdio | Automatic agent routing | Consumer/read-only by default | | CLI | Automation, diagnostics, search and exact fetch | Consumer by default; explicit operator commands | | Loopback HTTP | Trusted local integrations | Consumer/read-only by default | | Interactive shell | Human administration | Operator/read-write |
Running skillrouter with no arguments opens the operator shell. Running skillrouter --help prints scripting usage.