10x-agents-md

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

Updated Jul 4, 2026
One-click install
npx skills add https://github.com/Assamir/ai-toolkit --skill 10x-agents-md-assamir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-agents-md
Source: https://github.com/Assamir/ai-toolkit/tree/main/.cursor/skills/10x-agents-md
Command: npx skills add https://github.com/Assamir/ai-toolkit --skill 10x-agents-md-assamir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Repositories often lack a concise, agent-readable onboarding document, so AI coding agents waste context rediscovering build commands, conventions, and hard rules on every session. This Skill inspects the repo and writes a tight AGENTS.md that a fresh agent can read once and stay unblocked. ## Core Features & Use Cases - Repo inspection and drafting: Reads the manifest, README, lint/test/CI configs, directory layout, and git history to extract only project-specific, checkable facts. - Create and update paths: Writes a new AGENTS.md when none exists, or performs surgical, git-diff-driven updates that preserve still-valid content when one does. - Repo-level and directory-level scopes: Produces a root onboarding guide or a focused per-directory guide (e.g. src/api/AGENTS.md) with local conventions inferred from sibling files. - Use Case: After adding a new test framework and renaming npm scripts, run the update flow to refresh AGENTS.md so it cites the current commands instead of stale ones. ## 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 inspects your README, package manifest, lint and test configs, CI workflows, and git history, then drafts a 200-400 word guide ordered with critical rules first.

How do I update an existing AGENTS.md without losing my edits?

The update path dates the file via git log, diffs repo state since the last touch, and classifies each line as keep, update, remove, or missing. It then applies surgical edits after you confirm, preserving still-valid content and uncommitted changes.

Can I generate AGENTS.md for a subdirectory instead of the repo root?

Yes, pass a directory path as the argument to write a directory-level AGENTS.md. The skill infers local conventions from sibling files, drops repo-level sections, and targets a shorter 120-250 word guide.

Does the AGENTS.md generator work with monorepos?

Yes, for monorepos it writes a root AGENTS.md listing packages and @-referencing each package's README rather than duplicating detail. It can also suggest nested per-package AGENTS.md files where rules materially differ.

What are the limitations of generated AGENTS.md files?

The skill never invents project facts, embeds multi-line code snippets, or writes generic advice like clean code rules. Every claim must trace to an inspected file, command, or commit, and the body is capped at 400 words.