chsh-sk-skill-maintain

Audits SKILL.md files for structural violations, dead links, duplication, and security issues.

1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/chshzh/claude --skill chsh-sk-skill-maintain-chshzh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chsh-sk-skill-maintain
Source: https://github.com/chshzh/claude/tree/main/skills/chsh-sk-skill-maintain
Command: npx skills add https://github.com/chshzh/claude --skill chsh-sk-skill-maintain-chshzh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Skill libraries accumulate structural drift over time: broken links, duplicated capabilities, stale content, missing index entries, and accidentally committed credentials. This Skill runs a systematic health audit across every SKILL.md file and produces a prioritized fix list. ## Core Features & Use Cases - Structural Compliance Checks: Validates YAML frontmatter, naming rules, description format, required sections (Gotchas, Self-Update Policy), and line-count thresholds against the authoring standard. - Link and Reference Integrity: Runs a Python dead-link scanner plus checks that index.md, cross-skill references, and backtick-referenced skill names all resolve on disk. - Security and Freshness Scan: Detects credential leaks, config.json files missing from .gitignore, deprecated commands, and outdated version strings. - Use Case: Run a scheduled daily audit of your ~/.claude/skills directory; the Skill compares the current git commit against the last audit, exits early if nothing changed, and otherwise generates a P0/P1/P2 report with optional approved auto-fixes. ## Quick Start Ask Claude to run the skill maintenance audit on your skills directory and generate a prioritized health report.

Frequently Asked Questions about chsh-sk-skill-maintain

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

FAQPage Schema
How do I audit Claude SKILL.md files for quality issues?

Run this skill against your ~/.claude/skills directory. It checks frontmatter structure, naming rules, description format, required sections, and line counts, then outputs a prioritized P0/P1/P2 report with suggested fixes.

How to find dead links in Markdown skill files?

Use the included scripts/check-deadlinks.py scanner. It extracts relative Markdown links from every SKILL.md, resolves them against each file's own directory, and separates real broken links from intentional code-block examples.

Does the audit run automatically on a schedule?

Yes, it is designed as a scheduled cloud routine. It compares the current git commit against the last audited commit and exits early with no report if the skills repo has not changed.

Can the audit fix issues automatically?

Fixes are applied only after explicit approval through an AskQuestion prompt. You can choose P0-only fixes, P0 plus P1 fixes, per-fix approval, or report-only mode, and all changes are committed together with a log entry.

What security problems does the skill audit detect?

It runs a credential-pattern security scan across all skill files and audits config.json files to verify they are listed in .gitignore. Credential leaks are flagged as P0 and must be fixed before the next commit.