readme-generator

Generate README files from real repository files and manifests.

22|2|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/jshsakura/awesome-opencode-skills --skill readme-generator-jshsakura
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: readme-generator
Source: https://github.com/jshsakura/awesome-opencode-skills/tree/main/skills/readme-generator
Command: npx skills add https://github.com/jshsakura/awesome-opencode-skills --skill readme-generator-jshsakura

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts repository reality into a faithful, maintainer-ready README without hallucinations.

Core Features & Use Cases

  • Faithful mapping: Extracts real files, scripts, tests, and manifests to craft an accurate README.
  • No hallucinations: References only what exists in the repo with verifiable evidence.
  • Maintainability focus: Produces sections like prerequisites, installation, usage, contribution, and license based on repository content.

Quick Start

Run the readme-generator on a repository to obtain a ready-to-publish README that mirrors the current project state.

Frequently Asked Questions about readme-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a README from existing repository files without hallucinating configuration details?▼

To generate a README without hallucinations, use a tool that enforces strict sourcing from real files and manifests. This approach extracts installation steps, prerequisites, and usage examples directly from your repository content while surfacing gaps where evidence is missing.

What is the best way to create a maintainer-ready README from real project manifests?▼

The best way to create a maintainer-ready README from real project manifests is to use automated documentation generation that maps your actual files, scripts, and tests into structured sections. This ensures accurate inclusion of prerequisites, installation, usage, contribution, and license information.

Can I automate documentation generation for common project layouts?▼

Yes, you can automate documentation generation across common project layouts. The process operates by detecting installation steps, prerequisites, usage examples, and contribution guidelines from your repository reality to produce a ready-to-publish README.

Does automated README generation work without existing documentation?▼

Automated README generation works without existing documentation by extracting details directly from real files, scripts, and manifests. It avoids fabricating configuration keys or commands by strictly referencing what exists in the repo and surfacing gaps where evidence is missing.

Why does my generated README contain fabricated configuration keys and commands?▼

Your generated README contains fabricated configuration keys because the tool lacks strict sourcing from real files. To prevent hallucinations, the generation process must reference only what exists in your repository and surface gaps where evidence is missing instead of inventing configuration details.

What sections are included when generating a README from repository reality?▼

When generating a README from repository reality, the included sections cover prerequisites, installation, usage, contribution, and license. These sections are produced based on actual repository content detected across common project layouts for a maintainer-ready document.