10x-agents-md

Generates and updates AGENTS.md onboarding documents for AI coding agents in a repository.

Updated May 23, 2026
One-click install
npx skills add https://github.com/BMS-kmusial/bms-stream-monitor --skill 10x-agents-md-bms-kmusial
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: 10x-agents-md
Source: https://github.com/BMS-kmusial/bms-stream-monitor/tree/main/.claude/skills/10x-agents-md
Command: npx skills add https://github.com/BMS-kmusial/bms-stream-monitor --skill 10x-agents-md-bms-kmusial

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding agents landing in an unfamiliar repository lack a concise, project-specific onboarding guide, so they guess at build commands, conventions, and hard rules. This Skill inspects the repo and writes a tight AGENTS.md (or surgically updates an existing one) so future agents stay unblocked. ## Core Features & Use Cases - Create path: Discovers the manifest, lint/test configs, CI workflows, layout, and git history, then drafts a 200-400 word "Repository Guidelines" document ordered by leverage with critical rules first. - Update path: Dates the existing AGENTS.md via git history, diffs repo state since the last touch, classifies every line as KEEP/UPDATE/REMOVE/MISSING, and applies surgical edits after user confirmation. - Directory-level scope: When invoked in a subdirectory, produces a shorter local guide (120-250 words) capturing sibling file conventions instead of repo-wide onboarding. - Use Case: After adding new npm scripts and a lint config to your project, run the skill to refresh AGENTS.md so it stops referencing the removed commands and documents the new CI gate. ## Quick Start Ask the agent to create an AGENTS.md onboarding document for this repository.

Frequently Asked Questions about 10x-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?▼

Invoke the skill with no arguments to write AGENTS.md at the repo root. It reads your README, package manifest, lint and test configs, CI workflows, and git history, then drafts a concise Repository Guidelines document ordered with critical rules first.

How do I update an existing AGENTS.md that is out of date?▼

Run the skill against the existing file and it enters update mode. It finds the file's last-touched commit, diffs repo state since then, classifies each line as keep, update, remove, or missing, and asks for confirmation before applying surgical edits.

Can AGENTS.md be generated for a subdirectory instead of the repo root?▼

Yes, pass a directory path as the argument and the skill switches to directory-level scope. It inspects sibling files to infer local conventions and writes a shorter 120-250 word guide focused on that directory's patterns rather than repo-wide onboarding.

Does the AGENTS.md generator work with Cursor or Codex, not just Claude Code?▼

Yes, the skill is host-agnostic. It self-discovers whichever interactive-question and subagent tools the host exposes, such as ask_question in Cursor or request_user_input in Codex, and falls back to plain chat prompts if none exist.

What are the limitations of generated AGENTS.md files?▼

The output is capped at 200-400 words, contains no multi-line code snippets, and only includes rules traceable to actual repo files. It will not invent project facts, so repos without a README or manifest require a manual project description first.