skills.rest
SpillwaveSolutions
SpillwaveSolutionsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

grading-claude-agents-md

Grade CLAUDE.md and AGENTS.md files against a four-pillar rubric.

4|Updated Jan 5, 2026
Search Tags:#claude#agents#config#improvement#assessment#rubric#grading
One-click install
npx skills add https://github.com/SpillwaveSolutions/grading-claude-agents-md-agentic-skill --skill grading-claude-agents-md
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grading-claude-agents-md
Source: https://github.com/SpillwaveSolutions/grading-claude-agents-md-agentic-skill/tree/main/skills/grading-claude-agents-md
Command: npx skills add https://github.com/SpillwaveSolutions/grading-claude-agents-md-agentic-skill --skill grading-claude-agents-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Grades and improves CLAUDE.md (Claude Code) and AGENTS.md (Codex/OpenCode) configuration files. Use when asked to grade, score, evaluate, audit, review, improve, fix, optimize, or refactor agent config files.

Core Features & Use Cases

  • Grades CLAUDE.md and AGENTS.md against a 100-point rubric and generates a prioritized improvement plan.
  • Automatically identifies structure, content quality, progress disclosure, and maintainability issues, and proposes targeted fixes.
  • Supports both CLAUDE.md and AGENTS.md formats and can produce before/after comparisons.

Quick Start

Detect CLAUDE.md and AGENTS.md in the project, grade them against the rubric, and review the resulting improvement plan.

Frequently Asked Questions about grading-claude-agents-md

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

FAQPage Schema
How do I grade and improve my CLAUDE.md configuration file?▼

You can audit CLAUDE.md and AGENTS.md files against a four-pillar rubric covering Structure, Content Quality, PDA Implementation, and Maintainability, which yields a graded scorecard and a targeted remediation plan.

What is the best way to evaluate an AGENTS.md file for Codex or OpenCode?▼

The best way to evaluate an AGENTS.md file is applying a 100-point rubric across four pillars—Structure, Content Quality, PDA Implementation, and Maintainability—to output a scorecard and targeted fixes.

Can I use this rubric to review both CLAUDE.md and AGENTS.md formats?▼

Yes, the assessment supports both CLAUDE.md and AGENTS.md formats, applying the same standardized four-pillar rubric to produce before/after comparisons and actionable implementation guidance.

How do I fix structure and content quality issues in my agent config?▼

To fix structure and content quality issues, run the assessment to automatically identify weaknesses and generate targeted remediation changes with specific implementation guidance for your agent config files.

Does the grading process provide implementation guidance for proposed changes?▼

Yes, the grading process yields a scorecard, a prioritized improvement plan, and specific implementation guidance to help you enact actionable changes for both CLAUDE.md and AGENTS.md files.

Related Skills

Explore More Software Engineering Skills→
mgratzermgratzer
65

forge-setup-project

Create CLAUDE.md, AGENTS.md, docs/, README, and CHANGELOG.md for Forge projects.

Community
Intermediate
dongzhuoyaodongzhuoyao
10

memory-sync

Synchronize canonical project memory with generated AGENTS.md and CLAUDE.md files.

Community
Intermediate
chetmancinichetmancini

analyze-config

Analyzes Agent Smith session metrics and generates tuning recommendations for Claude Code, Codex, OpenCode, and Pi.

Community
Advanced
mcj-codermcj-coder
1

markdown-author

Enforce markdown linting and spelling standards with markdownlint-cli2 and cspell.

Community
Advanced