README baseado na documentação do repositório

O que esta skill faz

Esta skill analisa a documentação presente em .github/copilot e o arquivo copilot-instructions.md para montar um README coerente. O conteúdo resultante organiza propósito, tecnologias, arquitetura, configuração, estrutura e práticas do projeto.

Quando usar

• Criar o README inicial de um repositório documentado
• Consolidar informações técnicas espalhadas em .github
• Descrever stack e arquitetura para novos colaboradores
• Documentar instalação, estrutura e testes
• Adicionar referências cruzadas para documentos detalhados

Como usar

1. Revise o repositório e liste os arquivos em .github/copilot
2. Leia copilot-instructions.md e os documentos técnicos disponíveis
3. Extraia somente informações confirmadas pelas fontes
4. Organize o README nas seções adequadas
5. Valide comandos, links e versões antes de publicar

O que revisar antes de instalar

• A qualidade do README depende da atualização dos documentos de origem
• Informações ausentes não devem ser inferidas
• O fluxo descrito prioriza arquivos em .github e pode não cobrir outras fontes

SKILL.md

---
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:

1. Scan all the files in the .github/copilot folder, like:
   - Architecture
   - Code_Exemplars
   - Coding_Standards
   - Project_Folder_Structure
   - Technology_Stack
   - Unit_Tests
   - Workflow_Analysis

2. Also review the copilot-instructions.md file in the .github folder

3. 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.