skill-maintenance

Audit Claude Code skills against Anthropic best practices and generate JSON reports.

4|1|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/m2ai-portfolio/m2ai-skills-pack --skill skill-maintenance-m2ai-portfolio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-maintenance
Source: https://github.com/m2ai-portfolio/m2ai-skills-pack/tree/main/skills/skill-maintenance
Command: npx skills add https://github.com/m2ai-portfolio/m2ai-skills-pack --skill skill-maintenance-m2ai-portfolio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Audit Claude Code skills for content quality against Anthropic best practices. It supports maintenance cycles, user requests to review skills, and pre-publishing reviews to ensure standards compliance.

Core Features & Use Cases

  • Produces a scored audit report with actionable findings and patch candidates for Phase 2b remediation.
  • Validates frontmatter presence, name format, description quality, progressive disclosure, and directory structure.
  • Enables batch audits of all skills or per-skill audits using the provided scripts for consistent quality checks.

Quick Start

Run the batch audit to generate a report for all skills.

Frequently Asked Questions about skill-maintenance

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

FAQPage Schema
How do I audit Claude Code skills for content quality?

You audit Claude Code skills by running batch or per-skill scripts that validate frontmatter, name standards, description quality, progressive disclosure, and directory structure, generating a scored JSON report with findings and patch recommendations.

What does a Claude Code skill quality audit check?

A skill quality audit checks frontmatter presence, name format standards, description quality, progressive disclosure compliance, and directory structure alignment against Anthropic best practices.

Can I run batch audits across all Claude Code skills?

Yes, you can run batch audits across the entire skill catalog using provided scripts to ensure consistent quality checks, producing a comprehensive scored report with actionable findings and patch candidates.

When should I run a pre-publishing skill review?

You run a pre-publishing skill review to ensure standards compliance before adding skills to the catalog, catching frontmatter, naming, and description quality issues alongside directory structure problems.

Does the skill audit generate patch recommendations?

Yes, the audit produces a JSON report containing actionable findings and specific patch candidates for Phase 2b remediation to fix content quality issues.

How do I validate frontmatter and directory structure in Claude Code skills?

You validate frontmatter and directory structure by executing the audit scripts, which enforce frontmatter presence and check directory structure alignment against Anthropic best practices automatically.