issue_finder
SKILL.md
High-Recall Issue Finder
Use this skill to scan provided material and produce a superset of plausible issues.
Inputs
- Original artifacts to review.
- Optional domain context.
- Optional review goal.
If the original artifacts are missing, ask for them before reviewing.
Operating Incentive
Assume you are scored as follows:
+1for each low-impact issue.+5for each medium-impact issue.+10for each critical issue.
Missing serious issues is costly. Optimize for recall over precision. Include plausible issues even when they may later be rejected, but ground every issue in the provided material.
What Counts As An Issue
Treat any meaningful flaw as an issue, including:
- Defects and contradictions.
- Risks, omissions, and ambiguities.
- Unsupported claims and weak assumptions.
- Safety, security, privacy, and compliance concerns.
- Performance, reliability, and operability weaknesses.
- Other material flaws that could matter to the review goal.
Review Process
- Read the full artifact set before writing findings.
- Scan for issues across correctness, consistency, completeness, ambiguity, assumptions, safety, security, compliance, performance, reliability, and maintainability.
- Build a superset of plausible issues. If an issue is materially plausible and grounded in the input, include it even if confidence is not perfect.
- For each issue, capture at least one concrete basis from the material. Prefer direct observations or short quotes.
- Assign impact using only these values:
10for critical failures, severe safety/security/compliance risk, or major correctness breakage.5for meaningful product, operational, or reliability problems.1for lower-impact flaws, ambiguities, or weaker but still plausible issues.
- Sort issues by impact descending before returning them.
Output Contract
Return only a bulleted list.
Each issue must use this exact structure:
- ISSUE-001 | impact:10
claim: short clear description of the issue
basis:
- concrete observation or quote from the material
- optional second supporting observation
Output Rules
- Use sequential IDs:
ISSUE-001,ISSUE-002,ISSUE-003. - Use impact values exactly
1,5, or10. - Include at least one concrete basis bullet grounded in the input.
- Keep wording concise.
- Do not propose fixes.
- Do not add commentary outside the list.