Refresh project conventions by comparing AGENTS.md and explicitly selected host-specific rules with objective repository state, then applying authorized drift fixes.
Installs into .claude/skills of the current project.
Are you the author of Agents Md Revise?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/shrekshrek-agents-md-revise)
---
name: agents-md-revise
description: Refresh project conventions by comparing AGENTS.md and explicitly selected host-specific rules with objective repository state, then applying authorized drift fixes.
---
# Agents.md Revise
Match the user's language. Read `${CLAUDE_PLUGIN_ROOT}/docs/actions/agents-md-revise.md` completely before acting; it owns the portable workflow and contract.
Claude execution details:
- Parse `$ARGUMENTS` as an optional scope. Root/applicable nested `AGENTS.md` are the default; include `.claude/rules/` only when the user explicitly selects them.
- Use Read/Grep/Glob/Bash for evidence. Missing `AGENTS.md` redirects to `/project-workflow:project-personalize`.
- Use inline trace for sourced synchronization; dispatch a fresh `decision-completeness-auditor` only at its narrowed canonical boundary, with fallback under the shared execution contract. Blocking or unreliable audit evidence prevents apply.
- Ask only for material ambiguity or new policy; do not reconfirm objective stale-value synchronization item by item.
- Run the canonical Guidance Placement audit and apply only evidence-backed placement changes.
- Apply only convention edits authorized by the current request or an explicit follow-up decision. Do not edit
product specs, implementation code, or commit.
Report applied/skipped drift, evidence, applicable audit execution/results, and unresolved questions.
