---
title: "Maintaining AGENTS.md"
type: skill
id: "sentry-skills/engineering-practices/agents-md"
category: "Engineering"
publisher: "Sentry"
license: "Apache-2.0"
source: "https://github.com/getsentry/skills/tree/0c464f4"
canonical: "https://labs.pho.chat/en/skills/sentry-skills/engineering-practices/agents-md"
open_in_pho: "https://pho.chat/customize?item=sentry-skills%2Fengineering-practices%2Fagents-md&utm_source=labs&utm_medium=skill-page&utm_campaign=skills-library"
---

# Maintaining AGENTS.md

Creates and maintains concise AGENTS.md and CLAUDE.md project instruction files. Use when asked to create AGENTS.md, update AGENTS.md, maintain agent docs, set up CLAUDE.md, document repository agent conventions, or keep coding-agent instructions minimal and reference-backed.

Source: Sentry (Apache 2.0), copied at a pinned commit. Free to use. Part of the Phở Skills library (https://labs.pho.chat/en/skills).
Skill set: Sentry engineering practices (https://labs.pho.chat/en/skills/sentry-skills/engineering-practices.md).

## What it covers
- Workflow
- File Setup
- Default Sections
- Writing Rules
- External Reference Rules
- Anti-Patterns

## Other skills in this set
- [Code Simplifier](https://labs.pho.chat/en/skills/sentry-skills/engineering-practices/code-simplifier.md): Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Use when asked to "simplify code", "clean up code", "refactor for clarity", "improve…
- [Find Bugs](https://labs.pho.chat/en/skills/sentry-skills/engineering-practices/find-bugs.md): Find bugs, security vulnerabilities, and code quality issues in local branch changes. Use when asked to review changes, find bugs, security review, or audit code on the current branch.
- [Sentry Commit Messages](https://labs.pho.chat/en/skills/sentry-skills/engineering-practices/commit.md): Use for every request to commit changes or draft a commit message. Creates Sentry-style conventional commits with issue references.
- [PR Writer](https://labs.pho.chat/en/skills/sentry-skills/engineering-practices/pr-writer.md): Create or refresh reviewer-facing PR titles and descriptions. Use when opening a PR, updating its title or body, or preparing branch changes for review.
- [Prompt Optimizer](https://labs.pho.chat/en/skills/sentry-skills/engineering-practices/prompt-optimizer.md): Creates, optimizes, and iteratively refines agent prompts, system prompts, developer prompts, and reusable prompt templates. Use when asked to improve a prompt, optimize a system prompt, rewrite an…

## Use it
- In Phở: open https://pho.chat/customize?item=sentry-skills%2Fengineering-practices%2Fagents-md&utm_source=labs&utm_medium=skill-page&utm_campaign=skills-library and press Try, or add it so Phở loads it whenever a request matches. Phở works with your own API key (OpenAI, Anthropic, Google and others).
- Full instructions (original SKILL.md, unchanged): https://labs.pho.chat/skills/raw/sentry-skills/engineering-practices/skills/agents-md/SKILL.md
- Original files: https://github.com/getsentry/skills/tree/0c464f4 (Apache 2.0).
- Full machine-readable index: https://labs.pho.chat/skills.json