What problem does it solve? GEMINI.md files often become stale, sparse, or filled with generic advice, leaving Gemini CLI without accurate project context. This Skill audits every GEMINI.md file in a repository, scores quality against a rubric, and applies targeted improvements after user approval. ## Core Features & Use Cases - Repository-wide discovery: Finds all GEMINI.md variants including project root, package-level, local overrides (.gemini.local.md), and global defaults (~/.gemini/GEMINI.md). - Scored quality report: Evaluates each file across six weighted criteria (commands, architecture, patterns, conciseness, currency, actionability) and assigns a 0-100 score with a letter grade. - Guided updates with diffs: Proposes minimal, project-specific additions shown as diffs, then applies them with the Edit tool only after user confirmation. - Use Case: After a major refactor, run the audit to find that build commands in your root GEMINI.md are outdated and package-level context is missing, then apply the suggested fixes. ## Quick Start Ask the agent to audit and improve all GEMINI.md files in this repository and show a quality report before making changes.
