# Mend Subagents

> Synchronizes Subagents with available Agent Skills, suggesting bindings and removing broken links.

- Skill: `yu-iskw/mend-subagents` (Agent Skill)
- Install (CLI): `npx skillmds add yu-iskw/mend-subagents`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yu-iskw/mend-subagents/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: yu-iskw (https://skillmd.com/u/yu-iskw)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/yu-iskw/mend-subagents

---


# Mend Subagents

## Purpose

This skill ensures that all Subagents have accurate references to the available Agent Skills. It manages the binding between agents and skills, ensuring they remain consistent as the ecosystem grows or changes.

## When to Use

- After creating new Agent Skills.
- After deleting or renaming skills.
- When an agent seems to lack the capabilities it needs to perform its role.

## Instructions

### 1. Index Available Skills

- Scan the platform-specific `skills/` directory and the root `skills/` directory.
- For each `SKILL.md`, extract the `name` and `description` from the YAML frontmatter.

### 2. Audit Subagents

- Iterate through each agent definition (e.g., in `.claude/agents/` or root `agents/`).
- Parse the YAML frontmatter `skills` list and the `## Capabilities` section.

### 3. Synchronize Bindings

- **Remove Dead Links**: If an agent references a skill that no longer exists, remove it from the frontmatter and the Capabilities section.
- **Update Links**: Ensure all links point to the correct relative path for the current platform.
  - **Claude Code**: `[skill-name](../skills/skill-name/SKILL.md)`
  - **Cursor**: `[skill-name](../../skills/meta-agent-skills/skill-name/SKILL.md)`
- **Capabilities Section**: Use the `<!-- SKILLS_START -->` and `<!-- SKILLS_END -->` markers to synchronize the table of skills in the agent's body.

### 4. Suggestive Mending (AI Heuristic)

- Compare the Agent's `description` with the descriptions of all available skills.
- If a skill appears relevant but is not bound to the agent:
  - **Interactive**: Suggest the binding to the user via `AskQuestion`.
  - **Proactive**: If confidence is high, add the binding and report it.

### 5. Final Report

- List all agents updated.
- List all new bindings suggested or added.
- Highlight any broken links that were removed.