Strict, opinionated documentation manager that enforces a hard split: README.md for humans browsing GitHub, AGENTS.md for developers and AI agents running commands. No tutorial fluff, no marketing copy in the wrong file, no guessing. It verifies the actual codebase before writing anything and defaults to terse, imperative style. Handles init and update workflows for both file types, with flags like preserve, minimal, and dry-run. The most useful part is probably the enforcement itself: it will tell you to move your CLI commands out of the README and into AGENTS.md where they belong. Opinionated in a good way if you're tired of documentation drift.

skills.sh installs
1.7K
GitHub stars
104
last updated
Aug 21, 2026

Install

$ npx -y skills add paulrberg/agent-skills --skill md-docs --agent claude-code

Installs into .claude/skills of the current project.

Files

Strict, opinionated documentation manager that enforces a hard split: README.md for humans browsing GitHub, AGENTS.md for developers and AI agents running commands. No tutorial fluff, no marketing copy in the wrong file, no guessing. It verifies the actual codebase before writing anything and defaults to terse, imperative style. Handles init and update workflows for both file types, with flags like preserve, minimal, and dry-run. The most useful part is probably the enforcement itself: it will tell you to move your CLI commands out of the README and into AGENTS.md where they belong. Opinionated in a good way if you're tired of documentation drift.

Browse the repository on GitHub

Sponsors

Details

Repository
github.com/paulrberg/agent-skills
Categories
Documentation, AI & Agent Building
First seen
May 16, 2026

More from paulrberg/agent-skills

All 19
1adobe avatardocs-searchadobe/skillsUse this when you need more information about an AEM Edge Delivery Services (EDS, Franklin, Helix) feature or guidance on how to implement one, and your existin1.7Kskills.sh installs
2okx avatarokx-ai-guideokx/onchainos-skillsOKX.AI (the Agent economic system) intro & onboarding entry. Use whenever the user asks what OKX.AI is, what it can do, how to use or get started with it, wants1.6Kskills.sh installs
3boshu2 avatardocboshu2/agentopsGenerate and validate repo docs, READMEs1.6Kskills.sh installs
4cxuu avatargo-documentationcxuu/golang-skillsUse when writing or reviewing documentation for Go packages, types, functions, or methods. Also use proactively when creating new exported types, functions, or 1.3Kskills.sh installs
5mlflow avatarsearching-mlflow-docsmlflow/skillsSearches and retrieves MLflow documentation from the official docs site. Use when the user asks about MLflow features, APIs, integrations (LangGraph, LangChain,1.1Kskills.sh installs
6davila7 avatarscikit-learndavila7/claude-code-templatesMachine learning in Python with scikit-learn. Use when working with supervised learning (classification, regression), unsupervised learning (clustering, dimensi944skills.sh installs