# Repo Maintenance

> Maintain repository integrity and documentation. Use for auditing structure, checking config validity, and reviewing inventory. Use proactively to validate the repository or sync documentation. Examples: - user: "Validate the repo" → run audit_repo.py - user: "Check agents" → run audit_repo.py, review errors - user: "Update documentation" → run sync_docs.py - user: "Check for issues" → run full audit

- Skill: `igorwarzocha/repo-maintenance` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add igorwarzocha/repo-maintenance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/igorwarzocha/repo-maintenance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: igorwarzocha (https://skillmd.com/u/igorwarzocha)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/igorwarzocha/repo-maintenance

---


# Repository Maintenance Skill

This skill provides the tools to act as a **Repo Custodian**.

<instructions>

## Validate Repository
Ensure configuration files (agents, commands, skills) are valid.
- Command: `python3 .opencode/skill/repo-maintenance/scripts/audit_repo.py`

## Sync Documentation
Report on repository inventory and suggest whether docs need updating.
- Command: `python3 .opencode/skill/repo-maintenance/scripts/sync_docs.py`

</instructions>

<workflow>

## After a Failed Audit
When the audit reports errors or warnings:

1. **Read affected files** - MUST read each file listed in the output
2. **Analyze issues** - Understand what changes would fix each issue
3. **Ask the user** - MUST use question tool to confirm which fixes to apply
4. **Apply selectively** - Only fix what the user approves

MUST NOT auto-fix all issues. Mass changes can break working configurations.

</workflow>

<reference>

## Standards
Refer to `references/validation-rules.md` for:
- YAML Frontmatter Schema
- Description patterns (agents, commands, skills)
- RFC+XML compliance requirements
- Post-audit workflow details

</reference>