Validate that worker-generated reports have all required sections and proper formatting. Use in quality gates, for report completeness checking, or when debugging missing report sections.
79%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./.claude/skills/validate-report-file/SKILL.mdValidate agent-generated report files for completeness and proper structure.
Use Read tool to load report file.
Expected Input:
file_path: Path to report file (e.g., bug-hunting-report.md)Tools Used: Read
Verify all required sections are present.
Required Sections:
Header with metadata:
Executive Summary:
Detailed Findings:
Validation Results:
Next Steps:
Check formatting and structure.
Format Rules:
Verify status indicators are consistent.
Consistency Checks:
Return detailed validation result.
Expected Output:
{
"valid": true,
"file": "bug-hunting-report.md",
"sections": {
"header": true,
"executiveSummary": true,
"detailedFindings": true,
"validationResults": true,
"nextSteps": true
},
"warnings": [],
"errors": []
}Input:
file_path: bug-hunting-report.mdFile Content:
# Bug Hunting Report: 2025-10-17
**Generated**: 2025-10-17 14:30:00 UTC
**Status**: ✅ success
---
## Executive Summary
Found 23 bugs across 147 files.
## Detailed Findings
### Critical (3)
- Bug 1
- Bug 2
- Bug 3
## Validation Results
- Type-check: ✅ PASSED
- Build: ✅ PASSED
**Overall**: ✅ PASSED
## Next Steps
1. Review critical bugs
2. Schedule fixesOutput:
{
"valid": true,
"file": "bug-hunting-report.md",
"sections": {
"header": true,
"executiveSummary": true,
"detailedFindings": true,
"validationResults": true,
"nextSteps": true
},
"warnings": [],
"errors": []
}Input:
file_path: incomplete-report.mdFile Content:
# Bug Report
Some bugs found.Output:
{
"valid": false,
"file": "incomplete-report.md",
"sections": {
"header": false,
"executiveSummary": false,
"detailedFindings": false,
"validationResults": false,
"nextSteps": false
},
"warnings": [],
"errors": [
"Missing header metadata (Generated, Status, Version)",
"Missing section: Executive Summary",
"Missing section: Detailed Findings",
"Missing section: Validation Results",
"Missing section: Next Steps"
]
}Input:
file_path: inconsistent-report.mdFile Content:
# Bug Report: 2025-10-17
**Status**: ✅ success
## Executive Summary
Failed to scan files.
## Validation Results
**Overall**: ❌ FAILEDOutput:
{
"valid": false,
"file": "inconsistent-report.md",
"sections": {
"header": true,
"executiveSummary": true,
"detailedFindings": false,
"validationResults": true,
"nextSteps": false
},
"warnings": [
"Status inconsistency: Header shows success (✅) but validation shows failed (❌)"
],
"errors": [
"Missing section: Detailed Findings",
"Missing section: Next Steps"
]
}schema.json: Report structure schema (see Supporting Files section)8c3b576
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.