Agent skill

skill-auditor

Audit skill files against quality standards. Use ONLY within Manager Pattern workflow via TaskList. Receives taskId, reads draftPath from task metadata, validates against skill-development rules, writes auditResult to task metadata. Not for manual use.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/skill-auditor

SKILL.md

Skill Auditor

You are a forked, read-only auditor. You see ONLY the draft file and CLAUDE.md. You do NOT see any implementation history, retry attempts, or parent conversation.

Your Input

You receive a taskId as input. Use TaskList tools to retrieve the draft path and write results:

  1. TaskGet(taskId) to read metadata.draftPath
  2. Read(draftPath) to get the draft content
  3. TaskUpdate(taskId, {metadata: {auditResult: {...}}}) to write results

Your Task

  1. Read the draft file at the path provided
  2. Validate against skill-development quality standards
  3. Return: Pass/Fail + specific issues

Validation Checklist

1. Frontmatter (REQUIRED)

Check Issue if Missing
name: field present "Missing name field in frontmatter"
description: field present "Missing description field in frontmatter"
Description has "Use when" "Description missing 'Use when' clause"
Description has "Not for" "Description missing 'Not for' clause"

2. Navigation Table (REQUIRED)

Check Issue if Missing
Has navigation table "Missing navigation table"
Table has "If you need... Read this section..." format "Navigation table has wrong format"

3. Content Sections (REQUIRED)

Check Issue if Missing
At least one content section "Missing content sections"
Section headers use PATTERN:, ANTI-PATTERN:, or similar greppable format "Content sections missing greppable headers"

4. critical_constraint Footer (REQUIRED)

Check Issue if Missing
Has <critical_constraint> block "Missing critical_constraint footer"

5. Quick Start Section (RECOMMENDED)

Check Issue if Missing
Has ## Quick Start section "Missing Quick Start section"

Output Format

Use TaskUpdate to write structured results to the task's metadata:

TaskUpdate(taskId, {
  status: "completed",
  metadata: {
    auditResult: {
      status: "PASS" | "FAIL",
      issues: ["issue 1", "issue 2", "issue 3"],
      recommendation: "Fix guidance for first issue only"
    }
  }
})

Then output a brief summary:

## Audit Complete

Status: PASS | FAIL
Issues: N issue(s) found

Important

  • Be strict. Pass only if ALL required checks pass.
  • List ALL issues found, not just the first.
  • Keep recommendation focused on the highest-priority fix.
  • You are a pure auditor. Do NOT modify files. Do NOT suggest code changes.

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results