skills.rest
greenheadHQ
greenheadHQCOMMUNITY
Explore all skills by this author →
GitHub

maintaining-skills

Audit Claude Code skills frontmatter, references, and CLAUDE routing coverage.

4|Updated Dec 21, 2025
Search Tags:#routing#audit#quality#claude-code#frontmatter#references
One-click install
npx skills add https://github.com/greenheadHQ/nixos-config --skill maintaining-skills
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maintaining-skills
Source: https://github.com/greenheadHQ/nixos-config/tree/main/modules/shared/programs/claude/files/skills/maintaining-skills
Command: npx skills add https://github.com/greenheadHQ/nixos-config --skill maintaining-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audit and maintain Claude Code skills quality across global and project scopes, ensuring consistent routing, naming, and references.

Core Features & Use Cases

  • Inventory global and project skill sources and validate frontmatter, references, and CLAUDE routing.
  • Detect missing files, broken links, naming mismatches, and misaligned triggers.
  • Guide for splitting or merging skills based on scope and references to improve maintainability.

Quick Start

Audit the Claude Code skills in this repository and generate a maintenance plan detailing required changes.

Frequently Asked Questions about maintaining-skills

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

FAQPage Schema
How do I audit Claude Code skills for missing frontmatter and broken references?▼

To audit Claude Code skills, you can validate frontmatter fields like name and description, verify that referenced files exist, and generate a maintenance plan detailing missing files, broken links, and naming mismatches.

What is the best way to validate CLAUDE routing coverage for project skills?▼

Validating CLAUDE routing coverage involves inventorying global and project skill sources to confirm that triggers are aligned, ensuring consistent routing and naming across the entire repository for maintainability.

Does this skill auditing tool work with nixos-config projects?▼

Yes, this skill auditing process applies directly to nixos-config projects, validating frontmatter, references, routing, and overall quality criteria to ensure consistent Claude Code skill execution.

How do I detect misaligned triggers in my Claude Code skills?▼

Detecting misaligned triggers requires inventorying your skill sources and validating their CLAUDE routing coverage, which helps identify mismatches between intended triggers and actual routing configurations.

When should I split or merge Claude Code skills to improve maintainability?▼

You should split or merge Claude Code skills based on their scope and references after conducting a quality audit, which reveals misaligned triggers or naming mismatches that hinder overall maintainability.

Why does my Claude Code skill fail due to missing frontmatter fields?▼

Claude Code skills fail when frontmatter lacks required fields, because the validation process checks for mandatory name and description attributes to ensure consistent routing and quality standards.

Related Skills

Explore More Software Engineering Skills→
iqbal125iqbal125

workos

Validate SKILL.md frontmatter and extract metadata into a structured YAML block.

Community
Advanced
baekenoughbaekenough
34

fix-refs

Identify and fix broken agent references and symlinks via mgr-supplier audits.

Community
Intermediate
t-stringst-strings

Global Tech Stack

Enforce global tech stack standards in code generation and review tasks.

Official
Basic
Everyone-Needs-A-CopilotEveryone-Needs-A-Copilot
13

link-validation

Validate Markdown links, anchors, and cross-references across repository files.

Official
Basic