# Grade Report

> Generate corpus-wide GRADE quality distribution report

- Skill: `jmagly-ai-writing-guide/grade-report` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jmagly-ai-writing-guide/grade-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jmagly-ai-writing-guide/grade-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: jmagly (https://skillmd.com/u/jmagly-ai-writing-guide)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/jmagly-ai-writing-guide/grade-report

---


# GRADE Report Command

Generate a report on the evidence quality distribution across the research corpus.

## Instructions

When invoked, analyze and report on corpus quality:

1. **Scan Quality Assessments**
   - Load all assessments from `.aiwg/research/quality-assessments/`
   - Load frontmatter quality fields from all sources

2. **Calculate Distribution**
   - Count sources by GRADE level (HIGH, MODERATE, LOW, VERY LOW)
   - Count sources by source type
   - Identify unassessed sources

3. **Generate Report**
   - Summary table: GRADE distribution
   - Source type breakdown
   - Unassessed sources list
   - Hedging compliance summary (overclaiming count)
   - Recommendations for corpus improvement

4. **Save Report**
   - Display to user
   - Optionally save to `.aiwg/reports/grade-report.md`

## Arguments

- `--brief` - Show summary only
- `--unassessed` - Show only unassessed sources
- `--save` - Save report to `.aiwg/reports/grade-report.md`

## References

- @.aiwg/research/docs/grade-assessment-guide.md - GRADE methodology
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/agents/quality-assessor.md - Quality Assessor
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/research/quality-dimensions.yaml - Quality schema