skills.rest
martylouis
martylouisCOMMUNITY
Explore all skills by this author →
Website𝕏@martylouisGitHub

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
One-click install
npx skills add https://github.com/martylouis/agents --skill agents-md-martylouis
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
mgratzermgratzer
65

forge-setup-project

Create CLAUDE.md, AGENTS.md, docs/, README, and CHANGELOG.md for Forge projects.

Community
Intermediate
legoutlegout
3

agent-md-refactor

Refactor monolithic agent instruction files into linked documentation hierarchies.

Community
Intermediate
PriyanshKuniyalPriyanshKuniyal

python-code-style

Enforce PEP 8 formatting, naming, and documentation standards in Python code.

Community
Intermediate
diriendirien
19

agent-rules

Generate and verify AGENTS.md files with bash, jq, and git.

Community
Advanced