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.