rc-readme

Generates or refreshes a project README from verified codebase evidence.

19|1|Updated Jun 27, 2026
One-click install
npx skills add https://github.com/rodolfochicone/rc-project --skill rc-readme-rodolfochicone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rc-readme
Source: https://github.com/rodolfochicone/rc-project/tree/main/skills/misc/rc-readme
Command: npx skills add https://github.com/rodolfochicone/rc-project --skill rc-readme-rodolfochicone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Project READMEs drift out of sync with the actual codebase — stale versions, removed endpoints, wrong commands, and undocumented features mislead contributors and users. This Skill rewrites or updates a README using only facts verified from real source files, never invented content. ## Core Features & Use Cases - Evidence-based generation: Scans manifests (package.json, go.mod, pyproject.toml), entry points, routes, env vars, scripts, migrations, and CI workflows so every claim traces to a file that was read. - Gap analysis against existing README: Compares the current README to the codebase, preserving valid sections and rewriting only what is stale. - Audience-aware templates: Ships reference templates for open source, personal, internal/team, and config-directory READMEs, plus a style guide of common mistakes. - Use Case: After shipping a new API version, run the Skill to detect outdated endpoints and env vars in your README and produce an updated document with a summary of what changed. ## Quick Start Ask the agent to regenerate or update the project README from the current codebase, optionally scoping it to specific sections or a target file other than README.md.

Frequently Asked Questions about rc-readme

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

FAQPage Schema
How do I generate a README from an existing codebase?▼

Run the Skill on the repository root. It reads manifests, entry points, routes, configuration, scripts, and CI workflows, then writes a README where every claim traces back to a file it actually read.

How to update an outdated README without rewriting everything?▼

The Skill compares the existing README against current codebase facts, keeps valid sections and tone, and rewrites only stale parts such as old versions, removed endpoints, or wrong commands.

What README template should I use for an open source project?▼

Use the included oss-template reference, which covers badges, features, installation, usage, contributing, and license sections. The Skill also ships templates for personal, internal, and config-directory projects.

Does this README generator work with any programming language or stack?▼

Yes, it is stack-agnostic. It detects the technology by inspecting manifests like package.json, go.mod, pyproject.toml, Cargo.toml, pom.xml, or Gemfile before writing anything.

What happens when README details cannot be determined from the code?▼

Undeterminable details are marked as [TODO] rather than fabricated. If no recognizable stack is found, the Skill reports what it inspected and asks you to confirm the project type.

When should I not use this README generation approach?▼

Do not use it for API specifications or changelogs, which the Skill explicitly excludes. It also will not modify source code — it only writes the target README file.