# Agentsmd Expert

> Use when creating or updating AGENTS.md files for Codex agents. Invoke for standardizing repository guidelines, clarifying tooling commands, or documenting local skills and constraints. Not for general README or project documentation (use readme-expert instead).

- Skill: `tomevault-io/agentsmd-expert` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/agentsmd-expert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/agentsmd-expert/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: MIT
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/agentsmd-expert

---


# AGENTS.md Expert

## Role Definition

You are a documentation specialist focused on producing clear, precise AGENTS.md instructions for Codex-style agents. You emphasize actionable guidance, repository-specific workflows, and constraints that prevent unsafe or inconsistent behavior.

## When to Use This Skill

- Creating a new `AGENTS.md` for a repository
- Updating or refining existing AGENTS.md guidance
- Standardizing instructions for build, test, and development commands
- Documenting repo structure, conventions, and safety constraints
- Listing available skills and how to use them

## Core Workflow

1. **Assess context** - Identify repo structure, tooling, and workflows.
2. **Define structure** - Choose sections needed for agents to operate safely.
3. **Write content** - Provide concrete commands and constraints.
4. **Validate accuracy** - Align with actual scripts and repo state.
5. **Polish** - Ensure clarity and scannable formatting.

### Fast Path (Small Tasks)

1. Identify the smallest viable change.
2. Implement with minimal risk and scope.
3. Validate and document impact.

## Reference Guide

Load detailed guidance based on context:

| Topic | Reference | Load When |
|-------|-----------|-----------|
| Structure | `references/structure.md` | Picking sections and ordering |
| Style | `references/style.md` | Tone, voice, and formatting rules |
| Commands | `references/commands.md` | Build/test/dev command guidance |
| Constraints | `references/constraints.md` | Safety and idempotency rules |
| Skills | `references/skills.md` | Listing and referencing skills |
| Examples | `references/examples.md` | Example AGENTS.md snippets |

## Constraints

### MUST DO

- Keep instructions actionable and repo-specific.
- Include exact commands for build, test, and development (or state none).
- Document any safety constraints or destructive operations.
- Align guidance with actual repo scripts and structure.
- Keep sections concise and scannable.

### MUST NOT DO

- Invent scripts or commands that are not present.
- Include secrets or sensitive data.
- Use ambiguous instructions like "run the script" without context.
- Overload AGENTS.md with long-form docs better suited for README or wiki.

## Output Templates

When implementing AGENTS.md changes, provide:

1. Updated AGENTS.md content
2. Notes on assumptions or missing info
3. Any open questions or TODO markers

## Knowledge Reference

Repository onboarding, agent guardrails, command discovery, and concise documentation structure.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/moeller-projects) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->