{"id":"ada72df2-3863-44da-883b-10729a7ef6c0","shortId":"NvPxCc","kind":"skill","title":"agents-md","tagline":"This skill should be used when the user asks to \"create AGENTS.md\", \"update AGENTS.md\", \"maintain agent docs\", \"set up CLAUDE.md\", or needs to keep agent instructions concise. Enforces research-backed best practices for minimal, high-signal agent documentation.","description":"# Maintaining AGENTS.md\n\nAGENTS.md is the canonical agent-facing documentation. Keep it minimal—agents are capable and don't need hand-holding. Target under 60 lines; never exceed 100. Instruction-following quality degrades as document length increases.\n\n## When to Use\n- The user asks to create, update, or audit `AGENTS.md` or `CLAUDE.md`.\n- The project needs concise, high-signal agent instructions derived from the actual toolchain and repo layout.\n- Existing agent documentation is too long, duplicated, or drifting away from real project conventions.\n\n## File Setup\n\n1. Create `AGENTS.md` at project root\n2. Create symlink: `ln -s AGENTS.md CLAUDE.md`\n\n## Before Writing\n\nAnalyze the project to understand what belongs in the file:\n\n1. **Package manager** — Check for lock files (`pnpm-lock.yaml`, `yarn.lock`, `package-lock.json`, `uv.lock`, `poetry.lock`)\n2. **Linter/formatter configs** — Look for `.eslintrc`, `biome.json`, `ruff.toml`, `.prettierrc`, etc. (don't duplicate these in AGENTS.md)\n3. **CI/build commands** — Check `Makefile`, `package.json` scripts, CI configs for canonical commands\n4. **Monorepo indicators** — Check for `pnpm-workspace.yaml`, `nx.json`, Cargo workspace, or subdirectory `package.json` files\n5. **Existing conventions** — Check for existing CONTRIBUTING.md, docs/, or README patterns\n\n## Writing Rules\n\n- **Headers + bullets** — No paragraphs\n- **Code blocks** — For commands and templates\n- **Reference, don't embed** — Point to existing docs: \"See `CONTRIBUTING.md` for setup\" or \"Follow patterns in `src/api/routes/`\"\n- **No filler** — No intros, conclusions, or pleasantries\n- **Trust capabilities** — Omit obvious context\n- **Prefer file-scoped commands** — Per-file test/lint/typecheck commands over project-wide builds\n- **Don't duplicate linters** — Code style lives in linter configs, not AGENTS.md\n\n## Required Sections\n\n### Package Manager\nWhich tool and key commands only:\n```markdown\n## Package Manager\nUse **pnpm**: `pnpm install`, `pnpm dev`, `pnpm test`\n```\n\n### File-Scoped Commands\nPer-file commands are faster and cheaper than full project builds. Always include when available:\n```markdown\n## File-Scoped Commands\n| Task | Command |\n|------|---------|\n| Typecheck | `pnpm tsc --noEmit path/to/file.ts` |\n| Lint | `pnpm eslint path/to/file.ts` |\n| Test | `pnpm jest path/to/file.test.ts` |\n```\n\n### Commit Attribution\nAlways include this section. Agents should use their own identity:\n```markdown\n## Commit Attribution\nAI commits MUST include:\n```\nCo-Authored-By: (the agent model's name and attribution byline)\n```\nExample: `Co-Authored-By: Claude Sonnet 4 <noreply@example.com>`\n```\n\n### Key Conventions\nProject-specific patterns agents must follow. Keep brief.\n\n## Optional Sections\n\nAdd only if truly needed:\n- API route patterns (show template, not explanation)\n- CLI commands (table format)\n- File naming conventions\n- Project structure hints (point to critical files, flag legacy code to avoid)\n- Monorepo overrides (subdirectory `AGENTS.md` files override root)\n\n## Anti-Patterns\n\nOmit these:\n- \"Welcome to...\" or \"This document explains...\"\n- \"You should...\" or \"Remember to...\"\n- Linter/formatter rules already in config files (`.eslintrc`, `biome.json`, `ruff.toml`)\n- Listing installed skills or plugins (agents discover these automatically)\n- Full project-wide build commands when file-scoped alternatives exist\n- Obvious instructions (\"run tests\", \"write clean code\")\n- Explanations of why (just say what)\n- Long prose paragraphs\n\n## Example Structure\n\n```markdown\n# Agent Instructions\n\n## Package Manager\nUse **pnpm**: `pnpm install`, `pnpm dev`\n\n## Commit Attribution\nAI commits MUST include:\n```\nCo-Authored-By: (the agent model's name and attribution byline)\n```\n\n## File-Scoped Commands\n| Task | Command |\n|------|---------|\n| Typecheck | `pnpm tsc --noEmit path/to/file.ts` |\n| Lint | `pnpm eslint path/to/file.ts` |\n| Test | `pnpm jest path/to/file.test.ts` |\n\n## API Routes\n[Template code block]\n\n## CLI\n| Command | Description |\n|---------|-------------|\n| `pnpm cli sync` | Sync data |\n```\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["agents","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity-skills"],"capabilities":["skill","source-sickn33","skill-agents-md","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/agents-md","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34997 github stars · SKILL.md body (4,393 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-25T06:50:23.726Z","embedding":null,"createdAt":"2026-04-18T21:30:36.149Z","updatedAt":"2026-04-25T06:50:23.726Z","lastSeenAt":"2026-04-25T06:50:23.726Z","tsv":"'1':130,155 '100':73 '2':136,167 '3':183 '4':195,386 '5':208 '60':69 'actual':109 'add':401 'agent':2,19,28,42,51,57,104,115,354,372,394,469,504,525 'agent-fac':50 'agents-md':1 'agents.md':15,17,45,46,94,132,141,182,286,435 'ai':363,516 'alreadi':457 'altern':483 'alway':324,350 'analyz':145 'anti':440 'anti-pattern':439 'api':406,551 'ask':12,88,597 'attribut':349,362,377,515,530 'audit':93 'author':369,382,522 'automat':472 'avail':327 'avoid':431 'away':123 'back':34 'belong':151 'best':35 'biome.json':173,462 'block':226,555 'boundari':605 'brief':398 'build':274,323,477 'bullet':222 'bylin':378,531 'canon':49,193 'capabl':59,256 'cargo':202 'cheaper':319 'check':158,186,198,211 'ci':190 'ci/build':184 'clarif':599 'claud':384 'claude.md':23,96,142 'clean':490 'clear':572 'cli':413,556,560 'co':368,381,521 'co-authored-bi':367,380,520 'code':225,279,429,491,554 'command':185,194,228,264,269,295,311,315,332,334,414,478,535,537,557 'commit':348,361,364,514,517 'concis':30,100 'conclus':252 'config':169,191,284,459 'context':259 'contributing.md':214,240 'convent':127,210,389,419 'creat':14,90,131,137 'criteria':608 'critic':425 'data':563 'degrad':78 'deriv':106 'describ':576 'descript':558 'dev':305,513 'discov':470 'doc':20,215,238 'document':43,53,80,116,448 'drift':122 'duplic':120,179,277 'emb':234 'enforc':31 'environ':588 'environment-specif':587 'eslint':342,545 'eslintrc':172,461 'etc':176 'exampl':379,501 'exceed':72 'exist':114,209,213,237,484 'expert':593 'explain':449 'explan':412,492 'face':52 'faster':317 'file':128,154,161,207,262,267,309,314,330,417,426,436,460,481,533 'file-scop':261,308,329,480,532 'filler':249 'flag':427 'follow':76,244,396 'format':416 'full':321,473 'hand':65 'hand-hold':64 'header':221 'high':40,102 'high-sign':39,101 'hint':422 'hold':66 'ident':359 'includ':325,351,366,519 'increas':82 'indic':197 'input':602 'instal':303,465,511 'instruct':29,75,105,486,505 'instruction-follow':74 'intro':251 'jest':346,549 'keep':27,54,397 'key':294,388 'layout':113 'legaci':428 'length':81 'limit':564 'line':70 'lint':340,543 'linter':278,283 'linter/formatter':168,455 'list':464 'live':281 'ln':139 'lock':160 'long':119,498 'look':170 'maintain':18,44 'makefil':187 'manag':157,290,299,507 'markdown':297,328,360,503 'match':573 'md':3 'minim':38,56 'miss':610 'model':373,526 'monorepo':196,432 'must':365,395,518 'name':375,418,528 'need':25,63,99,405 'never':71 'noemit':338,541 'noreply@example.com':387 'nx.json':201 'obvious':258,485 'omit':257,442 'option':399 'output':582 'overrid':433,437 'packag':156,289,298,506 'package-lock.json':164 'package.json':188,206 'paragraph':224,500 'path/to/file.test.ts':347,550 'path/to/file.ts':339,343,542,546 'pattern':218,245,393,408,441 'per':266,313 'per-fil':265,312 'permiss':603 'pleasantri':254 'plugin':468 'pnpm':301,302,304,306,336,341,345,509,510,512,539,544,548,559 'pnpm-lock.yaml':162 'pnpm-workspace.yaml':200 'poetry.lock':166 'point':235,423 'practic':36 'prefer':260 'prettierrc':175 'project':98,126,134,147,272,322,391,420,475 'project-specif':390 'project-wid':271,474 'prose':499 'qualiti':77 'readm':217 'real':125 'refer':231 'rememb':453 'repo':112 'requir':287,601 'research':33 'research-back':32 'review':594 'root':135,438 'rout':407,552 'ruff.toml':174,463 'rule':220,456 'run':487 'safeti':604 'say':496 'scope':263,310,331,482,534,575 'script':189 'section':288,353,400 'see':239 'set':21 'setup':129,242 'show':409 'signal':41,103 'skill':5,466,567 'skill-agents-md' 'sonnet':385 'source-sickn33' 'specif':392,589 'src/api/routes':247 'stop':595 'structur':421,502 'style':280 'subdirectori':205,434 'substitut':585 'success':607 'symlink':138 'sync':561,562 'tabl':415 'target':67 'task':333,536,571 'templat':230,410,553 'test':307,344,488,547,591 'test/lint/typecheck':268 'tool':292 'toolchain':110 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'treat':580 'truli':404 'trust':255 'tsc':337,540 'typecheck':335,538 'understand':149 'updat':16,91 'use':8,85,300,356,508,565 'user':11,87 'uv.lock':165 'valid':590 'welcom':444 'wide':273,476 'workspac':203 'write':144,219,489 'yarn.lock':163","prices":[{"id":"6e080390-401e-455f-a11a-ec6af1801952","listingId":"ada72df2-3863-44da-883b-10729a7ef6c0","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:30:36.149Z"}],"sources":[{"listingId":"ada72df2-3863-44da-883b-10729a7ef6c0","source":"github","sourceId":"sickn33/antigravity-awesome-skills/agents-md","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agents-md","isPrimary":false,"firstSeenAt":"2026-04-18T21:30:36.149Z","lastSeenAt":"2026-04-25T06:50:23.726Z"}],"details":{"listingId":"ada72df2-3863-44da-883b-10729a7ef6c0","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"agents-md","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34997,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-25T06:33:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"897be886a5a7d49b33485d09c919e88684b95f4c","skill_md_path":"skills/agents-md/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/agents-md"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"agents-md","description":"This skill should be used when the user asks to \"create AGENTS.md\", \"update AGENTS.md\", \"maintain agent docs\", \"set up CLAUDE.md\", or needs to keep agent instructions concise. Enforces research-backed best practices for minimal, high-signal agent documentation."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/agents-md"},"updatedAt":"2026-04-25T06:50:23.726Z"}}