readme

Generate ClearDocs-compliant README files from detected project metadata.

1|2|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/montymi/claude-config --skill readme-montymi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: readme
Source: https://github.com/montymi/claude-config/tree/main/skills/readme
Command: npx skills add https://github.com/montymi/claude-config --skill readme-montymi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create or update a README.md for a project following ClearDocs styling principles, reducing manual drafting and ensuring consistency across repos.

Core Features & Use Cases

  • Auto-detect project metadata (name, description, repo, license) and populate the README sections accordingly.
  • Decide which sections to include based on repo context (LICENSE, CONTRIBUTING.md, environment variables, API references) and user preferences.
  • Preserve or adapt existing documentation content while integrating with the ClearDocs template to maintain coherence across projects.

Quick Start

Run the Readme Skill on your project repository to generate a ClearDocs-compliant README.

Frequently Asked Questions about readme

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

FAQPage Schema
How do I generate a README that follows standardized documentation guidelines?

Generate a ClearDocs-compliant README by running the readme Skill on your repository, which auto-detects project metadata and applies a standardized markdown template to produce clear documentation fast.

How does automatic project documentation detect environment variables and licenses?

Automatic project documentation detects environment variables and license visibility by scanning repository assets like LICENSE files and configuration, conditionally including those sections in the generated README based on what is actually found.

Can I use a markdown README generator for software projects of different programming languages?

Yes, the markdown README generator applies to software projects of varying sizes and languages, auto-detecting project metadata to populate the documentation sections accurately regardless of the specific tech stack.

What is the best way to update an existing README without losing my current project setup details?

Update an existing README without losing details by using a generator that preserves existing documentation content where appropriate, integrating it with the ClearDocs template to maintain coherence across the project.

Does the project documentation generator include contributing guidelines and API references automatically?

The project documentation generator conditionally includes optional sections like API references and contributing guidelines, deciding which sections to add based on detected repository context such as the presence of a CONTRIBUTING.md file.

Why does my generated README omit certain sections like environment variables?

A generated README omits certain sections like environment variables when the generator scans the repository context and fails to detect the corresponding configuration files or assets needed to populate them accurately.