finding-interpreter

Translate raw security scan JSON into plain-language findings for business owners.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/stanz-stanz/heimdall --skill finding-interpreter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finding-interpreter
Source: https://github.com/stanz-stanz/heimdall/tree/main/.claude/agents/finding-interpreter
Command: npx skills add https://github.com/stanz-stanz/heimdall --skill finding-interpreter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Finding Interpreter turns raw security scan output into plain-language findings that non-technical business owners can understand and act on, removing jargon and focusing on business impact and safe remediation steps.

Core Features & Use Cases

  • Plain-language translation: Convert technical scan details (CVSS, CVE, server banners) into clear "what is wrong" and "what it means for your business" statements.
  • Tier-aware guidance: Produce different output levels (Watchman explanation-only, Sentinel with remediation) and recommend who should fix issues (self, developer, hosting-provider).
  • Safety-first recommendations: Bound remediation to generic, verifiable steps and authoritative references; flag low-confidence items for human review.
  • Client memory integration: Detect recurring findings by consulting client history and escalate language for repeated issues.
  • Use case: Produce a client brief describing an outdated CMS vulnerability for a small restaurant owner, mapping severity to business impact and safe next steps.

Quick Start

Interpret scan-20260321-001 for client-001 and generate interpreted-findings.json containing plain-language findings, mapped business impact, remediation guidance, confidence, and review flags.

Frequently Asked Questions about finding-interpreter

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

FAQPage Schema
How do I translate raw security scan output into plain language findings for clients?

To translate raw security scan output into plain language findings, process structured JSON from network and web scanners to generate interpreted-findings.json. This output file maps technical details like CVSS and CVE severities into clear business impact statements and actionable remediation steps.

How do I map CVSS and CVE severities to business impact for non-technical owners?

Mapping CVSS and CVE severities to business impact involves analyzing raw security scan JSON and converting technical vulnerabilities into clear statements of what is wrong and what it means for the business. This translation removes jargon and focuses on safe, actionable next steps.

Can I generate tier-aware remediation guidance for different client support levels?

Yes, you can generate tier-aware remediation guidance by producing different output levels based on client support tiers. This includes Watchman explanations for awareness and Sentinel outputs with specific remediation steps, while recommending who should fix the issues.

How do I detect recurring vulnerabilities using client memory history?

Detecting recurring vulnerabilities uses client memory integration to consult client history files during scan interpretation. This mechanism identifies repeated findings across scans and automatically escalates the language used in the plain-language findings to highlight persistent issues.

Does interpreting security scans require structured JSON input?

Yes, interpreting security scans requires structured JSON input. The process consumes raw-output.json files generated by network and web scanners, along with client memory files, to accurately map technical severities to business impact and produce verifiable remediation guidance.

How are low-confidence vulnerabilities handled during scan interpretation?

Low-confidence vulnerabilities are handled during scan interpretation by applying safety-first recommendations that bound remediation to generic, verifiable steps. The interpreted-findings.json output explicitly flags these items with a needs_human_review status for manual verification.