skills.rest
david-nossebro
david-nossebroCOMMUNITY
Explore all skills by this author →
GitHub

agents-md

Generates or updates repository AGENTS.md from existing files and project signals.

Updated May 3, 2026
Search Tags:#documentation#coding conventions#agents#CLAUDE.md#symlink#build commands#repository guidance
One-click install
npx skills add https://github.com/david-nossebro/agent-commons --skill agents-md-david-nossebro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agents-md
Source: https://github.com/david-nossebro/agent-commons/tree/main/shared/skills/agents-md
Command: npx skills add https://github.com/david-nossebro/agent-commons --skill agents-md-david-nossebro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Replaces vague or outdated agent instructions with a concise, repository-grounded AGENTS.md that coding agents can follow reliably.

Core Features & Use Cases

  • Repo instruction consolidation: Reviews existing agent files and produces a canonical, high-signal AGENTS.md that reflects real repository structure and workflows.
  • Deep repo auditing before writing: Inspects durable sources like README/docs/tooling/CI and current instruction files to avoid guessing.
  • CLAUDE.md alignment via symlink/merge: Ensures CLAUDE.md points to AGENTS.md (merging first when CLAUDE.md exists as a separate file).

Use cases include creating AGENTS.md for a new repo, performing a major refresh when the repo changed, and aligning AGENTS.md and CLAUDE.md so multiple agents behave consistently.

Quick Start

Run this skill to generate or improve the repository AGENTS.md and ensure CLAUDE.md is symlinked to it when appropriate.

Frequently Asked Questions about agents-md

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

FAQPage Schema
How do I create an AGENTS.md file for my repository?▼

The skill consolidates existing agent instruction files and deep project signals like README, docs, and tooling to produce a canonical, high-signal AGENTS.md grounded in real repository structure.

What is the best way to align CLAUDE.md with AGENTS.md?▼

Align CLAUDE.md with AGENTS.md by merging existing CLAUDE.md content into the canonical AGENTS.md, then creating a symlink so both files point to the same durable instructions.

Does this AGENTS.md generator validate build commands and file references?▼

Yes, the skill validates all command and file references against the actual repository structure before including them, ensuring agents follow reliable, verified paths.

When do I need to refresh existing agent instruction files?▼

You need a major refresh of agent instruction files when the repository structure or workflows change significantly, ensuring the AGENTS.md remains a concise, high-signal operating manual.

Can I use this skill to consolidate multiple coding convention files?▼

Yes, the skill consolidates multiple existing agent instruction files and coding conventions into a single canonical AGENTS.md, replacing vague or outdated guidance with repo-specific instructions.

Related Skills

Explore More Software Engineering Skills→
sgmondasgmonda

dotagent-bootstrap

Generate a DOTAGENT-compatible repository skeleton with agent config, docs, and TDD scaffolding.

Community
Advanced
takaokanbetakaokanbe

gen-agents-md

Generate pointer-based AGENTS.md files referencing existing repository files.

Community
Intermediate
ZhanlinCuiZhanlinCui
178

doc-sync-tool

Synchronize Agents.md, claude.md, and gemini.md across nested project directories.

Community
Intermediate
brainbrewlabsbrainbrewlabs
7

agent-improver

Create and audit Claude agent definitions with frontmatter validation.

Official
Intermediate