Intro in this page language first. The official description stays in its original wording; we do not rewrite SKILL.md.
What it does
Intelligent README.md generation prompt that analyzes project documentation structure and creates comprehensive repository documentation. Scans .github/copilot directory files and copilot-instructions.md to extract project information, technology stack, architecture, development workflow, coding standards, and testing approaches while generating well-structured markdown documentation with proper formatting, cross-references, and developer-focused content.
When to use it
The official description does not include a separate “Use when”. Per the spec, agents activate this skill when the task matches keywords in that description.
How agents load it
Per Agent Skills progressive disclosure: name and description load at startup (~100 tokens); the full SKILL.md body loads when the skill activates; scripts/, references/, and assets/ load only as needed. This file's sections: README Generator Prompt; Project Name and Description; Technology Stack; Project Architecture; Getting Started; Project Structure. It includes spec-recommended sections: step-by-step instructions.
File analysis
File analysis: instruction-only skill (SKILL.md). The agent loads the full body when activated.
README Generator PromptProject Name and DescriptionTechnology StackProject ArchitectureGetting StartedProject StructureKey FeaturesDevelopment WorkflowCoding StandardsTestingContributingLicense
Choose the target agent and installation scope, keep referenced package files, then verify the skill appears in the client's catalog.
Ask your Agent to install
Copy these instructions to a compatible agent and confirm the target directory matches your client.
Install the agent skill "readme-blueprint-generator" into my project. The full SKILL.md and official description are at https://zicq.com/en/skills/skl-724dca49c168598d-Readme-Blueprint-Generator.html
Save it as .cursor/skills/readme-blueprint-generator/SKILL.md or .claude/skills/readme-blueprint-generator/SKILL.md and keep the frontmatter name and description exactly as-is.
The CLI lets you choose the agent interactively. The default scope is the project; use -g for user scope. Confirm package availability with the discovery command, then use npx skills list to inspect installed skills.
Readable layout
name: readme-blueprint-generator
description: 'Intelligent README.md generation prompt that analyzes project documentation structure and creates comprehensive repository documentation. Scans .github/copilot directory files and copilot-instructions.md to extract project information, technology stack, architecture, development workflow, coding standards, and testing approaches while generating well-structured markdown documentation with proper formatting, cross-references, and developer-focused content.'
README Generator Prompt
Generate a comprehensive README.md for this repository by analyzing the documentation files in the .github/copilot directory and the copilot-instructions.md file. Follow these steps:
Scan all the files in the .github/copilot folder, like:
Architecture
Code_Exemplars
Coding_Standards
Project_Folder_Structure
Technology_Stack
Unit_Tests
Workflow_Analysis
Also review the copilot-instructions.md file in the .github folder
Create a README.md with the following sections:
Project Name and Description
Extract the project name and primary purpose from the documentation
Include a concise description of what the project does
Technology Stack
List the primary technologies, languages, and frameworks used
Include version information when available
Source this information primarily from the Technology_Stack file
Project Architecture
Provide a high-level overview of the architecture
Consider including a simple diagram if described in the documentation
Source from the Architecture file
Getting Started
Include installation instructions based on the technology stack
Add setup and configuration steps
Include any prerequisites
Project Structure
Brief overview of the folder organization
Source from Project_Folder_Structure file
Key Features
List main functionality and features of the project
Extract from various documentation files
Development Workflow
Summarize the development process
Include information about branching strategy if available
Source from Workflow_Analysis file
Coding Standards
Summarize key coding standards and conventions
Source from the Coding_Standards file
Testing
Explain testing approach and tools
Source from Unit_Tests file
Contributing
Guidelines for contributing to the project
Reference any code exemplars for guidance
Source from Code_Exemplars and copilot-instructions
License
Include license information if available
Format the README with proper Markdown, including:
Clear headings and subheadings
Code blocks where appropriate
Lists for better readability
Links to other documentation files
Badges for build status, version, etc. if information is available
Keep the README concise yet informative, focusing on what new developers or users would need to know about the project.