compliance-checker

Run skill design compliance validation for agentic collections. Use when the user asks to: - "Check skill compliance" / "Validate skill design" / "Run compliance check" - "Verify my skills follow design principles" - Before committing skill changes Runs the validate_skills_tier2.py script against SKILL_DESIGN_PRINCIPLES.md.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, actionable skill body with executable make commands and a clear workflow for a simple single-purpose validation task. Small improvements are possible around deduplication of trigger guidance, an explicit re-validate loop, and consistent reference paths.

Suggestions

Remove the 'When to Use This Skill' section or fold it into the frontmatter description to avoid duplicating trigger guidance between the description and body.

Add an explicit re-validate feedback loop in the Workflow (fix errors → re-run 'make validate-skill-design-changed' → only report success once it passes).

Use a single consistent relative path for the SKILL_DESIGN_PRINCIPLES.md reference across the body to avoid navigation ambiguity.

Dimension	Reasoning	Score
Conciseness	The body is largely efficient with copy-paste commands and a useful project-specific DP1–DP7 list, though the 'When to Use This Skill' section partially duplicates the frontmatter description.	4 / 5
Actionability	Provides fully executable, copy-paste-ready commands ('make validate-skill-design-changed', 'make validate-skill-design PACK=rh-sre') covering the common cases.	5 / 5
Workflow Clarity	Clear sequenced workflow (run from root, choose preferred/alternative command, report pass/fail with fix suggestions), but it lacks an explicit re-validate feedback loop after fixes are applied.	4 / 5
Progressive Disclosure	Well-organized into clear sections appropriate for a simple single-purpose skill, with the SKILL_DESIGN_PRINCIPLES.md reference signaled; minor gap is the inconsistent reference paths ('SKILL_DESIGN_PRINCIPLES.md' vs '../../../SKILL_DESIGN_PRINCIPLES.md').	4 / 5
	Total	17 / 20 Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A clear, third-person description that explicitly states both capability and trigger conditions with natural phrasing. Its main weakness is somewhat narrow action coverage relative to the comprehensive-trigger anchor.

Dimension	Reasoning	Score
Specificity	Names the domain ('skill design compliance validation for agentic collections') and one concrete action ('Runs the validate_skills_tier2.py script against SKILL_DESIGN_PRINCIPLES.md'), but coverage is narrow rather than comprehensive.	3 / 5
Completeness	Explicitly answers both what ('Run skill design compliance validation... Runs the validate_skills_tier2.py script') and when ('Use when the user asks to... Before committing skill changes') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes several natural trigger phrases users would say ('Check skill compliance', 'Validate skill design', 'Run compliance check', 'Verify my skills follow design principles'), though it lacks file-extension-style variants.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (skill design compliance checking) with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	17 / 20 Passed

Validation

87%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 1 missing, 1 suspicious	Warning
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	14 / 16 Passed

Repository: RHEcosystemAppEng/agentic-plugins
Path: .claude/skills/compliance-checker/SKILL.md
Commit: e46c4fa

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

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.