Communitygithub.com

josepdecid/subtitle-flashcards

Cria commits git seguindo a especificação Conventional Commits, opcionalmente fazendo push depois. Use quando o usuário pedir para commitar alterações ou executar /commit.

O que é subtitle-flashcards?

Esta skill permite que um agente de IA (como Claude Code, Cursor ou Codex) crie commits git padronizados seguindo a especificação Conventional Commits, garantindo mensagens de commit consistentes e bem formatadas. Ela inspeciona o estado do repositório, seleciona arquivos relevantes para staging (evitando `git add -A` para não incluir arquivos sensíveis ou não relacionados), e divide alterações não relacionadas em commits separados. A skill suporta os tipos de commit padrão (feat, fix, docs, etc.), escopo opcional, corpo explicativo e indicação de breaking changes. Ela também permite push opcional mediante solicitação explícita do usuário (`--push`), sem nunca forçar push. É útil para equipes que desejam manter um histórico de commits limpo e semântico, facilitando a geração automática de changelogs e o versionamento semântico.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/josepdecid/subtitle-flashcards/tree/HEAD/.agents/skills/conventional-commit

Perguntar na sua IA favorita

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

Documentação

Fluxo de trabalho

  1. Inspecione o estado do repositório: git status --short, git diff --cached e git diff. Verifique também git log --oneline -10 para corresponder ao estilo existente.
  2. Se nada estiver em staging, coloque as alterações relevantes em staging por caminho explícito (evite git add -A se houver arquivos não relacionados ou sensíveis). Nunca coloque .env, segredos ou .venv em staging.
  3. Se as alterações contiverem preocupações claramente não relacionadas, divida-as em commits separados.
  4. Escreva a mensagem seguindo o formato abaixo, depois faça o commit com git commit.
  5. Execute git status para verificar se o commit foi bem-sucedido.
  6. Faça push apenas se o usuário passou --push: execute git push (use git push -u origin <branch> se não houver upstream definido). Nunca force push.

Formato da mensagem

<tipo>(<escopo opcional>): <descrição>

<corpo opcional>

<rodapé opcional>
  • Tipos: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
  • Descrição: modo imperativo, minúscula, sem ponto final, máximo ~72 caracteres.
  • Escopo: substantivo curto para a área afetada (ex.: cli, server, translate); omita se não estiver claro.
  • Corpo: explique o porquê, quebrado em ~72 caracteres; omita para alterações triviais.
  • Mudanças de quebra (breaking changes): adicione ! após o tipo/escopo e um rodapé BREAKING CHANGE:.

Regras

  • Não faça amend, rebase ou reescreva o histórico a menos que solicitado.
  • Não pule hooks (--no-verify).
  • Se um hook falhar, corrija o problema e crie um novo commit.
  • Não faça commit quando não houver alterações; em vez disso, informe isso.

Habilidades Relacionadas