maintain-project-agents

What problem does it solve?

Repositories often lack a consistent, machine-checkable AGENTS.md structure which leads to unclear maintainer guidance, placeholder content, malformed command examples, and weak safety boundaries; this Skill provides a deterministic way to find and surface those issues and to apply bounded, template-backed fixes when requested.

Core Features & Use Cases

• Deterministic Schema Validation: Validates top-level sections and required subsections against a YAML-backed canonical schema and flags missing or non-canonical headings.
• Bounded Apply Mode: Creates a missing AGENTS.md from a bundled template or normalizes the document while keeping edits strictly limited to the target file.
• Workflow and Safety Checks: Detects placeholder text, thin routing guidance, malformed or empty command blocks, and thin safety guidance and emits structured issues.
• Audit Reporting: Produces both JSON and human-readable Markdown reports with a clear output contract for automation and manual review.
• Use Case: Run during repository maintenance, CI checks, or a maintainer review to enforce durable, scan-friendly AGENTS.md guidance across projects.

Quick Start

Run the tool with the repository root and set run-mode to check-only to audit or to apply to normalize the AGENTS.md file.