skill-hygiene

Audit installed agent skills for health, governance, and provenance anomalies.

24|2|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/yknothing/skills-refiner --skill skill-hygiene-yknothing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-hygiene
Source: https://github.com/yknothing/skills-refiner/tree/main/skills/skill-hygiene
Command: npx skills add https://github.com/yknothing/skills-refiner --skill skill-hygiene-yknothing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit the health and governance of installed agent skills, helping teams detect stale, broken, or unsafe skills and improve topology visibility.

Core Features & Use Cases

  • Inventory canonical, symlinked, and native skills across agent directories.
  • Flag stale, backup remnants, broken symlinks, and risk indicators; provide remediation guidance.
  • Generate governance-ready metrics and provenance signals for dashboards.

Quick Start

Run the hygiene scan to produce a report and interpret results.

Frequently Asked Questions about skill-hygiene

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

FAQPage Schema
How do I audit the health of installed agent skills?

To audit installed agent skills, run a hygiene scan to inventory canonical, symlinked, and native sources. The scan identifies broken references, stale skills, and provenance anomalies, producing structured metrics and risk indicators suitable for governance dashboards.

What is skill topology visibility and why do I need it?

Skill topology visibility maps the relationships and sources of installed skills across canonical, symlinked, and native directories. You need it to detect topology blind spots, identify risky or stale skills, and ensure operational continuity across agent environments.

How do I detect broken symlinks and stale skills in my agent directories?

Detect broken symlinks and stale skills by running an automated hygiene scan across your agent directories. The scan flags backup remnants and broken references while preserving safe configurations, providing remediation guidance to fix the identified issues.

Can I export agent skill governance metrics to JSON?

Yes, you can export agent skill governance metrics to JSON. The hygiene scan produces structured metrics, risk indicators, and provenance signals specifically designed for JSON-based analysis and integration with governance dashboards.

What is the best way to track provenance anomalies for agent skills?

The best way to track provenance anomalies is to run a governance scan that audits installed skills across all source types. This generates provenance signals and risk indicators, allowing you to monitor health and detect unsafe skills for governance dashboards.

Does the skill hygiene scan preserve safe configurations when remediating risks?

Yes, the skill hygiene scan preserves safe configurations and operational continuity when remediating risks. It flags stale, broken, or risky skills and provides targeted remediation guidance without disrupting valid symlinked or canonical skill setups.