dodyg/report-generation
.agents/skills/report-generation/SKILL.md
Audit report formatting, severity scoring, scorecard computation, and compliance export for document accessibility audits. Use when generating DOCUMENT-ACCESSIBILITY-AUDIT.md reports, computing document severity scores (0-100 with A-F grades), creating VPAT/ACR compliance exports, or formatting remediation priorities.
development
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add dodyg/blue-nile-pds report-generationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 9:28 PM8.8s1 file scanned
SKILL.md
- name:
- report-generation
- description:
- Audit report formatting, severity scoring, scorecard computation, and compliance export for document accessibility audits. Use when generating DOCUMENT-ACCESSIBILITY-AUDIT.md reports, computing document severity scores (0-100 with A-F grades), creating VPAT/ACR compliance exports, or formatting remediation priorities.
Report Generation
Report File
Default output: DOCUMENT-ACCESSIBILITY-AUDIT.md in the project root.
Required Sections
Every audit report MUST include these sections:
- Audit Information - date, auditor, profile, scope, counts
- Executive Summary - totals, pass rate, most common issue, effort estimate
- Cross-Document Patterns - recurring issues, systemic failures
- Findings by File - per-document issues with rule ID, severity, location, WCAG, impact, remediation
- Findings by Rule (Cross-Reference) - rule-level aggregation across files
- What Passed - acknowledge clean documents and categories
- Remediation Priority - ordered by impact (Immediate / Soon / When Possible)
- Accessibility Scorecard - per-document scores and grades
- Metadata Dashboard - document properties health
- Confidence Summary - breakdown by confidence level
Optional Sections (include when applicable)
- Template Analysis - when batch scanning detects shared templates
- Comparison Report - when re-scanning against a baseline
- CI/CD Recommendations - when no config files exist
Severity Scoring Formula
Document Score = 100 - (sum of weighted findings)
Weights:
Error (high confidence): -10 points
Error (medium confidence): -7 points
Error (low confidence): -3 points
Warning (high confidence): -3 points
Warning (medium confidence):-2 points
Warning (low confidence): -1 point
Tips: 0 points
Floor: 0 (minimum score)
Score Grades
| Score | Grade | Meaning | |-------|-------|---------| | 90-100 | A | Excellent - minor or no issues | | 75-89 | B | Good - some warnings, few errors | | 50-74 | C | Needs Work - multiple errors | | 25-49 | D | Poor - significant accessibility barriers | | 0-24 | F | Failing - critical barriers, likely unusable with AT |
Organization Modes
| Mode | Description | Best For | |------|-------------|----------| | By file | Group all issues under each document | Small batches (< 10 files) | | By issue type | Group all instances of each rule across documents | Seeing patterns | | By severity | Critical first, then serious, moderate, minor | Prioritizing fixes |
VPAT/ACR Compliance Export
Conformance Levels
| Level | Criteria | |-------|----------| | Supports | No findings for this WCAG criterion across any document | | Partially Supports | Some documents pass, some fail | | Does Not Support | All or most documents fail | | Not Applicable | Criterion does not apply to scanned document types |
Supported VPAT Editions
- VPAT 2.5 (WCAG) - maps to WCAG 2.2 criteria
- VPAT 2.5 (508) - maps to Revised Section 508 standards
- VPAT 2.5 (EN 301 549) - maps to EU accessibility directive
- VPAT 2.5 (INT) - International edition (all three combined)
Remediation Tracking
When comparing against a baseline audit report:
| Status | Meaning | |--------|---------| | Fixed | Issue was in previous report but is now resolved | | New | Issue was not in previous report but appears now | | Persistent | Issue remains from previous report | | Regressed | Issue was previously fixed but has returned |
Progress Metrics
- Issue reduction percentage:
(fixed / previous_total) * 100 - Score change:
current_score - previous_score - Documents improved: count of documents with higher scores
Related Skills
dodyg/csharp-tunit
testing
VerifiedTrustedCommunity
Get best practices for TUnit unit testing, including data-driven tests
SKILL.mdUpdated Apr 16, 2026
dodyg/web-severity-scoring
development
VerifiedTrustedCommunity
Severity scoring, scorecard computation, confidence levels, and remediation tracking for web accessibility audits. Use when computing page accessibility scores (0-100 with A-F grades), tracking remediation progress across audits, or generating cross-page comparison scorecards.
SKILL.mdUpdated Apr 16, 2026
dodyg/web-scanning
development
VerifiedTrustedCommunity
Web content discovery, URL crawling, and page inventory for accessibility audits. Use when scanning web pages, crawling sites for audit scope, or building page inventories for multi-page audits.
SKILL.mdUpdated Apr 16, 2026
dodyg/python-development
development
VerifiedTrustedCommunity
Python and wxPython development reference patterns, common pitfalls, framework-specific guides, desktop accessibility APIs, and cross-platform considerations. Use when building, debugging, packaging, or reviewing Python desktop applications.
SKILL.mdUpdated Apr 16, 2026