completeness-check

Detect incomplete work in repositories and generate a completeness score.

8|1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/bordenet/superpowers-plus --skill completeness-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: completeness-check
Source: https://github.com/bordenet/superpowers-plus/tree/main/skills/observability/completeness-check
Command: npx skills add https://github.com/bordenet/superpowers-plus --skill completeness-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects incomplete work left in repositories due to AI assistant crashes, context exhaustion, mid-implementation distractions, or accidental omissions so teams don't mark tasks as finished prematurely.

Core Features & Use Cases

  • Broad detection categories: Finds broken internal links, retired file references, hallucinated dependencies, security-critical TODOs, generic TODO/FIXME comments, debug prints, commented-out code, missing tests, placeholder content, stale docs, and orphaned files.
  • Phased analysis: Offers fast grep-based scans for quick checks, tool-based analysis (linters, coverage, registry checks) for higher confidence, and deep AST/semantic analysis for expensive investigations.
  • Reporting & CI integration: Produces a completeness score, summary or detailed findings, and machine-readable output suitable for pre-commit gates and audit automation.

Quick Start

Run a completeness-check on the repository to surface TODOs, missing tests, hallucinated dependencies, broken links, and receive a completeness score with a verification report.

Frequently Asked Questions about completeness-check

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

FAQPage Schema
How do I detect incomplete work and TODOs left in my repository before release?

To detect incomplete work before release, scan repositories for broken links, retired references, hallucinated dependencies, debug statements, and TODOs. This process produces a completeness score and verification report to prevent prematurely marking tasks as finished.

What is a completeness check and when do I need to run it in CI?

A completeness check identifies accumulated technical debt from mid-implementation distractions or AI assistant crashes. Run it during pre-commit gates and CI checks to catch missing tests, placeholder content, and orphaned files before merging code.

Can I use a completeness audit to find hallucinated dependencies and broken links?

Yes, a completeness audit finds hallucinated dependencies, broken internal links, and retired file references. It applies broad detection categories using grep-based scans, linters, and deep AST analysis to verify repository integrity.

What's the best way to automate code quality coverage checks for accumulated technical debt?

Automate code quality coverage checks by running tool-based analysis alongside fast grep scans. This surfaces security-critical TODOs, stale docs, and commented-out code, generating machine-readable output suitable for audit automation.

Does completeness checking work with existing linters and coverage tools?

Completeness checking integrates with existing workflows by offering tool-based analysis using linters, coverage reports, and registry checks. This provides higher confidence verification alongside standard CI automation processes.

Why does running a pre-commit check fail to catch orphaned files and commented-out code?

Standard pre-commit checks often miss orphaned files and commented-out code because they lack deep AST analysis. A dedicated completeness scan applies semantic investigations to catch these specific mid-implementation distractions.