finding-review

Validate security finding files for structure, severity, and cited sources.

63|8|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/JoranHonig/grimoire --skill finding-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finding-review
Source: https://github.com/JoranHonig/grimoire/tree/main/skills/finding-review
Command: npx skills add https://github.com/JoranHonig/grimoire --skill finding-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, standards-driven review of existing security findings to improve clarity, correctness, and actionable guidance so maintainers can assess and remediate issues confidently.

Core Features & Use Cases

  • Structural validation: Parses finding frontmatter and sections and reports schema violations.
  • Quality assessment: Evaluates title clarity, description completeness, recommendation objectivity, severity accuracy, and precondition specification.
  • Cross-checking: Invokes a familiar agent for impact and feasibility triangulation and a librarian agent to verify and locate authoritative references.
  • Interactive fixes: Presents passes, warnings, failures, and recommendations and can apply approved edits and re-run validation.
  • Use case: Run on a repository finding file to harden a draft finding before publishing or triaging in a security audit.

Quick Start

Review the specified finding file, run the validation checks, include the familiar and librarian assessments, and apply the recommended edits when prompted.

Frequently Asked Questions about finding-review

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

FAQPage Schema
How do I validate the structure and quality of security findings before publishing?

To validate security findings, you can review and parse finding files to check frontmatter, sections, severity, preconditions, and cited sources. This process generates a structured passes, warnings, and failures report to improve clarity and correctness.

What is the best way to harden draft security audit findings for triage?

The best way to harden draft security audit findings is to run structural validation and cross-check impact and references. This evaluates title clarity, description completeness, and severity accuracy to provide actionable remediation guidance confidently.

Can I automatically apply fixes when reviewing security finding files?

Yes, you can automatically apply fixes when reviewing security finding files. The review process presents recommendations and can apply approved edits interactively, then re-run validation checks to ensure the updated finding passes schema compliance.

How does cross-checking verify authoritative references in security findings?

Cross-checking verifies authoritative references by invoking a librarian agent to locate and validate cited sources. It also uses a familiar agent to triangulate impact and feasibility, ensuring the finding is factually accurate and well-supported.

What should I do if my security finding has schema violations or missing preconditions?

If your security finding has schema violations or missing preconditions, run a structural validation review. This identifies frontmatter schema violations and unspecified preconditions, offering interactive fixes and recommendations to harden the file.