repo-maintenance

Original：🇺🇸 English
Translated
2 scripts

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

8installs
Sourceigorwarzocha/opencode-workflows
Added on

NPX Install

npx skill4agent add igorwarzocha/opencode-workflows repo-maintenance

Tags

Translated version includes tags in frontmatter
repo-maintenanceconfig-validationdocumentation-syncaudit-automationrepo-custodian

SKILL.md Content

View Translation Comparison →

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>