agents-md

Migrate CLAUDE.md files to AGENTS.md with symlinks and status checks.

Updated Feb 17, 2026

Search Tags:#markdown #consistency #refactoring #migration #agents #symlink

Ready to run

npx skills add https://github.com/martylouis/agents --skill agents-md-martylouis

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: agents-md
Source: https://github.com/martylouis/agents/tree/main/skills/agents-md
Command: npx skills add https://github.com/martylouis/agents --skill agents-md-martylouis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill streamlines the management of agent instruction files, ensuring consistency and proper linking between the new standard (AGENTS.md) and a legacy symlink (CLAUDE.md).

Core Features & Use Cases

Migration: Converts existing CLAUDE.md files to AGENTS.md and creates the necessary symlinks.
Symlink Management: Ensures all AGENTS.md files have corresponding CLAUDE.md symlinks.
Status Reporting: Provides a clear overview of the current state of AGENTS.md and CLAUDE.md files, flagging inconsistencies.
Refactoring: Organizes and cleans up AGENTS.md content according to progressive disclosure principles.

Quick Start

Run the command to migrate existing CLAUDE.md files to AGENTS.md with symlinks.

Frequently Asked Questions about agents-md

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

FAQPage Schema

How do I migrate CLAUDE.md files to AGENTS.md?▼

Migrating CLAUDE.md files to AGENTS.md involves converting the existing file to the new standard and creating a symlink. This skill automates that transition, ensuring the legacy CLAUDE.md path points correctly to the new AGENTS.md.

What is the best way to manage AGENTS.md and CLAUDE.md symlinks?▼

Managing AGENTS.md and CLAUDE.md symlinks is handled by creating a symbolic link from the legacy file to the new standard. This ensures both paths resolve to the same content, maintaining project-wide consistency without duplicating instructions.

How do I check the consistency of AGENTS.md files across a project?▼

Checking AGENTS.md consistency is done through a status reporting feature that scans for the file and its corresponding CLAUDE.md symlink. It flags missing files or broken links to ensure your agent instructions are properly linked and organized.

Can I refactor AGENTS.md content for progressive disclosure?▼

Refactoring AGENTS.md content for progressive disclosure is supported by organizing and cleaning up the file structure. This skill helps restructure the instructions to align with progressive disclosure principles, making agent guidance clearer.

Why does my CLAUDE.md symlink point to AGENTS.md?▼

Your CLAUDE.md symlink points to AGENTS.md to maintain backward compatibility during the migration to the new standard. This approach ensures existing tools relying on CLAUDE.md continue working while you transition to AGENTS.md.

Do I need shell scripts to organize AGENTS.md files?▼

Shell scripts are used to automate the migration, symlink creation, and status reporting for AGENTS.md files. While you can manage these manually, the scripts provide a reliable way to enforce consistency across your project.