Codex

grade-report

Generate corpus-wide GRADE quality distribution report

104 stars

byjmagly

View on GitHub Installation ↓

Best use case

grade-report is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

It is a strong fit for teams already working in Codex.

Generate corpus-wide GRADE quality distribution report

Teams using grade-report should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/grade-report/SKILL.md --create-dirs "https://raw.githubusercontent.com/jmagly/aiwg/main/.agents/skills/grade-report/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/grade-report/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How grade-report Compares

Feature / Agent	grade-report	Standard Approach
Platform Support	Codex	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Generate corpus-wide GRADE quality distribution report

Which AI agents support this skill?

This skill is designed for Codex.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

AI Agents for Coding

Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.

Cursor vs Codex for AI Workflows

Compare Cursor and Codex for AI coding workflows, repository assistance, debugging, refactoring, and reusable developer skills.

AI Agents for Marketing

Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.

SKILL.md Source

# 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