This skill should be used when the user asks to "scan for TODOs", "find placeholders", "clean up stubs", "remove temporary code", "audit for incomplete code", or "erase substitutions from codebase". Scans existing files for placeholder tokens and generates remediation plan.
/plugin marketplace add plurigrid/asi/plugin install asi-skills@asi-skillsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
references/remediation.mdscripts/scan.pyScan existing codebases for placeholder tokens. Generate remediation plan.
Audit existing files for substitution tokens (TODO, FIXME, placeholder, mock, etc.) and produce actionable remediation plan. Distinct from accept-no-substitutes which validates agent output.
This skill scans what already exists:
Complements accept-no-substitutes (output validation).
# Scan current directory
just substitute-scan .
# Scan specific path
just substitute-scan src/
| Severity | Tokens | Action |
|---|---|---|
| CRITICAL | TODO, FIXME, placeholder, xxx | Must fix before merge |
| WARNING | mock-, fake-, stub-* (outside tests) | Review context |
| INFO | example_, demo_ | Document or remove |
Output format:
SUBSTITUTE ERASER REPORT
========================
Scanned: 142 files
Found: 23 substitutions
CRITICAL (7):
src/auth.py:42 TODO: implement token refresh
src/api.py:118 placeholder value
src/db.py:55 FIXME: race condition
...
WARNING (12):
src/service.py:30 mock_client (not in test file)
...
INFO (4):
README.md:15 example_config
...
REMEDIATION PLAN:
1. [CRITICAL] src/auth.py:42 - Implement token refresh logic
2. [CRITICAL] src/api.py:118 - Replace placeholder with actual value
...
| Pattern | Acceptable In |
|---|---|
mock-*, fake-*, stub-* | *_test.py, test_*.py, /tests/ |
example_* | README.md, /docs/, /examples/ |
demo_* | /demo/, documentation |
TODO | Issue tracker references with ID |
Mark intentional placeholders:
# SUBSTITUTE-OK: mock used for test isolation
mock_client = MockHTTPClient()
# Full scan with report
just substitute-scan <path>
# Critical only (CI mode)
just substitute-critical <path>
# Generate remediation tasks
just substitute-tasks <path> --output=github # GitHub issues
just substitute-tasks <path> --output=linear # Linear tickets
just substitute-tasks <path> --output=todo # TODO file
# Interactive fix mode
just substitute-fix <path>
Operates as MINUS (-1) in audit triads:
substitute-eraser(-1) + code-generator(+1) + review-coordinator(0) = 0
Emits rejection signal when scan finds violations above threshold.
references/patterns.md - Detection regex patterns (shared with accept-no-substitutes)references/remediation.md - Fix strategies per token typescripts/scan.py - Main scanning scriptscripts/report.py - Report generation