agents-md-maintenance

Organize AGENTS.md and CLAUDE.md files into entry and local detail documents.

7|1|Updated May 9, 2026
One-click install
npx skills add https://github.com/black-yt/skills --skill agents-md-maintenance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-md-maintenance
Source: https://github.com/black-yt/skills/tree/main/agents-md-maintenance
Command: npx skills add https://github.com/black-yt/skills --skill agents-md-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you create, split, and maintain repository agent instructions such as AGENTS.md, CLAUDE.md, and their local companion files without losing important rules or exposing sensitive information.

Core Features & Use Cases

  • Maintain default-loaded guidance: Keep always-read instructions short, stable, and focused on project-wide context, safety boundaries, and key maintenance rules.
  • Split low-frequency details: Move long workflows, command examples, and task-specific notes into AGENTS.local or equivalent companion files so the main entry stays readable.
  • Preserve safe editing and sync practices: Protect secrets, respect public/private repository differences, and verify navigation tables, file paths, and git status before updating docs.

Quick Start

Update the repository’s agent instruction files with the right split between always-loaded guidance and local detail docs, then verify that the navigation table, paths, and safety rules are still accurate.

Frequently Asked Questions about agents-md-maintenance

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

FAQPage Schema
How do I maintain AGENTS.md files without exposing sensitive project information?

To maintain AGENTS.md without exposing sensitive data, keep always-loaded guidance short and focused on safety boundaries, move detailed workflows to local companion files, and verify git status before updating documentation.

What is the best way to organize CLAUDE.md and local detail files for coding agents?

Organizing CLAUDE.md involves keeping default-loaded instructions short and stable for project-wide context, while splitting low-frequency details like command examples into AGENTS.local companion files to keep the main entry readable.

How does splitting repository agent instructions into local companion files work?

Splitting repository agent instructions works by moving long workflows, command examples, and task-specific notes into AGENTS.local files, ensuring the main entry document remains stable, readable, and focused on mandatory guidance.

Can I use AGENTS.md maintenance workflows for both public and private repositories?

Yes, AGENTS.md maintenance workflows apply to both public and private repositories, but require strict preservation of safety boundaries, respecting public and private differences to protect secrets and ensure non-sensitive project context.

Why should I verify navigation tables and file paths when updating repository docs?

Verify navigation tables and file paths when updating repository docs to ensure navigation accuracy and sync discipline, preventing broken references and maintaining reliable guidance for coding agents across the documentation workflow.