Presença no GitHub

Quando Usar

Use esta habilidade quando o usuário quiser otimizar seu perfil do GitHub, README ou a descoberta de projetos. Frases de gatilho incluem "README do GitHub", "otimização de README", "perfil do GitHub", "estrelas do GitHub", "descoberta no GitHub", "awesome lists" ou "marketing no GitHub".

O GitHub é onde os desenvolvedores avaliam seu projeto antes de experimentá-lo. Esta habilidade abrange otimização de README, READMEs de perfil, descoberta através de tópicos e awesome lists, e o uso de recursos do GitHub para marketing.

Antes de Começar

1. Leia .agents/developer-audience-context.md se existir
2. Audite sua presença atual no GitHub (perfil, repositórios fixados, READMEs)
3. Entenda: O GitHub é frequentemente a primeira avaliação técnica — otimize de acordo

Estrutura do README

A Anatomia de um Ótimo README

Modelo de README

<div align="center">
  <img src="logo.svg" alt="Project Name" width="200">
  <h1>Project Name</h1>
  <p><strong>One compelling sentence explaining what this does.</strong></p>

  <!-- Badges -->
  <a href="https://github.com/org/repo/actions"><img src="https://github.com/org/repo/workflows/CI/badge.svg" alt="CI"></a>
  <a href="https://www.npmjs.com/package/name"><img src="https://img.shields.io/npm/v/name.svg" alt="npm version"></a>
  <a href="https://github.com/org/repo/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
  <a href="https://discord.gg/invite"><img src="https://img.shields.io/discord/123456789" alt="Discord"></a>

  <br>
  <br>

  <a href="https://docs.example.com">Documentation</a> •
  <a href="https://example.com">Website</a> •
  <a href="https://discord.gg/invite">Discord</a>
</div>

---

## Why Project Name?

- **Feature 1** — Brief explanation
- **Feature 2** — Brief explanation
- **Feature 3** — Brief explanation

## Quick Start

```bash
npm install nome-do-projeto

import { coisa } from 'nome-do-projeto';

const resultado = coisa.fazerAlgo();
console.log(resultado);

Installation

npm

npm install nome-do-projeto

yarn

yarn add nome-do-projeto

pnpm

pnpm add nome-do-projeto

Usage

Basic Example

// Exemplo de código com comentários

Advanced Example

// Exemplo mais complexo

Documentation

Full documentation available at docs.example.com

• Getting Started
• API Reference
• Examples

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

License

MIT © Your Name

---

## Badges que Importam

### Badges de Sinal de Confiança

| Badge | O que mostra | Quando usar |
|-------|--------------|-------------|
| Status CI/Build | Qualidade do código | Sempre |
| Versão | Último lançamento | Sempre para pacotes |
| Licença | Clareza legal | Sempre |
| Downloads/instalações | Adoção | Quando impressionante |
| Cobertura | Qualidade dos testes | Se > 70% |
| Segurança | Status da auditoria | Se você tiver |

### Badges da Comunidade

| Badge | Fonte | Propósito |
|-------|--------|---------|
| Membros do Discord | shields.io | Mostrar comunidade ativa |
| Estrelas do GitHub | shields.io | Prova social |
| Contribuidores | shields.io | Saúde do código aberto |
| Último commit | shields.io | Atividade do projeto |

### Serviços de Badges

| Serviço | URL | Melhor para |
|---------|-----|----------|
| Shields.io | shields.io | A maioria dos badges |
| Badgen | badgen.net | Rápido, minimalista |
| Badges do GitHub | Nativo | Actions, issues |

### Exemplos de Badges

```markdown
<!-- Status do build -->

…