Agent Config Maintenance

agent-config-maintenance

Refactor Codex configuration files and Agent Skills by splitting concerns, deduplicating instructions, and reorganizing guidance across AGENTS.md, project docs, and skills. Use when asked to clean up AGENTS.md, move instructions into skill bundles, or standardize agent setup rules.

majiayu000/claude-skill-registry·0installs663starsProductivity & Planning

SKILL.md

Full skill instructions

Agent Config Maintenance

Scope

Target files: AGENTS.md, project-doc sections, skills/*/SKILL.md, and any references under skills/*/references/.
Focus on separation of concerns: global agent rules vs task-specific workflows.

Workflow

Inventory instructions
- Use rg to find duplicate or conflicting rules across AGENTS, project docs, and skills.
- Note which rules are global constraints vs task-specific procedures.
Decide the split
- Keep only global, always-on constraints in AGENTS.md.
- Move task-specific procedures into the relevant skill SKILL.md or references/.
- Remove duplicated bullets after moving.
Update skill metadata
- Fill SKILL.md frontmatter with name and a trigger-ready description.
- Keep the description explicit about when to use the skill.
Write the skill body
- Use imperative form.
- Keep core workflow in SKILL.md.
- Move large checklists or detailed examples into references/ and link them.
Validate consistency
- Ensure AGENTS and skills do not contradict each other.
- Verify naming conventions (lowercase + hyphen).
- Confirm only necessary files exist; avoid extra docs.

Quality gates

Keep SKILL.md under 500 lines.
Avoid duplication between SKILL.md and any reference files.
If adding scripts, run them once to validate behavior.

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/majiayu000/claude-skill-registry --skill agent-config-maintenance

View on GitHub

skills/data/agent-config-maintenance/SKILL.md

More Productivity & Planning skills

View all

Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K

View

Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K

View

Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K

View

Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K

View

Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K

View

Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K

View

Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K

View

Productivity & Planning

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K

View