skillshare-codebase-audit
Cross-validate CLI flags, docs, tests, and targets for consistency across the codebase. Use this skill whenever the user asks to: audit the codebase, check for consistency issues, find undocumented flags, verify test coverage, validate targets.yaml, check handler split conventions, or verify oplog instrumentation. This is a read-only audit — it reports issues but never modifies files. Use after large refactors, before releases, or whenever you suspect docs/code/tests have drifted out of sync.
npx skills add runkids/skillshare --skill skillshare-codebase-audit --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
Read-only consistency audit across the skillshare codebase. $ARGUMENTS specifies focus area (e.g., "flags", "tests", "targets") or omit for full audit. **Scope**: This skill only READS and REPORTS. It does not modify any files. Use `implement-feature` to fix issues or `update-docs` to fix documentation gaps. ## Audit Dimensions Run all 4 dimensions in parallel where possible. For each, produce a summary table. ### 1. CLI Flag Audit Compare every flag defined in `cmd/skillshare/*.go` against `website/docs/commands/*.md`. ```bash # Find all flags in Go source grep -rn 'flag\.\(String\|Bool\|Int\)' cmd/skillshare/ grep -rn 'Args\|Usage' cmd/skillshare/ ``` Report: - **UNDOCUMENTED**: Flag exists in code but not in docs - **STALE**: Flag documented but not found in code - **OK**: Flag matches between code and docs ### 2. Spec vs Code For each spec in `specs/` marked as completed/done: - Verify the described feature exists in source code - Check that the spec's acceptance criteria are testable Report: - **IMPLEMENTED**: Spec complete, code exists - **MISMATCH**: Spec says done but code missing or partial - **PENDING**: Spec not yet marked complete (informational) ### 3. Test Coverage Fo
- Audit Dimensions
- 1. CLI Flag Audit
- 2. Spec vs Code
- 3. Test Coverage
- 4. Target Audit
- Output Format
- 5. Handler Split Audit
- 6. Oplog Coverage
- 7. Web API Consistency
- Rules
Find all flags in Go source grep -rn 'flag\.\(String\|Bool\|Int\)' cmd/skillshare/ grep -rn 'Args\|Usage' cmd/skillshare/ List all command handlers ls cmd/skillshare/*.go | grep -v '_test.go\|main.go\|helpers.go\|mode.go' List all integration tests ls tests/integration/*_test.go Find large command files wc -l cmd/skillshare/*.go | sort -rn | head -20 Find commands that modify state
What does the skillshare-codebase-audit skill do?
Cross-validate CLI flags, docs, tests, and targets for consistency across the codebase. Use this skill whenever the user asks to: audit the codebase, check for consistency issues, find undocumented flags, verify test coverage, validate targets.yaml, check handler split conventions, or verify oplog instrumentation. This is a read-only audit — it reports issues but never modifies files. Use after large refactors, before releases, or whenever you suspect docs/code/tests have drifted out of sync.
How do I install it?
Run `npx skills add runkids/skillshare --skill skillshare-codebase-audit --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From runkids/skillshare, a repository with 2,519 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.