{
  "slug": "reporting",
  "name": "Finding reporting",
  "category": "Research",
  "summary": "Build a concise finding from durable evidence while separating validated behavior, modeled impact, and unresolved uncertainty.",
  "scope": "Defensive study and review of artifacts supplied by their owner. Record missing evidence as an open question.",
  "inputs": [
    "Validated check records and evidence references",
    "Relevant lead history",
    "Affected security boundary and remediation expectation"
  ],
  "review": [
    {
      "title": "Assemble only supporting records",
      "body": "Use search_hunt_records to retrieve the exact assets, checks, leads, and evidence that support the report. Keep observations and validated findings in separate sentences."
    },
    {
      "title": "State impact at its evidence level",
      "body": "Describe direct impact as observed, plausible impact as modeled, and remaining gaps as uncertainty. A lead does not become a vulnerability merely because it is ranked highly."
    },
    {
      "title": "Export a reviewable brief",
      "body": "When a local Hunt Workbench is available, use export_handoff to generate a concise Markdown brief with scope, coverage, blockers, and evidence-linked next steps. Add public citations from hosted research only when they add context."
    }
  ],
  "outputs": [
    "Evidence-bounded finding draft",
    "Explicit impact and uncertainty statement",
    "Portable Markdown brief with record references"
  ],
  "pitfalls": [
    "Claiming impact beyond the records",
    "Embedding secrets or unneeded third-party data",
    "Presenting a lead as validated"
  ],
  "mcp": {
    "hosted": [
      "get_research_context",
      "search_research",
      "get_research_record"
    ],
    "workbench": [
      "search_hunt_records",
      "record_check",
      "upsert_lead",
      "export_handoff"
    ]
  },
  "references": {
    "resources": [
      {
        "id": "hackerone-quality-vulnerability-reports",
        "title": "Quality Reports",
        "url": "https://vulns.co/research/resources/hackerone-quality-vulnerability-reports/"
      },
      {
        "id": "owasp-security-logging-evidence-quality",
        "title": "OWASP Logging: trustworthy and minimal application evidence",
        "url": "https://vulns.co/research/resources/owasp-security-logging-evidence-quality/"
      }
    ],
    "diagrams": [
      {
        "id": "approval-version-integrity",
        "title": "Approval stays attached to the reviewed version",
        "url": "https://vulns.co/research/diagrams/approval-version-integrity/"
      }
    ],
    "reports": [
      {
        "id": "google-cloud-build-approval-toctou-2025",
        "title": "Cloud Build approval was not bound to immutable code",
        "url": "https://vulns.co/research/reports/google-cloud-build-approval-toctou-2025/"
      },
      {
        "id": "github-actions-reference-validation-2021",
        "title": "GitHub Actions trust depended on invalid repository references",
        "url": "https://vulns.co/research/reports/github-actions-reference-validation-2021/"
      }
    ]
  },
  "provenance": {
    "publisher": "vulns.co / GK Data",
    "guide_updated": "2026-10-12",
    "library_as_of": "2026-10-04",
    "library_commit": "d5550c7891119cf1379e235721541c947850a3b3"
  },
  "url": "https://vulns.co/skills/reporting/",
  "markdown_url": "https://vulns.co/skills/reporting/SKILL.md"
}