mcpField
R
repo-maintenance

repo-maintenance

github.com/igorwarzochaTesting & quality122116 installsUpdated 38w ago
Repository

About repo-maintenance

repo-maintenance is a repository upkeep skill for validating configuration files and reviewing whether documentation matches the repository inventory. Its audit workflow requires inspecting reported files and getting approval before applying fixes.

Key features

  1. 01Validate agent, command, and skill configurations
  2. 02Audit repository documentation inventory
  3. 03Consult validation rules
  4. 04Require approval before fixes

Use cases

  1. 01Check repository configuration after changes
  2. 02Assess whether documentation needs updating

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/igorwarzocha/opencode-workflows --skill repo-maintenance

After installing, type/repo-maintenancein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
maintenance-standards.md
validation-rules.md
scripts/
audit_repo.py
sync_docs.py

Details

From the project README

Repository Maintenance Skill

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

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:

  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.

Standards

Refer to references/validation-rules.md for:

  • YAML Frontmatter Schema
  • Description patterns (agents, commands, skills)
  • RFC+XML compliance requirements
  • Post-audit workflow details

Comments

Markdown supported