skill-maintenance

Validate Skill Unit structure and naming via a Python script.

3|Updated Nov 7, 2025
One-click install
npx skills add https://github.com/xiaden/nomarr --skill skill-maintenance-xiaden
Or copy as Structured Prompt for Agent
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.