github-readme

Generate README.md content from repository context and file trees.

14|2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/mickpletcher/AI-Skills --skill github-readme-mickpletcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-readme
Source: https://github.com/mickpletcher/AI-Skills/tree/main/claude/skills/github-readme
Command: npx skills add https://github.com/mickpletcher/AI-Skills --skill github-readme-mickpletcher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you create a polished GitHub README that accurately reflects your repository, instead of relying on a generic template.

Core Features & Use Cases

  • Repo-specific README generation: Builds a complete README from the repository context you provide (file tree, existing docs, URLs, and user notes).
  • Repo-aware section selection: Identifies the repository type and chooses only the sections that fit, avoiding irrelevant or fabricated content.
  • Practical, technical voice: Produces direct, practitioner-focused documentation with consistent style rules (tables, code blocks, annotated file trees when helpful).

Quick Start

Start your message with readme or gr and include the GitHub URL (or repo name plus description) and any key files or context you want the README to cover.

Frequently Asked Questions about github-readme

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

FAQPage Schema
How do I generate a GitHub README from my repository file tree?

To generate a GitHub README, provide your repository context, including the file tree, existing docs, and URL. The tool analyzes the provided repo structure to build accurate, repo-specific documentation instead of using generic templates.

Can I use this to rewrite an existing README without losing technical details?

Yes, you can rewrite an existing README by providing the current documentation and repository context. The tool enforces a practitioner technical tone and required section completeness while preventing fabricated content during the rewrite.

What's the best way to create repo-specific documentation from a GitHub URL?

The best way to create repo-specific documentation is to trigger the tool with 'readme' or 'gr' and include your GitHub URL. It identifies the repository type and selects only sections that fit, avoiding irrelevant content.

Does this README generator work with any repository type?

Yes, it works with any repository type you provide context for. The tool performs repo-aware section selection, analyzing your file tree and notes to choose only the relevant sections that fit the specific repository.

What are the limitations of generating a README from repository context?

The main limitation is that the tool strictly enforces no fabrication, meaning it cannot invent features not present in your provided context. It relies entirely on the file tree, existing docs, and URLs you supply to generate the README.

Why does my generated README only include certain sections?

Your generated README includes only certain sections because the tool applies repo-aware section selection. It identifies your repository type and actively avoids generating irrelevant or fabricated content that does not fit your specific project.