updating-agent-rules

Update AGENTS.md to reflect current repository configuration and tooling.

Updated Jan 31, 2026

Search Tags:#workflow #documentation #consistency #agents #update #references

Ready to run

npx skills add https://github.com/23prime/agent-skills --skill updating-agent-rules

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: updating-agent-rules
Source: https://github.com/23prime/agent-skills/tree/main/skills/updating-agent-rules
Command: npx skills add https://github.com/23prime/agent-skills --skill updating-agent-rules

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Update AGENTS.md to reflect the current repository state when repository configuration, structure, or tooling changes, ensuring accurate agent rules documentation.

Core Features & Use Cases

Gather current state from files like AGENTS.md, pyproject.toml, mise.toml, lefthook.yml, and README.md.
Identify deltas between AGENTS.md and the gathered state, and apply coherent updates.
Verify that files referencing AGENTS.md remain correct, including CLAUDE.md and .github/copilot-instructions.md.

Quick Start

Run the update to align AGENTS.md with the latest repository changes.

Frequently Asked Questions about updating-agent-rules

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

FAQPage Schema

How do I keep AGENTS.md in sync after changing repo configuration and tooling?▼

To keep AGENTS.md in sync, gather the current repository state from files like pyproject.toml and lefthook.yml, identify deltas against the existing documentation, and apply coherent updates to align agent rules with the latest structural changes.

When do I need to update agent rules documentation in my repository?▼

You need to update agent rules documentation when project configuration, tooling, or structural files change, ensuring AGENTS.md accurately reflects the current repository state and maintains consistent frontmatter and section layout.

Can I use this to validate references between AGENTS.md and copilot-instructions.md?▼

Yes, this validates references to external files by verifying that files referencing AGENTS.md, including CLAUDE.md and .github/copilot-instructions.md, remain correct and point to valid documentation paths after repository updates.

What's the best way to maintain consistency across multiple agent instruction files?▼

The best way to maintain consistency is to enforce frontmatter presence, ensure a consistent section layout within AGENTS.md, and automatically verify that downstream referenced docs like CLAUDE.md stay aligned with the updated repository configuration.

Does updating AGENTS.md work with configuration sources like mise.toml and pyproject.toml?▼

Yes, updating AGENTS.md works with configuration sources like mise.toml, pyproject.toml, lefthook.yml, and README.md by gathering their current state to identify deltas and apply coherent documentation updates across the repository.

Why does AGENTS.md frontmatter presence matter when updating repo documentation?▼

AGENTS.md frontmatter presence matters because it enforces a consistent section layout and structural validation, ensuring automated agent rules documentation remains parseable and correctly formatted after repository configuration changes.