skills.rest
euxx
euxxCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

conventions-improver

Audit and improve AGENTS.md, CLAUDE.md, and GEMINI.md files with user approval.

4|Updated Mar 13, 2026
Search Tags:#ai agents#conventions#project context#claude-md#codebase audit#agents-md#gemini-md
One-click install
npx skills add https://github.com/euxx/claude-skills-for-copilot --skill conventions-improver
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: conventions-improver
Source: https://github.com/euxx/claude-skills-for-copilot/tree/main/skills/conventions-improver
Command: npx skills add https://github.com/euxx/claude-skills-for-copilot --skill conventions-improver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps keep AI-facing conventions files accurate, useful, and easy to follow by finding them, evaluating their quality, and improving them with approval.

Core Features & Use Cases

  • Discovery: Finds AGENTS.md, CLAUDE.md, and GEMINI.md files across a repository, including nested locations.
  • Quality Review: Scores each file for commands, architecture clarity, non-obvious patterns, conciseness, currency, and actionability.
  • Targeted Improvement: Produces a report first, then applies focused updates only after user confirmation.
  • Use Case: Use it when a project has outdated or weak AI instructions and you want a concise, practical conventions file for future coding sessions.

Quick Start

Ask me to audit the repository’s conventions files and improve them after I show you the quality report.

Frequently Asked Questions about conventions-improver

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

FAQPage Schema
How do I audit and improve AI agent conventions files in my repository?▼

To audit AI agent conventions files, this Skill scans your repository for AGENTS.md, CLAUDE.md, and GEMINI.md files, scores them against a rubric, and generates a quality report before applying targeted edits with your approval.

What makes a good CLAUDE.md or AGENTS.md file for coding agents?▼

A good conventions file for coding agents scores well on architecture clarity, actionability, non-obvious patterns, conciseness, and currency. This Skill evaluates these criteria to ensure AI instructions remain accurate and easy to follow.

How do I find outdated AI instructions across a project codebase?▼

Finding outdated AI instructions requires scanning nested repository locations for conventions files like GEMINI.md. This Skill discovers these files and evaluates their currency to identify weak or stale project context for AI agents.

Can I review changes before this Skill updates my project conventions files?▼

Yes, you can review changes before updates. This Skill produces a quality report first, then applies focused improvements to your conventions files only after you explicitly confirm and approve the suggested edits.

Does the conventions audit support discovering nested AGENTS.md files?▼

Yes, the conventions audit supports discovering nested AGENTS.md files. It scans across the entire repository structure, including nested directories, to find and evaluate all AI-facing conventions files for your codebase.

Related Skills

Explore More Software Engineering Skills→
yigitkonuryigitkonur
11

init-agent-config

Generate and audit AGENTS.md and CLAUDE.md files from repository inspection.

Community
Advanced
fazxesfazxes
231

claude-md-improver

Identifies CLAUDE.md files in a repository and generates quality reports with proposed improvements.

Community
Advanced
sammcjsammcj
155

claude-md-authoring

Create CLAUDE.md files with XML-style sections documenting non-obvious codebase context.

Community
Basic
romiluz13romiluz13
5

claude-code-excellence-audit

Audit Claude Code configurations and generate a 0–100 score with fixes.

Community
Advanced