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.