refactor-agents-md

Installation
SKILL.md

Refactor AGENTS.md

Refactor an AGENTS.md for GPT-6 Astra. 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. Preserve the user's intended behavior and existing authorization.

Instructions

  1. Pick the target. Use the target named by the invocation or established in the conversation. If the target remains ambiguous, ask the user to choose among the files that exist:

    • The user-level file at $CODEX_HOME/AGENTS.md, defaulting to ~/.codex/AGENTS.md when CODEX_HOME is unset.
    • The current project's root AGENTS.md.
    • Any nested AGENTS.md on the path from the project root to the current working directory.
  2. Fetch the yardsticks. Fetch these pages to calibrate the audit. Use the GPT-6 Astra prompting guidance for model behavior and the AGENTS.md guide for organization; preserve explicit user choices where the guides offer defaults. If a source is unavailable, disclose the gap and continue with available evidence.

Installs
9
Repository
vinta/hal-9000
GitHub Stars
127
First Seen
Jul 15, 2026
refactor-agents-md — vinta/hal-9000