Communitygithub.com

Prove It

Use quando o usuário executar /prove-it ou disser prove it, prove the changes, show me in the browser, ou pedir para provar uma alteração de UI ou API. Não use apenas porque o agente está prestes a dizer 'pronto', para trabalho somente de tipos ou para documentação sem comportamento a ser provado.

O que é Prove It?

Este skill, chamado 'Prove It', é um mecanismo rigoroso para agentes de IA (como Claude Code, Cursor ou Codex) comprovarem que uma alteração de código realmente funciona do ponto de vista do usuário. Ele só é ativado quando o usuário explicitamente solicita a prova, por meio de comandos como `/prove-it` ou frases como 'prove it' ou 'show me in the browser'. O skill diferencia entre alterações de UI (que devem ser testadas no navegador, clicando, digitando e navegando) e alterações de servidor/API (onde o agente deve perguntar ao usuário como proceder, oferecendo opções como exemplos existentes, curl ou scripts). Ele tem 'portões rígidos' que impedem o agente de afirmar que algo funciona sem prova real, proíbe a adição de novos pacotes ou dependências sem consentimento, e exige que qualquer servidor iniciado seja parado ao final. Após a prova, opcionalmente pode gerar um relatório em `.agent/scratch/prove-it.md`. O skill é útil para garantir que as alterações não sejam apenas tecnicamente corretas, mas também funcionais na prática, evitando suposições.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/prove-it

Perguntar na sua IA favorita

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

Documentação

Prove It (Prove Isso)

Prove a alteração da forma como uma pessoa a usa. Não afirme que funciona sem essa prova.

Este skill não carrega automaticamente ao dizer "pronto". O usuário deve solicitar. Ele não carrega outros skills.

Quando Usar

Carregue quando o usuário:

  • executar /prove-it
  • disser "prove it", "prove the changes", "show me in the browser" ou a mesma ideia (inclusive na primeira mensagem)

Pule se ele não pediu. Pule trabalho somente de tipos, comentários, lockfile, documentação sem comportamento.

Portões Rígidos (Hard Gates)

  1. Usuário pediu. Se ele não pediu para provar, este skill não executa.
  2. Não diga que funciona, está pronto ou está corrigido a menos que este skill realmente tenha provado. Pular significa não provado.
  3. Uma captura de tela de uma tela não é prova. Clique, digite, envie, navegue.
  4. Nenhum novo pacote, dependência, aplicativo de exemplo ou executor de navegador a menos que o usuário tenha escolhido essa opção e dito sim.
  5. Pare qualquer servidor que este skill iniciou antes de o skill terminar. Não deixe dev / preview em execução.

UI vs Servidor

  • UI (página, componente, rota, formulário, estado visível): prove no navegador.
  • Servidor / API / biblioteca sem tela: pergunte como provar. Não escolha em silêncio.
  • Ambos: navegador para a UI e pergunte como provar a parte do servidor.

Procedimentos

Procedimento 1: Classificar

  1. Liste as superfícies: UI, servidor/API ou ambos.
  2. UI → Procedimento 2.
  3. Servidor/API → Procedimento 3.
  4. Ambos → Procedimento 2, depois Procedimento 3 para a API.

Procedimento 2: Navegador (UI)

  1. Se o aplicativo não estiver em execução, inicie apenas um comando existente (dev, preview, o início documentado do repositório). Se não houver nenhum, diga que a UI não pode ser provada. Ofereça pular ou que o usuário inicie o aplicativo.
  2. Use-o como um usuário:
    • clique, digite, envie, navegue
    • em toda rota/página que compartilha este estado
    • UI vazia e de erro se esta alteração as tiver
    • desktop e uma viewport estreita se o layout ou CSS mudou
  3. Caça por quebras, não apenas o caminho feliz.
  4. No chat, diga o que fez e o que viu. Não diga "parece bom" sem passos.
  5. Pare o processo do passo 1 se este skill o iniciou.
  6. Procedimento 4.

Procedimento 3: Perguntar (servidor / API)

  1. Pare. Mostre 2–3 opções. Coloque uma primeira escolha razoável primeiro. Sempre inclua pular.
    • exemplo / playground / demo existente
    • aplicativo de exemplo que usa a nova API (apenas se eles confirmarem o local + qualquer novo pacote/dep)
    • curl ou um pequeno script contra um servidor em execução
    • pular
  2. Aguarde. Não construa nem execute até que eles escolham.
  3. Se pular: diga não provado. Não diga que funciona. Pare (sem Procedimento 4).
  4. Se playground existente: execute-o, depois prove no navegador se tiver UI, ou mostre a saída do comando se for um script.
  5. Se aplicativo de exemplo: pergunte onde. Prefira um exemplo existente. Não adicione um pacote ou dependência a menos que ele tenha dito sim. Depois execute-o e prove.
  6. Se curl/script: execute-o. Cite o código de saída e a parte da saída que prova a afirmação.
  7. Procedimento 4.

Procedimento 4: Relatório opcional

  1. Após uma prova real, pergunte: escrever um relatório com capturas de tela? Padrão não.
  2. Se não: pare. O chat já tem a evidência.
  3. Se sim: escreva .agent/scratch/prove-it.md (sobrescreva). Adicione .agent/scratch/ ao .gitignore se estiver faltando (igual a outros arquivos temporários). Inclua o que foi clicado e as capturas. Abra o arquivo. Não o commite.
  4. Pular prova → sem relatório.

Procedimento 5: Parar

Após a prova ou pular, pare. Não inicie trabalho não relacionado a partir deste skill.

Árvore de Decisão

  • Usuário não pediu para provar → este skill não se aplica.
  • UI → Procedimento 2 → 4 → 5.
  • Servidor/API → Procedimento 3 → 4 → 5 (pular termina em 3).
  • Ambos → 2 depois 3, depois 4 → 5.
  • Nenhum comando de início e aplicativo não está em execução → diga que não pode provar a UI. Pular ou usuário inicia.
  • Usuário diz pular → não provado. Nenhuma afirmação de sucesso.

Bandeiras Vermelhas (Red Flags)

SinalO que significaO que fazer em vez disso
Dizer "pronto" porque os testes passaramEste skill não foi solicitado ou a prova foi puladaAfirme "provado" somente após o Procedimento 2 ou 3.
Uma captura de tela, sem cliquesNão é um caminho de usuárioProcedimento 2, passo 2.
Construir examples/foo antes de eles escolheremAplicativo não solicitadoProcedimento 3. Aguarde.
Adicionar Playwright / um novo servidorNova dependênciaSomente comando de início existente.
Deixar pnpm dev em execuçãoWatcher deixado ligadoPortão rígido 5.
"Pular, mas funciona"Pular transformado em afirmaçãoDiga "não provado".
Arquivo de relatório em docs/Documentação do produto.agent/scratch/prove-it.md.
Abrir o relatório quando eles disseram nãoArquivo não solicitadoProcedimento 4, padrão não.
Provar apenas a página para uma nova API públicaParte do servidor pulada em silêncioProcedimento 3 para a API.

Tratamento de Erros

  • Sem ferramentas de navegador: diga que a UI não pode ser provada aqui. Ofereça pular ou que eles cliquem enquanto você espera em uma URL. Não finja uma captura de tela.
  • Comando de início falha: cite o erro. Não diga que a UI funciona. Ofereça pular ou uma correção, depois prove novamente.
  • Prova falha (clique faz a coisa errada, curl não retorna 200): diga não provado. Nomeie o que falhou. Não o chame de "pronto".
  • Eles escolhem aplicativo de exemplo e depois recusam um novo pacote: use curl, um exemplo existente ou pule. Não adicione o pacote mesmo assim.
  • Falha ao escrever em scratch: mantenha a prova no chat. Diga que o arquivo de relatório não foi escrito.

Não veja mais nada. O chat é a evidência padrão. O arquivo markdown é opcional.

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

Habilidades Relacionadas