skill-hygiene

Catalog common skill issues and enforce review workflows during audits.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/shellicar/skills --skill skill-hygiene
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-hygiene
Source: https://github.com/shellicar/skills/tree/main/skills/skill-hygiene
Command: npx skills add https://github.com/shellicar/skills --skill skill-hygiene

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the degradation of skill quality over time by providing a systematic way to detect issues early and track improvements, preventing repeated work and loss of institutional knowledge in skill libraries.

Core Features & Use Cases

  • Skill Smells Catalogue: Identifies patterns in descriptions, validity, and structure that signal potential problems, guiding targeted fixes.
  • Hygiene Pass Workflow: Outlines a batch-based process for reviewing and updating skills, including reading guidelines and committing changes.
  • Use Case: When maintaining a repository of 40+ skills, use this to audit batches alphabetically, rewrite descriptions against standards, and update the current state log to ensure ongoing quality without starting over.

Quick Start

Trigger the skill-hygiene skill to begin auditing the quality of skills in the current batch.

Frequently Asked Questions about skill-hygiene

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

FAQPage Schema
How do I audit AI skill quality in a development repository?▼

To audit AI skill quality in a development repository, trigger a structured review workflow that catalogs common description, validity, and structural issues to enforce consistent standards and track improvements.

What are skill smells and how do they indicate maintenance issues?▼

Skill smells are patterns in descriptions, validity, and structure that signal potential problems in a skill library. Identifying these smells early guides targeted fixes and prevents the loss of institutional knowledge.

What is the best way to maintain quality when managing 40 or more skills?▼

For managing 40 or more skills, the best way to maintain quality is using a batch-based hygiene pass workflow to audit skills alphabetically, rewrite descriptions against standards, and update a current state log.

How do I perform a batch review of skill metadata?▼

You perform a batch review of skill metadata by triggering a hygiene pass workflow that reads guidelines, audits the current batch alphabetically, rewrites descriptions against standards, and commits the changes.

Why does skill quality degrade over time in a library?▼

Skill quality degrades over time due to inconsistent descriptions and structural drift during ongoing updates. Applying validity checks and structural integrity tracking prevents repeated work and preserves knowledge.