Fp Check
Trail of BitsOfficialPublished by Trail of Bits
- Skill
- Review and audit
- Security
- CC-BY-SA-4.0
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
fp-check provides a structured methodology for validating suspected security bugs. It guides the user through a rigorous verification process to determine if a finding is a true positive or a false positive, supported by documented evidence. The skill distinguishes between standard and deep verification paths based on the complexity of the bug, ensuring that each claim is thoroughly analyzed against its specific context, data flow, and threat model.
What it does
- Restates and clarifies vulnerability claims to identify potential misunderstandings.
- Routes verification tasks between standard and deep paths based on bug complexity.
- Performs data flow analysis to trace inputs from source to sink.
- Applies class-specific verification requirements for various bug types.
- Produces a final verdict of TRUE POSITIVE or FALSE POSITIVE with supporting evidence.
- Evaluates findings against mandatory gate reviews.
When to use it
- When you need to verify if a specific security finding is real or exploitable.
- When you need to confirm if a reported bug is a false positive.
- When you have a clear, specific vulnerability claim that requires validation.
- When standard verification steps are insufficient for complex or cross-component bugs.
Advantages
- Eliminates guesswork by requiring evidence-based verification.
- Prevents common analytical errors through a structured devil's advocate review.
- Provides a clear, repeatable process for triaging multiple suspected bugs.
- Ensures context-aware analysis by considering architectural and historical factors.
Usage examples
- “Verify if the reported heap buffer overflow in parse_header is a true positive.”
- The agent will restate the claim, perform data flow analysis, check the specific memory corruption conditions, and provide a verdict with evidence.
- “Is this SQL injection finding a false positive?”
- The agent will trace the data flow from the input source to the database sink and verify if the input is properly sanitized or parameterized.
Install
Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/trailofbits/fp-check/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip fp-check.zip -d .agents/skills
Documentation by Trail of Bits
False Positive Check
When to Use
"Is this bug real?" or "is this a true positive?"
"Is this a false positive?" or "verify this finding"
"Check if this vulnerability is exploitable"
Any request to verify or validate a specific suspected bug
When NOT to Use
Finding or hunting for bugs ("find bugs", "security analysis", "audit code")
General code review for style, performance, or maintainability
Feature development, refactoring, or non-security tasks
When the user explicitly asks for a quick scan without verification
Rationalizations to Reject
If you catch yourself thinking any of these, STOP.
| Rationalization | Why It's Wrong | Required Action |
|---|---|---|
| "Rapid analysis of remaining bugs" | Every bug gets full verification | Return to task list, verify next bug through all phases |
| "This pattern looks dangerous, so it's a vulnerability" | Pattern recognition is not analysis | Complete data flow tracing before any conclusion |
| "Skipping full verification for efficiency" | No partial analysis allowed | Execute all steps per the chosen verification path |
| "The code looks unsafe, reporting without tracing data flow" | Unsafe-looking code may have upstream validation | Trace the complete path from source to sink |
| "Similar code was vulnerable elsewhere" | Each context has different validation, callers, and protections | Verify this specific instance independently |
| "This is clearly critical" | LLMs are biased toward seeing bugs and overrating severity | Complete devil's advocate review; prove it with evidence |
Step 0: Understand the Claim and Context
Before any analysis, restate the bug in your own words. If you cannot do this clearly, ask the user for clarification. Half of false positives collapse at this step — the claim doesn't make coherent sense when restated precisely.
Document:
What is the exact vulnerability claim? (e.g., "heap buffer overflow in
parse_header()whencontent_lengthexceeds 4096")What is the alleged root cause? (e.g., "missing bounds check before
memcpyat line 142")What is the supposed trigger? (e.g., "attacker sends HTTP request with oversized Content-Length header")
What is the claimed impact? (e.g., "remote code execution via controlled heap corruption")
What is the threat model? What privilege level does this code run at? Is it sandboxed? What can the attacker already do before triggering this bug? (e.g., "unauthenticated remote attacker vs privileged local user"; "runs inside Chrome renderer sandbox" vs "runs as root with no sandbox")
What is the bug class? Classify the bug and consult bug-class-verification.md for class-specific verification requirements that supplement the generic phases below.
Execution context: When and how is this code path reached during normal execution?
Caller analysis: What functions call this code and what input constraints do they impose?
Architectural context: Is this part of a larger security system with multiple protection layers?
Historical context: Any recent changes, known issues, or previous security reviews of this code area?
Route: Standard vs Deep Verification
After Step 0, choose a verification path.
Standard Verification
Use when ALL of these hold:
Clear, specific vulnerability claim (not vague or ambiguous)
Single component — no cross-component interaction in the bug path
Well-understood bug class (buffer overflow, SQL injection, XSS, integer overflow, etc.)
No concurrency or async involved in the trigger
Straightforward data flow from source to sink
Follow standard-verification.md. No task tracking — work through the linear checklist sequentially, documenting findings inline.
Deep Verification
Use when ANY of these hold:
Ambiguous claim that could be interpreted multiple ways
Cross-component bug path (data flows through 3+ modules or services)
Race conditions, TOCTOU, or concurrency in the trigger mechanism
Logic bugs without a clear spec to verify against
Standard verification was inconclusive or escalated
User explicitly requests full verification
Follow deep-verification.md. Track each phase as a task with explicit dependencies, and execute the phases using the plugin's analysis agents.
Default
Start with standard. Standard verification has two built-in escalation checkpoints that route to deep when complexity exceeds the linear checklist.
Batch Triage
When verifying multiple bugs at once:
Run Step 0 for all bugs first — restating each claim often collapses obvious false positives immediately
Route each bug independently (some may be standard, others deep)
Process all standard-routed bugs first, then deep-routed bugs
After all bugs are verified, check for exploit chains — findings that individually failed gate review may combine to form a viable attack
Final Summary
After processing ALL suspected bugs, provide:
Counts: X TRUE POSITIVES, Y FALSE POSITIVES
TRUE POSITIVE list: Each with brief vulnerability description
FALSE POSITIVE list: Each with brief reason for rejection
References
Standard Verification — Linear single-pass checklist for straightforward bugs
Deep Verification — Full task-based orchestration for complex bugs
Gate Reviews — Six mandatory gates and verdict format
Bug-Class Verification — Class-specific verification requirements for memory corruption, logic bugs, race conditions, integer issues, crypto, injection, info disclosure, DoS, and deserialization
False Positive Patterns — 13-item checklist and red flags for common false positive patterns
Evidence Templates — Documentation templates for data flow, mathematical proofs, attacker control, and devil's advocate reviews
Files
- ATTRIBUTION.mdAdded by AutoGineer918 B
- LICENSELicence file added by AutoGineer19.7 KiB
- SKILL.md6.6 KiB
- agents/openai.yaml245 B
- assets/trail-of-bits-mark.svg3.0 KiB
- references/bug-class-verification.md7.9 KiB
- references/deep-verification.md8.6 KiB
- references/evidence-templates.md2.9 KiB
- references/false-positive-patterns.md6.9 KiB
- references/gate-reviews.md1.9 KiB
- references/standard-verification.md4.4 KiB
references/false-positive-patterns.md
False Positive Patterns — Lessons Learned
Apply ALL items in this checklist to EACH potential bug during verification.
Contents:
Checklist — 13 items to apply to every bug (trace validation, confirm data paths, bounds logic, TOCTOU, trust boundaries, real vs theoretical impact, defense-in-depth)
Red Flags for False Positives — recurring failure patterns: pattern-based, context-blind, math/bounds, API-contract
Checklist
1. Trace Full Validation Chain
Don't analyze isolated code snippets. Trace backwards to find ALL validation that precedes potentially dangerous operations. Network packet size operations may look dangerous but often have bounds validation earlier in the function.
1a. Map Complete Conditional Logic Flow
Vulnerable-looking code may be unreachable due to conditional logic that creates mathematical guarantees. Example: array access buffer[length-4] appears unsafe when length < 4, but if the code is only reachable when length > 12 due to earlier validation, the vulnerability is impossible.
Verify:
What conditions must be met for execution to reach the alleged vulnerability?
Do those conditions mathematically prevent the vulnerability scenario?
Are there minimum size/length requirements that guarantee safe access?
Does the conditional flow create impossible-to-violate bounds?
2. Identify Defensive Programming Patterns
Distinguish between actual vulnerabilities and defensive assertions/validations. ASSERT(size == expected_size) followed by size-controlled operations is defensive, not vulnerable. Verify that checks actually prevent the alleged vulnerability.
3. Confirm Exploitable Data Paths
Only report vulnerabilities with CONFIRMED exploitable data flow paths. Don't assume network-controlled data reaches dangerous functions without tracing the actual path step by step.
4. Understand Data Source Context
Distinguish between data sources and their trust levels. API return values, compile-time constants, and network data have different risk profiles. Determine the actual source and whether it is attacker-controlled.
5. Analyze Bounds Validation Logic
Look for mathematical relationships between validation checks and subsequent operations. If packet_size >= MIN_SIZE is checked and MIN_SIZE >= sizeof(header), then packet_size - sizeof(header) cannot underflow.
6. Verify TOCTOU Claims
Time-of-check-time-of-use issues require proof that the checked value can change between check and use. If a size is checked and immediately used in the same function with no external modification possible, there is no TOCTOU.
7. Understand API Contract and Trust Boundaries
Always understand API contracts before claiming buffer overflows. Some APIs have built-in bounds protection and cannot write beyond the buffer regardless of input parameters.
8. Distinguish Internal Storage from External Input
Internal storage systems (configuration stores, registries) are controlled by trusted components, not attackers. Values set during installation by trusted components are not attacker-controlled.
9. Don't Confuse Pattern Recognition with Vulnerability Analysis
Code patterns that "look vulnerable" may be safely implemented due to context and API contracts. Size parameters being modified doesn't mean buffer overflow if the API prevents writing beyond bounds.
10. Verify Concurrent Access is Actually Possible
Don't assume race conditions exist without proving concurrent access patterns. Single-threaded initialization contexts cannot have race conditions. Verify the threading model and synchronization mechanisms.
11. Assess Real vs Theoretical Security Impact
Focus on vulnerabilities with actual security impact. Storage failure for non-critical data is an operational issue, not a security vulnerability. Ask: would this lead to code execution, privilege escalation, or information disclosure?
12. Understand Defense-in-Depth vs Primary Controls
Failure of defense-in-depth mechanisms is not always a vulnerability if primary protections exist. Token cleanup failure is not critical if tokens are single-use by design at the server.
13. Apply the Checklist Rigorously, Not Superficially
Having a checklist doesn't prevent false positives if it isn't applied systematically. For EVERY potential vulnerability, work through ALL checklist items before concluding.
Red Flags for False Positives
Pattern-Based False Positives
Reporting vulnerabilities in validation/bounds-checking code itself
Claiming TOCTOU without proving the value can change
Ignoring preceding validation logic
Assuming network data reaches operations without tracing the path
Confusing defensive programming (assertions/checks) with vulnerabilities
Analyzing vulnerable-looking patterns without tracing conditional logic that controls reachability
Reporting "vulnerabilities" in error handling or cleanup code
Flagging size calculations without understanding mathematical constraints
Identifying "dangerous" functions without checking if inputs are bounded
Claiming buffer overflows in fixed-size operations with compile-time bounds
Reporting race conditions in single-threaded or synchronized contexts
Context-Blind Analysis False Positives
Analyzing code snippets without understanding broader system design
Ignoring architectural guarantees (single-writer, trusted input sources)
Missing that "vulnerable" code is unreachable due to earlier validation
Confusing debug/development code paths with production paths
Reporting issues in code that only runs during trusted installation/setup
Flagging theoretical issues that cannot occur due to system architecture
Missing that alleged vulnerabilities are prevented by framework or language guarantees
Reporting issues in test-only or debug-only code paths as production vulnerabilities
Mathematical/Bounds Analysis False Positives
Reporting integer underflow without proving the mathematical condition can occur
Claiming buffer overflow when bounds are mathematically guaranteed by validation
Missing that conditional logic creates mathematical impossibility of vulnerable conditions
Reporting off-by-one errors without checking if loop bounds prevent the condition
Claiming memory corruption when allocation sizes are verified sufficient
Reporting arithmetic overflow without checking if input ranges prevent the condition
API Contract Misunderstanding False Positives
Claiming buffer overflows when APIs have built-in bounds checking
Reporting memory corruption for APIs that manage their own memory safely
Missing that return values are already validated by the API contract
Confusing API parameter modification with vulnerability when API prevents unsafe modification
Reporting issues explicitly handled by the API's safety guarantees
Missing that seemingly dangerous operations are safe due to API implementation details
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Needs: Declares allowed tools
Security
No issues found by our static scan· No issues found
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Published by
- Trail of Bits
- Publisher
- Trail of Bits (Official)
- Source
- trailofbits/skills · plugins/fp-check/skills/fp-check · commit e4dd0bb
- Licence
- Creative Commons Attribution-ShareAlike 4.0 International (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Trail of Bits.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download fp-check.zip