How do I install the Readme Generator skill?

Run npx skillmds@latest add kbarbel640-del/readme-generator in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Readme Generator safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Readme Generator?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Readme Generator free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Readme Generator?

kbarbel640-del (@kbarbel640-del) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Readme Generator by kbarbel640-del — Agent Skill

Name: Readme Generator
Author: kbarbel640-del

File contents

README Generator

Analyze a project directory and generate a complete, useful README.md.

Requirements

File system access to the target project
No API keys or external services needed

Instructions

Step 1: Scan the project

# Project structure (exclude noise)
find . -maxdepth 3 -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/__pycache__/*' -not -path '*/venv/*' -not -path '*/.venv/*' | head -80

# Package metadata
cat package.json 2>/dev/null || cat pyproject.toml 2>/dev/null || cat Cargo.toml 2>/dev/null || cat go.mod 2>/dev/null

# Available scripts/commands
jq '.scripts' package.json 2>/dev/null

# License detection
ls LICENSE* LICENCE* 2>/dev/null

# Entry points
ls src/index.* src/main.* main.* app.* cli.* 2>/dev/null

Step 2: Read key files (first 50 lines each)

Main entry point
Config files (tsconfig, pyproject, etc.)
Existing README (to preserve intent)

Step 3: Generate README with this structure

# Project Name
Brief description.

## Features
- Key feature list

## Installation
Steps to install (npm install, pip install, etc.)

## Usage
CLI examples and/or programmatic usage with code blocks.

## API Reference (if applicable)
Document exported functions/endpoints.

## Project Structure
Tree view with brief descriptions of key files.

## Development
Clone, install, test, contribute steps.

## License
Detected license type.

Step 4: Save output

If no README.md exists → save as README.md
If README.md exists → save as README.generated.md and let user decide
Always ask before overwriting an existing README

Edge Cases

Monorepo: Detect multiple package.json/go.mod files. Generate root README with links to sub-packages.
Empty project: Generate minimal README with project name and setup placeholder.
Non-English comments: Generate README in English regardless of code comments language.
Private/internal projects: Skip "Publishing" sections; focus on development setup.

Tips

Don't fabricate: Only document what actually exists in the project. Don't invent features.
Be practical: Installation and usage sections are the most valuable — prioritize them.
Code examples: Use actual file names and real commands from the project.
Adapt section depth to project complexity (small script → short README).

---name: readme-generatordescription: Auto-generate comprehensive README.md files by analyzing project structure and configuration.---# README GeneratorAnalyze a project directory and generate a complete, useful README.md.## Requirements- File system access to the target project- No API keys or external services needed## Instructions### Step 1: Scan the project```bash# Project structure (exclude noise)find . -maxdepth 3 -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/__pycache__/*' -not -path '*/venv/*' -not -path '*/.venv/*' | head -80# Package metadatacat package.json 2>/dev/null || cat pyproject.toml 2>/dev/null || cat Cargo.toml 2>/dev/null || cat go.mod 2>/dev/null# Available scripts/commandsjq '.scripts' package.json 2>/dev/null# License detectionls LICENSE* LICENCE* 2>/dev/null# Entry pointsls src/index.* src/main.* main.* app.* cli.* 2>/dev/null```### Step 2: Read key files (first 50 lines each)- Main entry point- Config files (tsconfig, pyproject, etc.)- Existing README (to preserve intent)### Step 3: Generate README with this structure```markdown# Project NameBrief description.## Features- Key feature list## InstallationSteps to install (npm install, pip install, etc.)## UsageCLI examples and/or programmatic usage with code blocks.## API Reference (if applicable)Document exported functions/endpoints.## Project StructureTree view with brief descriptions of key files.## DevelopmentClone, install, test, contribute steps.## LicenseDetected license type.```### Step 4: Save output- If no README.md exists → save as `README.md`- If README.md exists → save as `README.generated.md` and let user decide- Always ask before overwriting an existing README## Edge Cases- **Monorepo**: Detect multiple package.json/go.mod files. Generate root README with links to sub-packages.- **Empty project**: Generate minimal README with project name and setup placeholder.- **Non-English comments**: Generate README in English regardless of code comments language.- **Private/internal projects**: Skip "Publishing" sections; focus on development setup.## Tips- **Don't fabricate**: Only document what actually exists in the project. Don't invent features.- **Be practical**: Installation and usage sections are the most valuable — prioritize them.- **Code examples**: Use actual file names and real commands from the project.- Adapt section depth to project complexity (small script → short README).

Frequently asked questions

Readme Generator