mtai0524/claude-skills

Mantenha o README.md e a documentação do projeto sincronizados quando funcionalidades, configuração ou estrutura mudarem. Use após adicionar um recurso, alterar etapas de configuração, adicionar variáveis de ambiente ou quando o usuário pedir para atualizar os documentos.

O que é claude-skills?

Este skill para assistentes de IA (como Claude Code, Cursor, Codex) garante que a documentação do projeto, especialmente o README.md, seja mantida atualizada automaticamente sempre que houver alterações no código que afetem a instalação, execução, configuração ou uso do projeto. Ele é acionado após a adição de um novo recurso, mudanças nas etapas de configuração, inclusão de variáveis de ambiente ou quando o usuário solicita explicitamente uma atualização da documentação. O skill edita seletivamente as seções do README afetadas pela mudança, sem reescrever o documento inteiro, e verifica se todos os comandos documentados realmente funcionam. É útil para desenvolvedores que trabalham com projetos em plataformas como Claude Code, Cursor ou Codex, pois automatiza a tarefa de manter a documentação precisa e consistente, economizando tempo e reduzindo erros.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mtai0524/claude-skills/tree/HEAD/skills/docs-readme

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Docs & README

Quando uma alteração afeta a forma como alguém instala, executa, configura ou usa o projeto, atualize o README.md na mesma mudança.

O README deve cobrir, resumidamente:

  • O que é o projeto (1-2 frases).
  • Requisitos e passos de instalação.
  • Como executar, testar e construir — comandos copiáveis.
  • Configuração: cada variável de ambiente com sua finalidade e um valor de exemplo (nunca segredos reais).
  • Exemplos curtos de uso para as funcionalidades principais.

Regras:

  • Edite apenas as seções que a mudança afeta; não reescreva o arquivo inteiro.
  • Verifique se cada comando que você documenta realmente funciona.
  • Português, frases curtas, sem linguagem de marketing.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas