| name | improve-instructions |
| description | Use this skill when the user asks to improve agent instructions, update Claude or Codex guidance, review drift in AGENTS.md or .claude files, or keep the repo guidance aligned with how the project actually evolves. |
Improve Instructions
Use this skill to propose improvements to repository instruction files in a continuous-improvement workflow.
Read first:
AGENTS.md
CLAUDE.md
.claude/rules/architecture.md
.claude/rules/testing.md
.claude/rules/security.md
Read as needed:
.claude/patterns.md
.claude/commands/symfony/*.md
.claude/skills/*/SKILL.md
Makefile
composer.json
frontend/package.json
README.md
Workflow:
- Inspect the repository and current guidance.
- Identify durable drift between the codebase, workflows, and instruction files.
- Keep only reusable improvements, not one-off comments or temporary context.
- Propose exact updates for
AGENTS.md, .claude/rules, .claude/patterns.md, commands, or skills.
- Present the proposed patch and rationale.
- Ask for confirmation before applying any edit.
Rules:
- Never edit instruction files silently.
- Treat
AGENTS.md as the canonical project-specific source of truth.
- Keep
CLAUDE.md as a pointer only.
- Avoid adding project noise or temporary guidance to shared instruction files.
- Keep commands and skills aligned when a workflow exists in both forms.