Menu
Use when about to refactor or refine a user-level or project-level AGENTS.md
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/vinta/hal-9000 --skill refactor-agents-mdThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
| name | refactor-agents-md |
| description | Use when about to refactor or refine a user-level or project-level AGENTS.md |
| user-invocable | true |
Refactor an AGENTS.md. Every retained line enters each Codex session in its scope, so it must earn that attention. Move narrower guidance to the closest applicable scope or a reusable skill, and remove instructions that do not change behavior.
Pick the target. Use a target named by the invocation. Otherwise ask the user to choose among the files that exist:
$CODEX_HOME/AGENTS.md, defaulting to ~/.codex/AGENTS.md when CODEX_HOME is unset.AGENTS.md.AGENTS.md on the path from the project root to the current working directory.Fetch the yardsticks. Fetch these pages to calibrate the audit:
Audit. Read the target and applicable broader AGENTS.md files. Give every instruction in the target exactly one verdict against the target's bar below. Finish only when every instruction has a verdict.
AGENTS.md; put a multi-step task workflow in a skill; put reference material in a linked document.Apply the bar for the target:
AGENTS.md, and task workflows to skills.AGENTS.md, a linked document, or a skill.Get decisions. Ask the user to resolve each contradiction. Then present the delete and demote lists, including every proposed destination, for sign-off. Leave all files untouched until the user signs off.
Rewrite. Apply the signed-off verdicts in one pass. Place each new nested AGENTS.md in the nearest directory whose whole subtree shares its guidance. Finish only when every audited instruction is kept, rewritten, demoted to its named destination, or deleted as approved.