skills.rest
otahontas
otahontasCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

agents-md-improver

Analyze AGENTS.md files and propose quality improvements across repositories.

1|Updated Jan 2, 2020
Search Tags:#documentation#audit#repository#quality#update#agents.md#report
One-click install
npx skills add https://github.com/otahontas/nix --skill agents-md-improver
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agents-md-improver
Source: https://github.com/otahontas/nix/tree/main/home/configs/pi-coding-agent/skills/agents-md-improver
Command: npx skills add https://github.com/otahontas/nix --skill agents-md-improver

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps teams maintain up-to-date, contextual project documentation by auditing and enhancing AGENTS.md files across repositories.

Core Features & Use Cases

  • Discover all AGENTS.md locations (project root, package-specific, and nested directories) for review.
  • Assess each AGENTS.md against established quality rubrics, identify gaps, and propose targeted improvements.
  • Apply guarded updates to AGENTS.md files after user approval to ensure consistency and clarity.

Quick Start

  • Run the skill in your repository to generate a quality report.
  • Review the suggested changes and approve updates to AGENTS.md files.

Frequently Asked Questions about agents-md-improver

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

FAQPage Schema
How do I audit AGENTS.md files across a repository for documentation quality?▼

To audit AGENTS.md documentation quality, run this skill to discover all project-root, package-specific, and nested files, assess them against quality rubrics, and generate a structured quality report.

What is the best way to improve project context documentation in multiple AGENTS.md files?▼

Improving project context documentation involves assessing existing AGENTS.md files against a structured template, identifying gaps, proposing targeted improvements, and applying guarded updates after user approval.

Can I automatically update AGENTS.md files without manually reviewing the changes?▼

You cannot automatically update AGENTS.md files blindly; the skill enforces guarded updates that require explicit user approval before applying any proposed changes to ensure consistency and clarity.

How do I find all AGENTS.md locations including nested directories in my repository?▼

Finding all AGENTS.md locations requires running the skill in your repository, which discovers project-root, package-specific, and nested directory files to ensure complete documentation coverage.

Does the AGENTS.md audit work with package-specific documentation in monorepos?▼

Yes, the AGENTS.md audit works with monorepos by discovering and assessing package-specific files alongside project-root files, ensuring all nested documentation meets established quality rubrics.

Related Skills

Explore More Content & Communication Skills→
samjhechtsamjhecht
4

initialize-governance

Generate Constitution, Roadmap, and process documentation templates for project governance.

Community
Advanced
angrybeaglesangrybeagles

claude-md-improver

Audit CLAUDE.md files across a codebase and generate a structured quality report.

Community
Advanced
gcudergcuder
3

harness-generator

Generate agent harnesses with linters, style enforcement, and plan gates.

Community
Advanced
anthony-chaudharyanthony-chaudhary
30

quality-report

Analyze repository structure and documentation to generate a quality assessment report.

Community
Basic