Maintain Agent Guidance
Maintain universal AGENTS.md guidance at the narrowest applicable scope through exact, approval-gated edits.
When to use
Section titled “When to use”Audit and update universal AGENTS.md guidance at the narrowest user, repository, nested, or private scope through exact approval-gated proposals.
Link this skill
Section titled “Link this skill”arcantry skills link maintain-agent-guidance --scope userThe standard destination is ~/.agents/skills. Codex reads this universal Agent Skills location directly.
Claude compatibility
Section titled “Claude compatibility”arcantry skills link maintain-agent-guidance --scope user --compat claudeThis keeps the universal link and adds a Claude alias to the same canonical package.
Learning outcomes
Section titled “Learning outcomes”- Choose the narrowest guidance scope that owns a recurring agent decision.
- Apply independently approved instruction changes without leaking private context.
Examples
Section titled “Examples”Fix a repository instruction gap
Section titled “Fix a repository instruction gap”Prompt
Use the maintain-agent-guidance skill to propose a durable repository rule for this repeated agent failure and wait for approval before editing.
Expected outcome
The user receives a minimal exact proposal targeted to the applicable AGENTS.md file.
Keep workstation guidance private
Section titled “Keep workstation guidance private”Prompt
Use the maintain-agent-guidance skill to record this machine-specific workflow without exposing it to repository contributors.
Expected outcome
The approved rule is placed in private local guidance and the Git exclusion is verified.