repo-maintenance

Audit repository configuration files and synchronize documentation using Python scripts.

124|12|Updated Nov 17, 2025
One-click install
npx skills add https://github.com/IgorWarzocha/Opencode-Workflows --skill repo-maintenance-igorwarzocha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-maintenance
Source: https://github.com/IgorWarzocha/Opencode-Workflows/tree/main/.opencode/skill/repo-maintenance
Command: npx skills add https://github.com/IgorWarzocha/Opencode-Workflows --skill repo-maintenance-igorwarzocha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps maintain the integrity and documentation of a code repository by auditing its structure, validating configurations, and ensuring documentation is synchronized with the codebase.

Core Features & Use Cases

  • Repository Auditing: Validates configuration files (agents, commands, skills) for correctness and adherence to standards.
  • Documentation Sync: Reports on repository inventory and suggests when documentation needs updating.
  • Use Case: Before merging a new feature, run the repository audit to catch any configuration errors or outdated documentation, ensuring the repository remains clean and well-documented.

Quick Start

Use the repo maintenance skill to validate the repository.

Frequently Asked Questions about repo-maintenance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate YAML frontmatter and repository configuration files?

You can validate YAML frontmatter and configuration files by running Python scripts that audit repository structure, checking agents, commands, and skills for correctness against defined standards. This automated validation catches configuration errors before merging new features.

What's the best way to keep repository documentation synchronized with the codebase?

To keep repository documentation synchronized, use git diff analysis to report on repository inventory and suggest when READMEs need updating. This ensures documentation stays aligned with the actual code structure across all components.

Can I audit repository structure for consistent code compliance before a merge?

Yes, you can audit repository structure for compliance before merging by running validation scripts that check configuration files for correctness and adherence to standards. This ensures agents, commands, and skills maintain consistent structure.

Does Python need to be installed to run repository validation scripts?

Python is required to run the validation scripts that audit repository documentation and configuration files. The scripts utilize Python for file validation and git diff analysis to ensure compliance with defined standards.

When should I run a repository maintenance audit?

You should run a repository maintenance audit before merging a new feature to catch configuration errors or outdated documentation. This ensures the repository remains clean, well-documented, and structurally consistent across all components.

Why does repository documentation become outdated after code changes?

Repository documentation becomes outdated when code changes are not reflected in READMEs and configuration files. Git diff analysis identifies these discrepancies by comparing repository inventory against existing documentation to suggest necessary updates.