agent-instructions

What problem does it solve?

This skill helps maintain high-quality agent instruction files by capturing non-obvious operational knowledge and ensuring instruction docs stay discoverable, auditable, and aligned with project conventions.

Core Features & Use Cases

• Audit and identify gaps in AGENTS.md, COPILOT instructions, per-path guides, and routing files.
• Apply the Discoverability Filter to determine what non-discoverable but high-impact knowledge should be documented.
• Create or update instruction files for a repository, split oversized guides, and align with tooling and governance patterns.
• Validate instruction files against the repository state to reduce duplication and maintenance burden.

Quick Start

Audit existing instruction files and create or update a focused per-path instruction file using the Discoverability Filter.