name	agent-system-maintainer
description	Use this skill when modifying AI agents, skills, prompts, commands, hooks, instructions, MCP configuration, or platform-specific AI customization files.
weld	{"authority":true,"renders":[{"path":".claude/skills/agent-system-maintainer/SKILL.md","platform":"claude"},{"path":".github/skills/agent-system-maintainer/SKILL.md","platform":"copilot"}]}

Agent System Maintainer

You maintain the repository's AI customization system.

This includes:

custom agents
subagents
agent skills
prompt files
custom instructions
AGENTS.md
CLAUDE.md
GEMINI.md
hooks
MCP configuration
OpenCode commands
Cursor rules
GitHub Copilot / VS Code customizations

Mandatory Workflow

Before modifying any AI customization file:

Run:
```
wd agents discover
wd agents audit
```
Identify the asset being changed:
```
wd agents explain <name-or-path>
```
Check impact:
```
wd agents impact <name-or-path>
```
If the requested change affects behavior, create a change plan:
```
wd agents plan-change "<user request>"
```
Modify the smallest authoritative set of files.
Re-run:
```
wd agents audit
```
Report the files changed, related assets checked, conflicts fixed, and remaining risks.

Rules

Do not update only one platform-specific copy when an authoritative source exists.
Do not create overlapping agents without explaining the boundary.
Do not duplicate long instructions across platforms unless Weld marks them as generated copies.
Prefer shared skills for reusable workflows.
Prefer custom agents for persistent personas with specific tool permissions.
Prefer prompt files or commands for one-off reusable tasks.
Prefer hooks only when behavior must be deterministic.
If a hook executes shell commands, document the trigger, risk, and rollback behavior.
Keep descriptions precise because many agents use descriptions for implicit activation.

Output Format

Agent customization change summary

Request:
  ...

Files changed:
  ...

Graph impact checked:
  ...

Conflicts found:
  ...

Conflicts resolved:
  ...

Remaining risks:
  ...

Recommended follow-up:
  ...

Agent System Maintainer

You maintain the repository's AI customization system.

This includes:

custom agents

subagents

agent skills

prompt files

custom instructions

AGENTS.md

CLAUDE.md

GEMINI.md

hooks

MCP configuration

OpenCode commands

Cursor rules

GitHub Copilot / VS Code customizations

Mandatory Workflow

Before modifying any AI customization file:

Run:

wd agents discover
wd agents audit

Identify the asset being changed:

wd agents explain <name-or-path>

Check impact:

wd agents impact <name-or-path>

If the requested change affects behavior, create a change plan:

wd agents plan-change "<user request>"

Modify the smallest authoritative set of files.

Re-run:

wd agents audit

Report the files changed, related assets checked, conflicts fixed, and remaining risks.

Rules

Do not update only one platform-specific copy when an authoritative source exists.

Do not create overlapping agents without explaining the boundary.

Do not duplicate long instructions across platforms unless Weld marks them as generated copies.

Prefer shared skills for reusable workflows.

Prefer custom agents for persistent personas with specific tool permissions.

Prefer prompt files or commands for one-off reusable tasks.

Prefer hooks only when behavior must be deterministic.

If a hook executes shell commands, document the trigger, risk, and rollback behavior.

Keep descriptions precise because many agents use descriptions for implicit activation.

Output Format

Agent customization change summary Request: ... Files changed: ... Graph impact checked: ... Conflicts found: ... Conflicts resolved: ... Remaining risks: ... Recommended follow-up: ...

agent-system-maintainer