skill-maintainer

Audit local skills trees for inconsistencies and broken references.

1|Updated Aug 26, 2025
One-click install
npx skills add https://github.com/PlaneInABottle/configs --skill skill-maintainer-planeinabottle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-maintainer
Source: https://github.com/PlaneInABottle/configs/tree/main/agents/.agents/skills/skill-maintainer
Command: npx skills add https://github.com/PlaneInABottle/configs --skill skill-maintainer-planeinabottle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Audit, improve, split, deduplicate, and validate repository skills. Use when the task is to inspect a local skills tree, find contradictory guidance, detect broken skill references, decide whether a skill should be split or kept unified, or standardize repository skill quality before handing creation/package mechanics to skill-creator.

Core Features & Use Cases

  • Inventory the active skills tree and surface deterministic structural issues.
  • Run the included audit script to catch reference and boundary problems.
  • Verify important claims against shipped files, validator output, and reproducible local commands; mark them as verified, contradicted, or unverified.
  • When session work confirms, contradicts, or narrows existing guidance, update the affected skill with the smallest evidence-backed change that makes the next run more accurate.
  • Use real session evidence to decide whether guidance should be corrected, narrowed, or expanded.
  • Decide whether each issue needs a fix in place, a split, deduplication, or escalation.
  • Hand off mechanical skill authoring or packaging work to skill-creator at ../skill-creator/SKILL.md.

Quick Start

Run the audit script to inventory the skills tree and surface issues.

Frequently Asked Questions about skill-maintainer

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

FAQPage Schema
How do I audit a local skills tree to find broken references and governance gaps?

Run an audit script to inventory your skills tree, which surfaces deterministic structural issues, detects broken references, and identifies governance gaps across your repository before packaging.

How do I decide whether to split or unify repository skills?

Decide whether to split or unify skills by using real session evidence and reference baselines to evaluate contradictory guidance, deduplicate overlapping boundaries, and determine if guidance needs correction, narrowing, or expansion.

What is the best way to validate skill claims against shipped files?

Verify important claims against shipped files, validator output, and reproducible local commands, marking each claim as verified, contradicted, or unverified based on the evidence gathered.

Can I use this skill to standardize repository skill quality before packaging?

Yes, standardize repository skill quality by running the audit checklist and reference baselines to catch reference and boundary problems, then handing off mechanical skill authoring and packaging work to skill-creator.

How do I update a skill when session work contradicts existing guidance?

Update the affected skill with the smallest evidence-backed change that makes the next run more accurate, using real session evidence to correct, narrow, or expand existing guidance based on verified outcomes.