skills.rest
iimuz
iimuzCOMMUNITY
Explore all skills by this author →
GitHub

refactor-agents

Analyzes AGENTS.md against repository state and generates a structured comparison report highlighting suggested edits.

3|1|Updated Aug 22, 2015
Search Tags:#workflow#documentation#analysis#reporting#comparison#agents.md#git-repo
One-click install
npx skills add https://github.com/iimuz/dotfiles --skill refactor-agents
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refactor-agents
Source: https://github.com/iimuz/dotfiles/tree/main/.config/copilot/skills/refactor-agents
Command: npx skills add https://github.com/iimuz/dotfiles --skill refactor-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Align AGENTS.md with the current repository state by performing a thorough analysis, surfacing drift, and proposing concrete updates for user review.

Core Features & Use Cases

  • Comprehensive repository analysis and AGENTS.md comparison to identify inconsistencies between documentation and codebase.
  • Generation of a structured, reviewable report that captures discrepancies and suggested edits.
  • Interactive approval workflow to apply only approved changes with clear traceability.

Quick Start

Analyze AGENTS.md against the repository state to generate a comparison report for review and approval.

Frequently Asked Questions about refactor-agents

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

FAQPage Schema
How do I check if my AGENTS.md documentation is outdated compared to my git repo?▼

To validate AGENTS.md accuracy, analyze the git repository state and compare it against the documentation to generate a structured report highlighting inconsistencies and drift across architecture and directory structure.

What is the best way to update AGENTS.md when the project architecture changes?▼

The best way to update AGENTS.md after architecture changes is to generate a comparison report that validates directory structure and commands, then use an interactive approval workflow to apply precise edits.

Can I review suggested AGENTS.md edits before they are applied to the repository?▼

Yes, you can review suggested edits through an interactive approval workflow that presents a structured comparison report, allowing you to selectively apply updates and ensure clear traceability for your AGENTS.md changes.

Does the AGENTS.md comparison process validate technology stack changes in the codebase?▼

Yes, the AGENTS.md comparison process validates technology changes by loading and parsing the file, comparing findings with the codebase, and highlighting inconsistencies across architecture, directory structure, and commands.

What should I do when my AGENTS.md is unclear and needs validation against the codebase?▼

When your AGENTS.md is unclear, perform a comprehensive review by analyzing the repository state to identify inconsistencies, generating a structured comparison report that captures discrepancies and suggests concrete updates.

Related Skills

Explore More Software Engineering Skills→
Euraika-LabsEuraika-Labs
14

adopt-studio

Detect Codex Code Game Studios studio layer artifacts in git repositories.

Official
Intermediate
ksopylaksopyla

engineering-change-tracking

Update CHANGELOG.md, active_todos.md, and git commit messages for Concept Encoder code changes.

Community
Basic
lshtramlshtram

doc-maintainer

Detect and fix drift between code and TECH_SPEC_current.md documentation.

Community
Intermediate
kkestellkkestell
1

kinit

Generate an AGENTS.md file documenting project components, commands, and conventions.

Community
Intermediate