nw-abr-critique-dimensions

Featured

Review dimensions for validating agent quality - template compliance, safety, testing, and priority validation

Testing & QA 327 stars 38 forks Updated 6 days ago MIT

Install

View on GitHub

Quality Score: 96/100

Stars 20%
84
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Agent Quality Critique Dimensions Use these dimensions when reviewing or validating agent definitions. ## Dimension 1: Template Compliance Does the agent follow official Claude Code format? **Check**: YAML frontmatter with name and description (required) | Markdown body as system prompt | No embedded YAML config blocks | No activation-instructions or IDE-FILE-RESOLUTION sections | Skills referenced in frontmatter, not inline **Severity**: High -- non-compliant agents may not load correctly. ## Dimension 2: Size and Focus **Check**: Core definition under 400 lines | Domain knowledge in Skills | Single clear responsibility | No monolithic sections (>50 lines without structure) | No redundant Claude default behaviors **Measurement**: `wc -l {agent-file}`. Target: 200-400 lines. **Severity**: High -- oversized agents suffer context rot. ## Dimension 3: Divergence Quality Does the agent specify only what diverges from Claude defaults? **Check**: No file operation instructions | No generic quality principles ("be thorough") | No tool usage guidelines | Core principles are domain-specific and non-obvious | Each instruction justifies why Claude wouldn't do this naturally **Severity**: Medium -- redundant instructions waste tokens, cause overtriggering. ## Dimension 4: Safety Implementation **Check**: Tools restricted via frontmatter `tools` field | maxTurns set | No prose-based security layers (use hooks) | No embedded enterprise safety frameworks | permissionMode se...

Details

Author
nWave-ai
Repository
nWave-ai/nWave
Created
2 months ago
Last Updated
6 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Listed

doc-review

Review a single file or all files in a folder for data inconsistencies, reference errors, typos, and unclear terminology using parallel sub-agents

12 Updated 6 days ago
vladm3105
AI & Automation Featured

build-agent

Builds new Claude Code agents with consistent structure, enforced standards, and project-aware configuration. Use when creating a new agent, when the user describes a specialised role they want delegated to, or when discussing team composition.

207 Updated 1 weeks ago
LukeRenton
AI & Automation Featured

agent-md-refactor

Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.

1,445 Updated 1 months ago
softaworks
AI & Automation Solid

agent-skills-authoring

Guides agents through creating, validating, and optimizing Agent Skills (SKILL.md files) from user requests. Covers all YAML frontmatter fields, directory layout, progressive disclosure, scripts, quality patterns, and evaluation workflows. Use when a user asks you to create, edit, audit, or improve an Agent Skill, even if they don't use the word "skill" — any request about reusable agent instructions, workflow packaging, or capability extension should trigger this skill.

18 Updated 3 weeks ago
zebbern
AI & Automation Solid

agent-factory

Claude Code agent generation system that creates custom agents and sub-agents with enhanced YAML frontmatter, tool access patterns, and MCP integration support following proven production patterns

682 Updated 5 months ago
alirezarezvani