mullzhang/test-only-dead-code-detector
skills/test-only-dead-code-detector/SKILL.md
Detect Python dead-code candidates that are referenced only from tests by running Vulture twice and diffing results (production paths vs production+test paths). Use when auditing cleanup targets, reviewing unused-code reports, or validating whether symbols are reachable only through tests.
development
Updated May 24, 2026
$ install --global
skillsauthnpx skillsauth add mullzhang/skills test-only-dead-code-detectorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 24, 2026, 5:51 AM117.0s3 files scanned
SKILL.md
- name:
- test-only-dead-code-detector
- description:
- Detect Python dead-code candidates that are referenced only from tests by running Vulture twice and diffing results (production paths vs production+test paths). Use when auditing cleanup targets, reviewing unused-code reports, or validating whether symbols are reachable only through tests.
Test Only Dead Code Detector
Run vulture in two passes and compare findings to isolate test-only references.
Workflow
- Select production paths and test paths.
- From the target repository root, run the detector script via
$CODEX_HOME/skills/...(fallback:~/.codex/skills/...). - Prioritize
TEST-ONLY CANDIDATESas "used only by tests" cleanup targets. - Treat
UNUSED EVEN WITH TESTSas stronger dead-code candidates. - Apply allowlists for dynamic patterns when needed.
Quick Start
DETECTOR_SCRIPT="${CODEX_HOME:-$HOME/.codex}/skills/test-only-dead-code-detector/scripts/find_test_only_dead_code.py"
python "$DETECTOR_SCRIPT" \
--vulture-bin ./.venv/bin/vulture \
--prod-path src \
--prod-path experiments \
--test-path tests \
--config pyproject.toml \
--min-confidence 60 \
--exclude "*/conftest.py,*/__init__.py"
Interpretation
TEST-ONLY CANDIDATES- Reported in production-only scan, but disappears when tests are included.
- Candidate code used only by tests.
UNUSED EVEN WITH TESTS- Reported even when tests are included.
- Candidate code unused across production and tests.
ONLY IN WITH-TESTS SCAN- Appears only when test files are included.
- Usually dead code inside test files.
Script Options
--prod-path: Add a production path (repeatable). Default:src.--test-path: Add a test path (repeatable). Default:tests.--config: Passpyproject.tomlor another vulture config.--exclude,--ignore-names,--ignore-decorators,--min-confidence,--sort-by-size: Forwarded to both runs.--json-output: Write machine-readable report.--fail-on-test-only: Exit1if test-only candidates are found.--fail-on-unused-with-tests: Exit1if findings remain unused with tests included.
CI Example
DETECTOR_SCRIPT="${CODEX_HOME:-$HOME/.codex}/skills/test-only-dead-code-detector/scripts/find_test_only_dead_code.py"
python "$DETECTOR_SCRIPT" \
--vulture-bin ./.venv/bin/vulture \
--prod-path src \
--test-path tests \
--config pyproject.toml \
--fail-on-test-only
Related Skills
mullzhang/md-questionnaire
development
VerifiedTrustedCommunity
Create a finite Markdown questionnaire file that contains grouped questions, recommended options, answer fields, and optional rationale fields, then read the completed file and continue from the user's answers. Use when Codex needs to ask multiple questions for requirements, specifications, acceptance criteria, product decisions, design choices, implementation tradeoffs, or any situation where conversational back-and-forth would fatigue the user or make the remaining question count unclear.
SKILL.mdUpdated May 31, 2026
mullzhang/sdv-synthetic-data
testing
VerifiedTrustedCommunity
Generate synthetic data with SDV (Synthetic Data Vault). Learn patterns from real data with machine learning and produce privacy-preserving synthetic data. Use cases: (1) single-table synthetic data generation, (2) multi-table (relational DB) synthetic data generation, (3) time-series synthetic data generation, (4) synthetic data quality evaluation, and (5) metadata and constraint setup
SKILL.mdUpdated May 24, 2026
mullzhang/pulp-log-diagnostics
development
VerifiedTrustedCommunity
Parse PuLP and solver logs (CBC, HiGHS, Gurobi, CPLEX) to diagnose infeasible/unbounded/time-limit/execution failures, extract key metrics, and propose prioritized next debugging actions. Use when given optimization run logs, solver stdout/stderr, or LP/MPS export errors and you need root-cause clues that generalize across optimization problems. When LP/MPS/log artifacts exist, include all of them in the analysis.
SKILL.mdUpdated May 24, 2026
mullzhang/lean-code
development
VerifiedTrustedCommunity
For early development phases. Prevent excessive fallbacks, backward compatibility code, and duplication during code generation. Use when generating, modifying, or refactoring code.
SKILL.mdUpdated May 24, 2026