Documentation Intelligence Agent

Analyze project documentation to validate and adjust vulnerability findings in GitHub repositories.

3|1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/camgrimsec/grimsec-suite --skill documentation-intelligence-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Documentation Intelligence Agent
Source: https://github.com/camgrimsec/grimsec-suite/tree/main/claude-code/.claude/skills/doc-intel
Command: npx skills add https://github.com/camgrimsec/grimsec-suite --skill documentation-intelligence-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

Security scanners often produce noisy vulnerability findings that need validation against actual application documentation to confirm real risks and avoid false positives.

Core Features & Use Cases

  • 8-Phase Analysis Sweep: Inventories docs, extracts architecture, security controls, and deployment details to build a comprehensive context profile.
  • Risk Adjustment: Downgrades or confirms scanner findings based on documented mitigations like sandboxing or encryption.
  • Use Case: Before submitting a security PR for a flagged CVE in a web app, run this to check if the docs describe built-in auth controls that already mitigate it, adjusting the risk score accordingly.

Quick Start

Invoke the doc-intel skill to build a security context profile from the README and docs folder of this GitHub repository.

Frequently Asked Questions about Documentation Intelligence Agent

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

FAQPage Schema
How do I validate vulnerability findings against project documentation?

To validate vulnerability findings against project documentation, run an 8-phase analysis sweep that inventories docs, extracts architecture, and maps security controls to downgrade or confirm scanner risks. This generates a JSON profile with evidence-based adjustments.

What is doc-driven security profiling for DevSecOps workflows?

Doc-driven security profiling is an analysis process that extracts security architecture and API surface mappings from repository documentation to adjust and validate noisy vulnerability findings. It produces a JSON context profile with evidence-based risk scores.

How do I reduce false positives in security scanner results using documentation?

Reduce false positives in security scanner results by checking your README and docs folder for documented mitigations like sandboxing or encryption. The analysis downgrades or confirms flagged CVEs based on these documented built-in controls.

Can I use documentation analysis for security architecture review in GitHub projects?

Yes, you can use documentation analysis for security architecture review in GitHub projects. The process inventories repository documentation, extracts deployment details, and maps API surfaces to generate a comprehensive security context profile.

Do I need pyyaml to run documentation-based vulnerability validation?

Yes, pyyaml is a required dependency to run documentation-based vulnerability validation scripts. You need this package installed in your environment to execute the analysis phases and generate JSON security profiles.

What are the limitations of using documentation to adjust vulnerability risk scores?

The limitation of using documentation to adjust vulnerability risk scores is that the analysis relies entirely on the accuracy and completeness of existing repository docs. Missing or outdated documentation may prevent the proper validation of flagged security vulnerabilities.