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
How do I install this agent skill?
npx skills add https://github.com/igorwarzocha/opencode-workflows --skill repo-maintenanceIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides utilities for auditing repository structure and syncing documentation. It validates YAML frontmatter, RFC compliance, and XML tags in markdown files using local Python scripts. While it executes git commands and processes repository content, it includes mandatory human-in-the-loop checkpoints before any changes are applied.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
5 files scanned · No issues
What does this agent skill do?
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
After a Failed Audit
When the audit reports errors or warnings:
- Read affected files - MUST read each file listed in the output
- Analyze issues - Understand what changes would fix each issue
- Ask the user - MUST use question tool to confirm which fixes to apply
- 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/igorwarzocha/opencode-workflows/repo-maintenance">View repo-maintenance on skillZs</a>