skill-maintenance

Validate Skill Unit structure and naming via a Python script.

3|Updated Nov 7, 2025

Search Tags:#guidance #skills #auditing #validate #lint #references #yaml-frontmatter

Ready to run

npx skills add https://github.com/xiaden/nomarr --skill skill-maintenance-xiaden

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-maintenance
Source: https://github.com/xiaden/nomarr/tree/main/.github/skills/skill-maintenance
Command: npx skills add https://github.com/xiaden/nomarr --skill skill-maintenance-xiaden

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The Skill Maintenance unit provides a blueprint for creating, updating, auditing, and validating Agent Skills. It centralizes guidance and automation scripts to ensure every Skill adheres to the official Skill Unit standard.

Core Features & Use Cases

Validation Script: Checks Skill frontmatter presence, naming conventions, line counts, and references to code.
Creation & Update Guidance: Step-by-step process to add new skills or modify existing ones while preserving consistency.
Periodic Audits: Workflow recommendations to regularly validate and revalidate skills as code evolves.

Quick Start

Run the validation script to assess all skills, or target a single skill with: python scripts/validate_skills.py skill-name

Frequently Asked Questions about skill-maintenance

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

FAQPage Schema

How do I validate YAML frontmatter in my repository?▼

To validate YAML frontmatter, you can run a Python script that checks for required name and description fields, enforcing directory-name conformance and size limits across the repository.

What is the best way to audit Skill naming conventions and structure?▼

Auditing Skill naming conventions involves applying a validation script during creation or updates to surface directory-name conformance issues and enforce structural metadata limits early.

How do I check code references and line counts in Skill files?▼

You can check code references and line counts by executing a validation script that targets optional reference checks and enforces size limits to maintain Skill consistency.

Can I use Python to lint YAML frontmatter for missing metadata?▼

Yes, you can use Python to lint YAML frontmatter by running a validation script that targets individual skills or the entire repository to surface missing metadata issues early.

How do I maintain consistency when updating existing Skills?▼

To maintain consistency when updating Skills, follow step-by-step guidance and run validation checks to ensure frontmatter presence, naming conventions, and reference integrity are preserved.

What are the limitations of automated Skill validation scripts?▼

Automated Skill validation scripts focus on structural rules like frontmatter presence, naming conventions, and size limits, but do not assess the semantic quality or execution logic of the code.