readme-generator
Skill1 starsChanged 7 months agoMITView on GitHub
Generates a comprehensive, standardized README.md for any project. Use when the user wants to create or regenerate a README file following the project's documentation standard.
- Reads credentials
- Commits and pushes
39 other projects use a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- imtiazrayhan/agentscamp-librarytheir own version, first seen Nov 16, 2026
- dainch/my-skillstheir own version, first seen Nov 16, 2026
- dmccreary/ibook-skillstheir own version, first seen Nov 3, 2026
- Sagargupta16/agent-recipestheir own version, first seen Nov 1, 2026
- jaskirat1616/grok-skillstheir own version, first seen Nov 1, 2026
- wedsamuel1230/arduino-skillstheir own version, first seen Nov 1, 2026
Used with
Projects with it also use book-chapter-generator, concept-classifier and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
vishalsachdevSkillbook-chapter-generator
This skill generates a structured chapter outline for intelligent textbooks by analyzing course descriptions, learning graphs, and concept dependencies. Use this skill after the learning graph has been created and before generating chapter content, to design an optimal chapter structure that respects concept dependencies and distributes content evenly across 6-20 chapters.
Also in 3 projects that use this
vishalsachdevSkillconcept-classifier
Create an interactive classification quiz MicroSim using p5.js where students read scenarios and classify them into the correct category from multiple choice options. Uses a data.json file for easy question editing. Ideal for teaching students to recognize patterns, identify types, or categorize examples across any subject domain.
Also in 3 projects that use this
JayRHaSkillchangelog-keeper
Maintains a CHANGELOG.md in the Keep a Changelog format with Semantic Versioning, grouping user-facing entries under Added/Changed/Deprecated/Removed/Fixed/Security and cutting dated releases from an Unreleased section. Use this skill when the user asks to "update the changelog", "add a changelog entry", "cut a release", "bump the version", "what changed since the last release", or to create/clean up a CHANGELOG.md or release notes.
Also in 3 projects that use this
ATOM00blueSkillerror-message-explainer
Explains errors, stack traces, exceptions, and cryptic build/runtime messages in plain language, identifies the root cause, and gives a concrete fix. Use when the user pastes an error, stack trace, traceback, panic, compiler error, or failing log and asks what it means, why it happens, or how to fix it.
Also in 3 projects that use this
peopleforresterSkillrefactoring-guide
Safe refactoring patterns and techniques. Use when the user wants to improve code structure, reduce duplication, or make code more maintainable without changing behavior. Emphasizes incremental changes with test coverage.
Also in 3 projects that use this
- +7 more from vishalsachdev
Other versions39 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- emaginebr/AvaBot★ 268% same
Wrote their own version · 38
- serejaris/personal-corp-os★ 244same name
- serejaris/ris-claude-code★ 244same name
- dmccreary/claude-skills★ 112same name
- dmccreary/ibook-skills★ 112same name
- anchildress1/awesome-ai★ 67same name
- anchildress1/awesome-github-copilot★ 67same name
- MCDxAI/minecraft-dev-mcp★ 47same name
- geekjourneyx/readme-generator★ 44same name
- glincker/claude-code-marketplace★ 37same name
- jshsakura/awesome-opencode-skills★ 31same name
28 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository39 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- add-react-i18nSkill
- band-album-campaignSkill
- band-music-reflectionSkill
- band-streaming-launchSkill
- ckm:banner-designSkill
- ckm:brandSkill
- deploy-prodSkill
- ckm:designSkill
- ckm:design-systemSkill
- docker-compose-configSkill
- doc-managerSkill
- dotnet-architectureSkill
- dotnet-doc-controllerSkill
- dotnet-envSkill
- dotnet-fluent-validationSkill
- dotnet-graphqlSkill
- dotnet-multi-tenantSkill
- dotnet-test-apiSkill
- dotnet-testSkill
- frontend-designSkill
- gitversionSkill
- maui-architectureSkill
- mermaid-chartSkill
- nauth-guideSkill
- nnews-guideSkill
- react-alertSkill
- react-architectureSkill
- react-archSkill
- react-modalSkill
- readme-generatorSkill
- ckm:slidesSkill
- social-media-assetsSkill
- social-media-schedulingSkill
- social-post-authoringSkill
- ckm:ui-stylingSkill
- ui-ux-pro-maxSkill
- wsl-dockerSkill
- ztools-guideSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
20 rules. 0 are common, 12 are distinctive, and 8 are very specific to this project.
0
Common
Most of the 32 edited versions we read keep these.
12
Distinctive
This author's own choices. Worth a look.
8
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
If no arguments are provided, analyze the current project directory.
- Distinctive: line 24
Identify the project type: Check for project files to determine the technology stack:
- Distinctive: line 34
Read project configuration files: Read the main project config to extract:
- Very specific: line 41
Analyze the directory structure: Use ls and Glob to understand the folder structure, identify key directories (source, tests, docs, config, …
- Very specific: line 43
Check for Docker support: Look for Dockerfile, docker-compose.yml, .dockerignore.
- Very specific: line 45
Check for CI/CD: Look for .github/workflows/, .gitlab-ci.yml, Jenkinsfile, azure-pipelines.yml, bitbucket-pipelines.yml.
- Distinctive: line 47
Check for existing badges: Look at existing README (if any), SonarCloud, NuGet, NPM, or other badge sources.
- Very specific: line 49
Check for environment configuration: Look for .env.example, appsettings.*.json, config/ directories.
- Distinctive: line 53
Check for related ecosystem projects: Look for references to sibling repositories, packages, or monorepo structure.
- Distinctive: line 432
Only include relevant sections: If the project has no Docker, skip the Docker section.
- Distinctive: line 434
Accurate information only: Every piece of information in the README must come from actual project files.
- Distinctive: line 436
Realistic badge URLs: Only add badges for services that are actually configured (SonarCloud, NuGet, NPM, etc.).
- Very specific: line 440
Correct commands: All build, test, run, and Docker commands must be verified against actual project configuration files (package.json …
- Distinctive: line 442
Preserve existing content: If the user has an existing README with custom content (like a specific roadmap or acknowledgments), ask whether …
- Distinctive: line 444
Emoji consistency: Use the emoji style shown in the template for section headers.
- Very specific: line 446
Horizontal rules: Use --- between major sections for visual separation.
- Distinctive: line 448
Tables for structured data: Use markdown tables for Docker commands, endpoints, ecosystem packages, and other structured data.
- Very specific: line 450
Code blocks with language hints: Always specify the language in fenced code blocks (`
bash,json,csharp,`javascript, etc.). - Very specific: line 452
Environment variables: Never include real secrets or passwords in examples.
- Distinctive: line 458
After creating the README, inform the user:
“Common” is measured: kept by at least 6 in 10 of the 32 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Generate Standardized README.md
You are a README.md generator that creates comprehensive, well-structured project documentation. Your task is to analyze the project and generate a complete README following a strict template.
Input
The user may provide additional context or a project path as argument: $ARGUMENTS
If no arguments are provided, analyze the current project directory.
Instructions
Phase 1 — Project Discovery
Analyze the project to gather all necessary information:
- Identify the project type: Check for project files to determine the technology stack:
.csproj/.sln→ .NETpackage.json→ Node.js / React / Angularpom.xml/build.gradle→ Javarequirements.txt/pyproject.toml/setup.py→ Pythongo.mod→ GoCargo.toml→ RustGemfile→ Ruby- Other config files as needed
- Read project configuration files: Read the main project config to extract:
- Project name and version
- Description (if available)
- Dependencies and their versions
- Build/run scripts
- License
- Analyze the directory structure: Use
lsandGlobto understand the folder structure, identify key directories (source, tests, docs, config, docker, CI/CD). - Check for Docker support: Look for
Dockerfile,docker-compose.yml,.dockerignore. - Check for CI/CD: Look for
.github/workflows/,.gitlab-ci.yml,Jenkinsfile,azure-pipelines.yml,bitbucket-pipelines.yml. - Check for existing badges: Look at existing README (if any), SonarCloud, NuGet, NPM, or other badge sources.
- Check for environment configuration: Look for
.env.example,appsettings.*.json,config/directories. - Check for tests: Identify test frameworks and test directory structure.
- Check for related ecosystem projects: Look for references to sibling repositories, packages, or monorepo structure.
Phase 2 — Generate README
Generate the README.md following the exact template structure below. Only include sections that are relevant to the project. If the project has no Docker setup, skip the Docker section. If no CI/CD, skip that section.
Phase 3 — Save the File
Save the generated README to README.md in the project root (or the path specified by the user).
README Template
The generated README MUST follow this structure and formatting standard:
# <Project Name> - <Short Tagline>


<!-- Add relevant badges: SonarCloud, NuGet, NPM, build status, coverage, etc. -->
## Overview
**<Project Name>** is <one paragraph description of what the project does, who it's for, and what problems it solves>. Built using **<main technologies>**.
<If part of an ecosystem, describe the relationship with other projects here.>
<Brief mention of architecture approach if relevant.>
---
## 🚀 Features
- 🔐 **Feature 1** - Brief description
- 🔑 **Feature 2** - Brief description
- 🔄 **Feature 3** - Brief description
<!-- List all major features with appropriate emoji and bold title -->
---
## 🛠️ Technologies Used
### Core Framework
- **<Framework>** - Brief description
### Database
- **<Database>** - Brief description
<!-- Only if applicable -->
### Security
- **<Security tech>** - Brief description
<!-- Only if applicable -->
### Additional Libraries
- **<Library>** - Brief description
### Testing
- **<Test framework>** - Brief description
### DevOps
- **<DevOps tool>** - Brief description
<!-- Only if applicable -->
---
## 📁 Project Structure
\`\`\`
<ProjectRoot>/
├── <dir1>/ # Description
│ ├── <subdir>/ # Description
│ └── <file> # Description
├── <dir2>/ # Description
├── <config-file> # Description
└── README.md # This file
\`\`\`
<!-- If part of an ecosystem, add: -->
### Ecosystem
| Project | Type | Package | Description |
|---------|------|---------|-------------|
| **[Project1](url)** | Type | Badge | Description |
#### Dependency graph
\`\`\`
<ASCII art dependency graph>
\`\`\`
---
## ⚙️ Environment Configuration
Before running the application, you need to configure the environment variables:
### 1. Copy the environment template
\`\`\`bash
cp .env.example .env
\`\`\`
### 2. Edit the \`.env\` file
\`\`\`bash
# Variable descriptions with example values
VARIABLE_NAME=example_value
\`\`\`
⚠️ **IMPORTANT**:
- Never commit the \`.env\` file with real credentials
- Only the \`.env.example\` should be version controlled
- Change all default passwords and secrets before deployment
---
## 🐳 Docker Setup
### Quick Start with Docker Compose
#### 1. Prerequisites
\`\`\`bash
# Any required network or pre-setup commands
\`\`\`
#### 2. Build and Start Services
\`\`\`bash
docker-compose up -d --build
\`\`\`
#### 3. Verify Deployment
\`\`\`bash
docker-compose ps
docker-compose logs -f
\`\`\`
### Accessing the Application
| Service | URL |
|---------|-----|
| **Service Name** | http://localhost:PORT |
### Docker Compose Commands
| Action | Command |
|--------|---------|
| Start services | \`docker-compose up -d\` |
| Start with rebuild | \`docker-compose up -d --build\` |
| Stop services | \`docker-compose stop\` |
| View status | \`docker-compose ps\` |
| View logs | \`docker-compose logs -f\` |
| Remove containers | \`docker-compose down\` |
| Remove containers and volumes (⚠️) | \`docker-compose down -v\` |
---
## 🔧 Manual Setup (Without Docker)
### Prerequisites
- <Prerequisite 1>
- <Prerequisite 2>
### Setup Steps
#### 1. <Step Title>
\`\`\`bash
<commands>
\`\`\`
#### 2. <Step Title>
\`\`\`bash
<commands>
\`\`\`
---
## 🧪 Testing
### Running Tests
**All Tests:**
\`\`\`bash
<test command>
\`\`\`
**With Coverage:**
\`\`\`bash
<coverage command>
\`\`\`
### Test Structure
\`\`\`
<TestDir>/
├── <category1>/ # Description
├── <category2>/ # Description
└── <category3>/ # Description
\`\`\`
---
## 📚 API Documentation
<!-- Only for API projects. Include authentication flow, endpoint summary, key examples. -->
### Authentication Flow
\`\`\`
1. Step 1 → 2. Step 2 → 3. Step 3
\`\`\`
### Key Endpoints
| Method | Endpoint | Description | Auth |
|--------|----------|-------------|------|
| POST | \`/endpoint\` | Description | No |
| GET | \`/endpoint/{id}\` | Description | Yes |
---
## 🔒 Security Features
### <Security Category>
- **Feature** - Description
---
## 💾 Backup and Restore
<!-- Only for projects with databases -->
### Backup
\`\`\`bash
<backup command>
\`\`\`
### Restore
\`\`\`bash
<restore command>
\`\`\`
---
## 🔍 Troubleshooting
### Common Issues
#### <Issue Title>
**Check:**
\`\`\`bash
<diagnostic command>
\`\`\`
**Common causes:**
- Cause 1
- Cause 2
**Solutions:**
- Solution 1
- Solution 2
---
## 📦 Integration
### Using <Project> in Your Application
#### Option 1: <Integration Method>
\`\`\`<language>
// Example code
\`\`\`
---
## 🚀 Deployment
### Development Environment
\`\`\`bash
<dev command>
\`\`\`
### Production Environment
\`\`\`bash
<prod command>
\`\`\`
### Cloud Deployment
<!-- Only if relevant. Include examples for major cloud providers. -->
---
## 🔄 CI/CD
### <CI/CD Platform>
**Workflow triggers:**
- Trigger 1
- Trigger 2
**Workflow steps:**
1. Step 1
2. Step 2
---
## 🧩 Roadmap
### Planned Features
- [ ] **Feature 1** - Description
- [ ] **Feature 2** - Description
---
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
### Development Setup
1. Fork the repository
2. Create a feature branch (\`git checkout -b feature/AmazingFeature\`)
3. Make your changes
4. Run tests (\`<test command>\`)
5. Commit your changes (\`git commit -m 'Add some AmazingFeature'\`)
6. Push to the branch (\`git push origin feature/AmazingFeature\`)
7. Open a Pull Request
### Coding Standards
- <Standard 1>
- <Standard 2>
---
## 👨💻 Author
Developed by **[Author Name](GitHub URL)**
---
## 📄 License
This project is licensed under the **<License Name>** - see the LICENSE file for details.
---
## 🙏 Acknowledgments
- Built with [Technology 1](URL)
- Powered by [Technology 2](URL)
---
## 📞 Support
- **Issues**: [GitHub Issues](<issues URL>)
- **Discussions**: [GitHub Discussions](<discussions URL>)
---
**⭐ If you find this project useful, please consider giving it a star!**Critical Rules
- Only include relevant sections: If the project has no Docker, skip the Docker section. If no database, skip Backup/Restore. If not an API, skip API Documentation. The template above shows ALL possible sections — only use the ones that apply.
- Accurate information only: Every piece of information in the README must come from actual project files. Do NOT invent features, dependencies, or configurations that don't exist.
- Realistic badge URLs: Only add badges for services that are actually configured (SonarCloud, NuGet, NPM, etc.). Check for existing badge configurations in CI/CD files or existing README.
- Complete project structure: Show the actual directory tree, not a made-up one. Use
lsandGlobto verify what exists. - Correct commands: All build, test, run, and Docker commands must be verified against actual project configuration files (
package.jsonscripts,.csprojsettings,Makefile, etc.). - Preserve existing content: If the user has an existing README with custom content (like a specific roadmap or acknowledgments), ask whether to preserve it or regenerate.
- Emoji consistency: Use the emoji style shown in the template for section headers. Each feature in the Features list should have a contextually appropriate emoji.
- Horizontal rules: Use
---between major sections for visual separation. - Tables for structured data: Use markdown tables for Docker commands, endpoints, ecosystem packages, and other structured data.
- Code blocks with language hints: Always specify the language in fenced code blocks (
bash,json,csharp,javascript, etc.). - Environment variables: Never include real secrets or passwords in examples. Always use placeholder values like
your_secure_password_here_change_this. - Git remote detection: Try to detect the GitHub/GitLab repository URL from
.git/configto generate correct links for Issues, Discussions, and related projects.
After Generating
After creating the README, inform the user:
- The file path where the README was saved
- Which sections were included and which were skipped (and why)
- Any information that could not be auto-detected and may need manual review
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

