skill-maintenance

Guide skill updates after codebase changes with minimal-change principles.

15|3|Updated Apr 29, 2025
One-click install
npx skills add https://github.com/chaingraphlabs/chaingraph --skill skill-maintenance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-maintenance
Source: https://github.com/chaingraphlabs/chaingraph/tree/main/.claude/skills/skill-maintenance
Command: npx skills add https://github.com/chaingraphlabs/chaingraph --skill skill-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides structured guidance for when and how to update Claude Code skills after meaningful codebase changes, helping teams avoid unnecessary churn while ensuring skills stay aligned with evolving patterns and practices.

Core Features & Use Cases

  • Guidance framework for identifying affected skills after architectural changes, new patterns, anti-pattern discoveries, API changes, or security concerns.
  • Step-by-step update workflow, including how to decide whether to update, what to modify, and how to communicate changes.
  • Minimal-change philosophy that emphasizes small, traceable updates to the skill tree and clear documentation.

Quick Start

  1. Review recent codebase changes and list potential impacts on the skill tree.
  2. Determine which skills are affected and whether updates are required by the guidelines.
  3. Perform minimal, well-documented updates and update the skill-maintenance skill reference accordingly.

Frequently Asked Questions about skill-maintenance

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

FAQPage Schema
How do I update documentation guidelines after codebase changes?

Update documentation guidelines by reviewing architectural changes, new patterns, anti-pattern discoveries, API changes, and security concerns to determine affected skills. Apply minimal-change principles for small, traceable updates to maintain a stable skill tree.

When should I update my workflow after discovering anti-patterns?

Update your workflow when anti-pattern discoveries, architectural changes, or security concerns affect existing skills. Determine whether updates are required by the guidelines, then perform minimal, well-documented updates to the skill tree.

What is the best way to maintain a stable skill tree after API changes?

Maintain a stable skill tree after API changes by enforcing minimal-change principles and clear criteria for adding or deprecating skills. Determine which skills are affected and perform small, traceable updates with clear documentation.

How do I decide whether to update or deprecate skills after architectural changes?

Decide whether to update or deprecate skills by evaluating architectural changes against clear criteria. Determine which skills are affected, whether updates are required by the guidelines, and apply minimal-change principles for stable maintenance.

Does this skill-maintenance workflow require any dependencies?

No, this skill-maintenance workflow does not require any dependencies. It provides structured guidance for updating Claude Code skills after meaningful codebase changes without external components or modules.

Why does updating skills after codebase changes require a minimal-change approach?

Updating skills requires a minimal-change approach to avoid unnecessary churn while ensuring skills stay aligned with evolving patterns and practices. This philosophy emphasizes small, traceable updates and clear documentation for a stable skill tree.