Mend agent rules
Skill yu-iskw/meta-agent-skills/.claude/skills/mend-agent-rules
Standardized, portable AI agent skills that proactively bootstrap your codebase for autonomous development.
npx -y skills add yu-iskw/meta-agent-skills --skill mend-agent-rulesAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Synchronize CLAUDE.md and AGENTS.md with available agents and skills.
SKILL.md
3.0 KB, as published. Nobody here has run it
Mend Agent Rules
This skill automates the synchronization of CLAUDE.md and AGENTS.md using AI / LLM to ensure they always reflect the current state of the repository's agents and skills.
Purpose
To provide AI agents with up-to-date instructions and context about available specialized capabilities without manual maintenance.
Instructions
- Discovery: Scan the following directories and categorize them:
- Project Skills: All
SKILL.mdfiles in.claude/skills/(recursive). - Agents: Agent definitions or metadata in
.claude/agents/.
- Project Skills: All
- Extraction: For each skill/agent found, extract:
name: From YAML frontmatter or directory name.description: From YAML frontmatter or first paragraph.path: Relative path from the workspace root.
- Target Identification: Identify documentation files and their respective markers:
- CLAUDE.md and AGENTS.md:
<!-- AVAILABLE_SKILLS_START -->and<!-- AVAILABLE_SKILLS_END --><!-- AVAILABLE_AGENTS_START -->and<!-- AVAILABLE_AGENTS_END --><!-- FRAMEWORK_DOCS_START -->and<!-- FRAMEWORK_DOCS_END -->
- CLAUDE.md and AGENTS.md:
- Formatting:
- Skills List: Generate a table of all discovered project skills.
- Agents List: Generate a table of discovered agents.
- Synchronization: Replace the content between the specific markers in BOTH target files.
- Update BOTH
CLAUDE.mdandAGENTS.mdwith the project skills table, agents table, and framework documentation. - CRITICAL: The framework documentation (explaining what Agent Skills are, directory structure, and guidelines) MUST be present in both files between the
FRAMEWORK_DOCSmarkers. If it is missing from one but present in the other, synchronize it.
- Update BOTH
- Verification: Confirm that both files are identical except for their top-level headers (
# CLAUDE.mdvs# AGENTS.md) and that all markers are preserved.
Markers
CLAUDE.md
<!-- AVAILABLE_SKILLS_START -->
<!-- AVAILABLE_SKILLS_END -->
<!-- AVAILABLE_AGENTS_START -->
<!-- AVAILABLE_AGENTS_END -->
<!-- FRAMEWORK_DOCS_START -->
<!-- FRAMEWORK_DOCS_END -->
AGENTS.md
<!-- AVAILABLE_SKILLS_START -->
<!-- AVAILABLE_SKILLS_END -->
<!-- AVAILABLE_AGENTS_START -->
<!-- AVAILABLE_AGENTS_END -->
<!-- FRAMEWORK_DOCS_START -->
<!-- FRAMEWORK_DOCS_END -->
Example Table Format
<!-- markdown-link-check-disable -->| Name | Description | Link |
|---|---|---|
| lint-fix | Iteratively run linters, apply auto-fixes, and resolve remaining issues. | .claude/skills/lint-fix/SKILL.md |
Gives 0 of the 12 instructions most memory context skills give
Counted across 674 of the 847 authors here whose files we hold, read 2026-08-06
- inform the user when setup is completein 21 of 674, across 6 files
- confirm the draft with the user before writingin 21 of 674, across 6 files
- update the agent skills block in place if it existsin 21 of 674, across 6 files
- present findings to the userin 20 of 674, across 5 files
- write the three docs files from seed templatesin 20 of 674, across 5 files
- ask the user about each decision one at a timein 19 of 674, across 4 files
- edit CLAUDE.md if it existsin 18 of 674, across 3 files
- explore current repo statein 18 of 674, across 3 files
- do not overwrite user edits to surrounding sectionsin 18 of 674, across 3 files
- back up the original file before overwritingin 16 of 674, across 8 files
- keep the memory index under 200 linesin 15 of 674
- Provide actionable steps and verificationin 13 of 674, across 2 files
Said here and by no other author read
- scan directories for skills and agents
- extract name, description, and path
- identify documentation markers
- generate a skills table
- generate an agents table
- replace content between markers in both files
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once.