
README Generator
Generate a README from your actual repo, not a hallucinated guess. Scans your manifests (package.json, pyproject.toml, go.mod, Cargo.toml) for real install steps, scripts, and dependencies across Node, Python, Go, Rust, and Java. Documentation that matches the code instead of drifting from it.
- Generate polished onboarding docs for a new open-source repository
- Standardize README formats across a large microservice architecture
- Extract API docs and usage examples directly from source code docstrings
Free
Included in download
- Downloadable skill package
- Works with Python, Go
- 3 permissions declared
Sample input
Review my node.js project and generate a README with badges, installation steps, scripts from package.json, and a list of dependencies.
Sample output
Project Name
Installation
npm install
Scripts
npm start: Runs src/index.tsnpm test: Runs jest
Dependencies
- express ^4.18.2
- typescript ^5.0.0
TODO: Add environment variables for API_KEY.
Generate a README from your actual repo, not a hallucinated guess. Scans your manifests (package.json, pyproject.toml, go.mod, Cargo.toml) for real install steps, scripts, and dependencies across Node, Python, Go, Rust, and Java. Documentation that matches the code instead of drifting from it.
Free
Included in download
- Downloadable skill package
- Works with Python, Go
- 3 permissions declared
- Instant install
Sample input
Review my node.js project and generate a README with badges, installation steps, scripts from package.json, and a list of dependencies.
Sample output
Project Name
Installation
npm install
Scripts
npm start: Runs src/index.tsnpm test: Runs jest
Dependencies
- express ^4.18.2
- typescript ^5.0.0
TODO: Add environment variables for API_KEY.
About This Skill
Professional READMEs from Reality, Not Hallucinations
Stop manually formatting documentation and wrestling with template headers. This skill automates the creation of polished, production-ready README files by deep-scanning your repository's actual structure and configuration files.
What it does
Unlike generic AI prompts that guess how your code works, this skill performs an environmental audit. It identifies your tech stack by inspecting manifests like package.json, pyproject.toml, go.mod, and Cargo.toml. It extracts real scripts, validates entry points, and maps dependencies to generate accurate installation and usage guides.
Key Features
- Multi-Language Support: Tailored documentation for Node/TypeScript, Python, Go, Rust, and Java environments.
- Safe Inspection: Uses
--helpflags and manifest parsing to find commands without modifying your code. - Evidence-Based: Extract descriptions from docstrings and JSDocs rather than inventing project goals.
- Dynamic Badges: Automatically includes license, version, and language badges based on detected metadata.
Why use this skill?
It eliminates "documentation drift." By grounding the output in your source code's reality, it ensures that if a script isn't in your manifest, it isn't in your README. It provides a standardized, professional structure that makes any repo "onboarding-ready" in seconds.
Use Cases
- Generate polished onboarding docs for a new open-source repository
- Standardize README formats across a large microservice architecture
- Extract API docs and usage examples directly from source code docstrings
- Audit project manifests to update outdated installation instructions
Known Limitations
- Generates markdown only (no PDF, no HTML)
- Badges are placeholder URLs (user can replace with actual badge links)
- API documentation requires JSDoc/docstrings in source code
- Does not automatically commit or push the README
- Overwrites existing README.md only with user confirmation
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/readme-generator-1 -o /tmp/readme-generator-1.zip && unzip -o /tmp/readme-generator-1.zip -d ~/.claude/skills && rm /tmp/readme-generator-1.zipFree skills install directly. Paid skills require purchase - use the download button above after buying.
Reviews
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
No reviews yet - be the first to share your experience.
Only users who have downloaded or purchased this skill can leave a review.
Security Scanned
Passed automated security review
Permissions
File Scopes
README Generator needs terminal access to run help commands (e.g., `npm run --help`) that generate usage examples. File read access scans manifest files, source code, and existing LICENSE files. File write access creates README.md — the user is always asked for confirmation before any file is written. No browser, network, or env var access required.
Works with Claude Code and Codex. Supports Node.js, Python, Go, Rust, and Java projects.
Creator
JustHandled Labs builds focused agent skills for the work nobody wants to do by hand. Each one is a single repeatable job done well: catching the security and data mistakes that quietly ship, keeping docs and tests honest, gating the commands an agent is about to run, sharpening writing, and handling the founder chores around launches, outreach, and brand setup. Not generic AI productivity. Specific workflows that are easy to run, review, and repeat. Maintained by H.J. Westerfield, with a background in communications, editing, project coordination, customer support, and practical AI systems. Tools for people who want useful automation without theatrical complexity.
Frequently Asked Questions
Learn More About AI Agent Skills
More Premium Skills
cinematic-sites
Turn any basic business URL into a high-end cinematic landing page with AI-generated 4K assets and GSAP animations.
Multi-Agent Orchestration Master Library
Transform Claude Code into a coordinated multi-agent system. Battle-tested tmux orchestration patterns, YAML task queues, event-driven communication, and parallel worker management for 8+ agents.
endless-loop
Autonomous research and task loop that builds on previous findings to solve complex objectives while you sleep.
skill-router-2
Automatically detect, load, and stack the perfect skills combo for any user request.