Self-Update Meta Skill

Purpose: Automatically update the AGENTS.md system when its components change. Keeps routing tables, README files, and documentation in sync.

Trigger

When: Any agent, skill, or instruction file is created, modified, or deleted Context Needed: Changed file, change type, current system state MCP Tools: read_file, replace_string_in_file, list_dir

Watched Paths

| Path | Component Type | Updates | | :--------------------------------------- | :------------- | :---------------------------------- | | .github/agents/*.agent.md | Subagent | AGENTS.md routing, agents/README.md | | .github/skills/*/skill.md | Skill | skills/README.md, trigger tables | | .github/instructions/*.instructions.md | Instruction | instructions/README.md | | docs/templates/*.md | Template | Documentation workflow |

Update Chains

New Agent Added

Security.agent.md created
    ↓
1. Update agents/README.md (add to table)
2. Update AGENTS.md (add routing keywords)
3. Update copilot-instructions.md (if major)

New Skill Added

new-skill/skill.md created
    ↓
1. Update skills/README.md (add to table)
2. Update trigger events table
3. Link to relevant agents

Agent Modified

Backend.agent.md modified
    ↓
1. Check if keywords changed → update AGENTS.md
2. Check if tools changed → update README MCP section
3. Bump version in agent file

Auto-Update Fields

In Agent/Skill Files

version: "1.0.0" # Bump on changes
last_updated: "YYYY-MM-DD" # Set to today

In README Files

| Agent | File | Domain | Primary MCP Tools |

# Re-scan directory and rebuild table

In AGENTS.md

## Agent Routing

| Keywords | Route To |

# Re-scan agent keywords and rebuild

Version Bumping Rules

Consistency Checks

After any update:

[ ] All agents in README table
[ ] All skills in README table
[ ] AGENTS.md routing matches agent keywords
[ ] No duplicate agent_ids or skill_ids
[ ] All file references resolve

Changelog Maintenance

When system changes, add to AGENTS.md changelog:

## Change Log

| Version | Date       | Changes                                                        |
| :------ | :--------- | :------------------------------------------------------------- |
| 4.0.0   | 2026-01-26 | Added @Security, @DataArchitect, @SyncEngineer, @DevOps agents |

Workflow

Detect change - What file changed?
Parse metadata - Read YAML frontmatter
Identify updates - What else needs changing?
Apply updates - Modify affected files
Validate - Run consistency checks
Report - List all changes made

Output Report

{
  "trigger": "Security.agent.md created",
  "updates": [
    { "file": "agents/README.md", "action": "add_row" },
    { "file": "AGENTS.md", "action": "add_routing" },
    { "file": "copilot-instructions.md", "action": "add_to_mcp_table" }
  ],
  "validation": "passed"
}

self-update