void-audit

Audits local mission events to propose repairs or retirement for underused harness components.

Updated May 29, 2026
One-click install
npx skills add https://github.com/voidcorp-core/void-harness --skill void-audit-voidcorp-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: void-audit
Source: https://github.com/voidcorp-core/void-harness/tree/main/packages/core/skills/void-audit
Command: npx skills add https://github.com/voidcorp-core/void-harness --skill void-audit-voidcorp-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Over time an installed harness accumulates skills, agents, and hooks, and some stop earning their place. This Skill runs the outbound audit over local mission events to surface skills that never fire, upstream deprecations, and matrix conflicts, presenting every finding as a proposal a human disposes of rather than an automatic change. ## Core Features & Use Cases - Usage-based audit: Reads local mission events from .void/machine/runs/<mission-id>/events.jsonl plus read-only legacy usage logs, joining skills, agents, hooks, graph relations, activations, outcomes, and static cost. - Five proposal types: Suggests repairing telemetry, repairing failures, wiring an orphan, tuning or fusing low-yield overlap, or reviewing retirement, each with the cost of being wrong. - Human-in-the-loop by design: Nothing is applied automatically; every output is a proposal a human turns into a pull request or declines, and insufficient data is reported as an honest finding. - Use Case: Before a release, run the audit alongside a retrospective to identify skills that have not fired in the observed window and decide which to rewire, tune, or retire. ## Quick Start Ask the assistant to run the void-harness audit and summarize which installed skills never fired, with proposals for each.

Frequently Asked Questions about void-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit which installed skills are actually being used?

Run `void-harness audit` (or `npx voidharness audit` if the CLI is not on PATH). It reads local mission events from .void/machine/runs and reports which skills, agents, and hooks fired during the observed window.

How do I find skills that never fire in Claude Code or Codex?

The audit joins activation telemetry with the component graph to surface skills absent from human-session events. It proposes wiring fixes, trigger tuning, fusion, or retirement review rather than deleting anything itself.

Does the audit send my usage data anywhere?

No. Everything is read from local files, including events.jsonl written by the activation meter and read-only legacy usage logs. Nothing is transmitted externally.

Will the audit automatically remove unused skills?

No. Every output is a proposal only; a human decides whether to file a pull request or decline. Retirement proposals additionally require at least twenty human sessions of evidence before being suggested.

What does it mean when the audit reports insufficient data?

Insufficient events is a finding, not a failure. It means the harness has not been used enough in that project for the question to have an answer, and the report states the window and event count.