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.