agents-md-skill

Create and optimize AGENTS.md and CLAUDE.md files for AI coding agents.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/CJHwong/claude-skills --skill agents-md-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-md-skill
Source: https://github.com/CJHwong/claude-skills/tree/main/plugins/agents-md-skill/skills/agents-md-skill
Command: npx skills add https://github.com/CJHwong/claude-skills --skill agents-md-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you create and refine context files (like AGENTS.md or CLAUDE.md) for AI coding agents, ensuring they perform optimally by providing only essential, actionable information and avoiding common pitfalls that decrease performance and increase costs.

Core Features & Use Cases

  • Context File Creation/Optimization: Guides the creation of lean, effective context files for AI coding agents, based on empirical research.
  • Workflow Capture: Extracts conversational workflows into reusable slash commands.
  • Use Case: You're onboarding a new AI coding assistant to your project and want to ensure it has the most efficient setup. This Skill helps you craft the perfect AGENTS.md file that tells the AI exactly what it needs to know without unnecessary information, improving its performance and reducing token costs.

Quick Start

Use the agents-md-skill to create or improve the AGENTS.md file for this repository.

Frequently Asked Questions about agents-md-skill

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

FAQPage Schema
How do I create an effective AGENTS.md context file for AI coding agents?

To create an effective AGENTS.md context file, include only essential, actionable information based on empirical research to maximize agent performance and minimize token costs. This approach avoids common pitfalls like unnecessary overviews and generic advice.

What should I include in a CLAUDE.md file to optimize AI agent performance?

A CLAUDE.md file should include only lean, actionable context that guides the AI coding assistant without unnecessary information. Capturing conversational workflows into reusable slash commands can further optimize the agent's performance and reduce costs.

Why does providing too much context in AI agent files decrease performance?

Providing too much context decreases performance because common pitfalls like overviews and generic advice increase token costs and dilute the agent's focus. Optimizing context files ensures the AI receives only essential, actionable information for the specific repository.

Can I capture conversational workflows into reusable slash commands for AI agents?

Yes, you can capture conversational workflows and extract them into reusable slash commands. This allows you to automate repetitive prompt engineering tasks and maintain lean context files for AI coding agents.

Does overloading context files with generic advice increase token costs for AI coding agents?

Yes, overloading context files with generic advice and unnecessary overviews increases token costs and decreases agent performance. Relying on empirical research to provide only essential, actionable information mitigates these common pitfalls.