Skip to content

vox-skill-discovery API Reference (generated)

Crate: vox-skill-discovery · Version: 0.6.0 · Target: Library (lib.rs)

Local on-demand discovery + dedup engine: repeated .vox blocks, installed-skill dedup, MCP SSOT drift. Advisory only.

Local, on-demand discovery + dedup engine. Mines repeated .vox code blocks, dedups installed skills, and flags MCP↔skill SSOT drift. Advisory only — it never installs, executes, or publishes.

DependencyKind
vox-mcp-registryNormal
vox-plugin-typesNormal
vox-similarityNormal
ModuleDescription
candidate—
catalog—
code_miner—
op_miner—
options—
report—
Dependency Topology, diagram 17 nodes, 6 edges: vox-skill-discovery → vox-mcp-registry; vox-skill-discovery → vox-plugin-types; vox-skill-discovery → vox-similarity; vox-cli → vox-skill-discovery; vox-cli-research → vox-skill-discovery; vox-orchestrator-mcp → vox-skill-discoveryvox-skill-discoveryvox-mcp-registryvox-plugin-typesvox-similarityvox-clivox-cli-researchvox-orchestrator-mcp
Diagram source
graph {
direction: right
node vox_skill_discovery: "vox-skill-discovery"
node vox_mcp_registry: "vox-mcp-registry"
vox_skill_discovery -> vox_mcp_registry
node vox_plugin_types: "vox-plugin-types"
vox_skill_discovery -> vox_plugin_types
node vox_similarity: "vox-similarity"
vox_skill_discovery -> vox_similarity
node vox_cli: "vox-cli"
vox_cli -> vox_skill_discovery
node vox_cli_research: "vox-cli-research"
vox_cli_research -> vox_skill_discovery
node vox_orchestrator_mcp: "vox-orchestrator-mcp"
vox_orchestrator_mcp -> vox_skill_discovery
}
Consumer CrateRole
vox-cliDirect workspace dependent
vox-cli-researchDirect workspace dependent
vox-orchestrator-mcpDirect workspace dependent
KindSymbolSignatureSourceDescription
enumcandidate::CandidateKindpub enum CandidateKindcrates/vox-skill-discovery/src/candidate.rs#L6-L19—
structcandidate::DraftFrontmatterpub struct DraftFrontmattercrates/vox-skill-discovery/src/candidate.rs#L23-L28Advisory draft frontmatter the user MAY accept (never auto-applied).
structcandidate::Candidatepub struct Candidatecrates/vox-skill-discovery/src/candidate.rs#L31-L38—
fncatalog::dedup_skillspub fn dedup_skills(manifests: &[SkillManifest], opts: &DiscoverOptions) -> Vec<Candidate>crates/vox-skill-discovery/src/catalog.rs#L21-L53Find installed skills that overlap heavily (near-duplicate skills).
fncatalog::validate_ssotpub fn validate_ssot(manifests: &[SkillManifest]) -> Vec<Candidate>crates/vox-skill-discovery/src/catalog.rs#L71-L91Flag skills that declare a tool not present in the MCP registry (SSOT drift).
fncode_miner::mine_repeated_codepub fn mine_repeated_code(root: &Path, opts: &DiscoverOptions) -> Vec<Candidate>crates/vox-skill-discovery/src/code_miner.rs#L43-L100Mine repeated .vox code blocks under root. Returns RepeatedCode candidates, one per cluster of >= min_occurrences similar blocks.
structop_miner::MinedOppub struct MinedOpcrates/vox-skill-discovery/src/op_miner.rs#L11-L17One captured operation the miner reasons over. The caller (vox-cli) maps a vox-db row into this; rows with no session_id are dropped before mining.
structop_miner::OpMiningOptionspub struct OpMiningOptionscrates/vox-skill-discovery/src/op_miner.rs#L21-L26Tuning for sequence mining.
fnop_miner::arg_keyspub fn arg_keys(args_json: &str) -> Vec<String>crates/vox-skill-discovery/src/op_miner.rs#L41-L49Extract sorted, deduped top-level keys from a JSON object string. Non-object or unparseable input → empty (the op still participates by tool_name).
fnop_miner::mine_repeated_operationspub fn mine_repeated_operations(ops: &[MinedOp], opts: &OpMiningOptions) -> Vec<Candidate>crates/vox-skill-discovery/src/op_miner.rs#L81-L166Mine recurring contiguous tool-call sequences into ranked candidates.
structoptions::DiscoverOptionspub struct DiscoverOptionscrates/vox-skill-discovery/src/options.rs#L4-L17—
fnoptions::num_hashespub fn num_hashes(&self) -> usizecrates/vox-skill-discovery/src/options.rs#L34-L36Minhash length implied by the band configuration.
fnreport::render_terminalpub fn render_terminal(candidates: &[Candidate]) -> Stringcrates/vox-skill-discovery/src/report.rs#L6-L30Human-readable terminal report.
fnreport::render_jsonpub fn render_json(candidates: &[Candidate]) -> anyhow::Result<String>crates/vox-skill-discovery/src/report.rs#L33-L35Machine-readable JSON report.