# Agents Md Assistant

> Inspect a repository and draft an AGENTS.md file using the standard template, capturing commands, structure, and workflow rules.

- Skill: `majiayu000/agents-md-assistant` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/agents-md-assistant`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/agents-md-assistant/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/agents-md-assistant

---


# AGENTS.md Assistant

## Quick start
- Review `README.md`, `CONTRIBUTING.md`, and docs/CI configs to learn the intended workflow.
- Pull exact commands from build scripts (`Makefile`, `package.json`, `pyproject.toml`, `justfile`).
- Map key directories (source, tests, docs, scripts) and mark generated or vendor paths.
- Capture architecture: key entrypoints, components, and configuration locations.
- Fill unknowns with TODOs and confirm them with the user.

## Workflow
1) **Inspect the repository**  
   - Read `README.md`, `CONTRIBUTING.md`, and `/docs` for goals and workflows.  
   - Check build/config files: `Makefile`, `package.json`, `pyproject.toml`, `justfile`, `Dockerfile`, CI pipelines.  

2) **Extract commands**  
   - Record install, dev, lint, format, typecheck, test, and build commands exactly as documented.  
   - If multiple options exist, capture the preferred default and note alternates.  

3) **Map structure**  
   - Identify primary code, tests, docs, scripts, and generated/ignored folders.  
   - Note where key configs live and any build artifacts to avoid editing.  

4) **Summarize architecture & environment**  
   - Document key components, data flow, and entrypoints.  
   - Capture required versions, services, env vars, and migration/seed steps.  

5) **Author AGENTS.md**  
   - Use `references/agents_md_template.md` as the base.  
   - Place `AGENTS.md` at the repo root unless instructed otherwise.  
   - Flag missing info with TODOs and ask for confirmation.  

## Reference
- `references/agents_md_template.md`: base template to fill.