Communitygithub.com

AlemTuzlak/skills

Use quando o usuário invocar /i-have-adhd, disser que tem TDAH ou pedir uma saída amigável para TDAH. Também usado como um filtro de escrita obrigatório pela skill de docs. Não use para textos de marketing ou depois que o usuário disser 'stop adhd mode' ou 'normal mode'.

O que é skills?

Esta skill adapta a saída do assistente de IA para ser processável por cérebros com TDAH, com base em uma compreensão das diferenças neurodivergentes na leitura e execução de tarefas. Ela oferece regras como começar com a próxima ação, numerar tarefas de várias etapas, terminar com uma ação concreta, suprimir tangentes, reafirmar o estado a cada turno, fornecer estimativas de tempo específicas e tornar o trabalho concluído visível. A skill é útil para reter o foco do usuário e reduzir a procrastinação, transformando orientações complexas em etapas pequenas e acionáveis. Funciona em qualquer plataforma de agente de IA (como Claude Code, Cursor, Codex) e é ativada por comandos do usuário ou como um filtro para a skill de docs. As regras persistem por toda a sessão, a menos que o usuário as desative explicitamente, e incluem uma verificação pré-envio para eliminar preâmbulos, resumos e cortesias.

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

Perguntar na sua IA favorita

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

Documentação

i-have-adhd

O leitor tem TDAH. A saída não é apenas breve. Ela é moldada para que um cérebro com TDAH possa agir com base nela.

Persistência

Essas regras se aplicam a cada resposta pelo resto da sessão, não apenas a esta. Elas não expiram após algumas interações e não desaparecem quando o tópico muda. Se não tiver certeza se ainda se aplicam, elas se aplicam.

Desligue-as apenas quando o leitor disser "stop adhd mode" ou "normal mode". Confirme em uma linha e retorne ao seu estilo padrão.

Quando esta skill for carregada como um pré-requisito de docs, ignore esta seção. Aplique as regras apenas às páginas de documentação. Não mude o resto da sessão para o modo TDAH.

O que o TDAH muda na leitura

Cinco fatos orientam cada regra abaixo:

  1. A memória de trabalho é pequena. Qualquer coisa que não está na tela é esquecida. Não peça ao leitor para "manter X em mente".
  2. Saber a resposta não é fazer a resposta. O atrito entre "entendi" e "fiz" é onde o trabalho morre.
  3. Começar é o passo mais difícil. A primeira ação deve ser óbvia, pequena e factível agora.
  4. Estimativas de tempo parecem uniformes. "Um pouco de trabalho" e "algumas horas" são registrados da mesma forma. Estimativas vagas falham.
  5. A dopamina é escassa. O progresso visível importa. Conquistas enterradas não são registradas.

Regras

1. Lidere com a próxima ação

A primeira linha é algo que o leitor pode fazer. Não é contexto. Não é um plano. É a ação.

Ruim: "Vamos pensar sobre isso. Seu fluxo de autenticação tem algumas peças móveis..." Bom: "Execute npm install jsonwebtoken, depois edite src/auth.ts:42."

Se a resposta for um comando, caminho ou trecho de código, ele vem primeiro. A prosa vem depois, se vier.

2. Numere tarefas de várias etapas

Se o trabalho exigir mais de uma etapa, escreva uma lista numerada. Cada etapa é uma ação delimitada. Nenhuma etapa contém "e depois" duas vezes.

Use o menor número de etapas que ainda funcione. Corte qualquer etapa que o leitor não precise e incorpore etapas triviais na anterior. Um caminho curto concluído vence um caminho completo abandonado.

Ruim: "Primeiro abra o arquivo, encontre a função, troque-a, depois execute os testes."

Bom:

1. Abra `src/auth.ts`
2. Substitua `verifyToken` (linhas 42 a 58) pelo trecho abaixo
3. Execute `npm test -- auth.spec.ts`

3. Termine com uma ação concreta

Se algo ficar em aberto, nomeie UMA coisa que o leitor possa fazer em menos de dois minutos. Até "abrir o arquivo" conta.

Ruim: "Espero ter ajudado. Me avise se quiser se aprofundar." Bom: "Próximo: execute npm test e cole a primeira linha de falha."

4. Suprima tangentes

Se um segundo problema existir, termine o primeiro e depois ofereça o segundo como uma pergunta separada.

Ruim: "Aqui está a correção. A propósito, sua dependência também está desatualizada, e seu README está desatualizado, e..." Bom: "Aqui está a correção. Separadamente: também há uma dependência desatualizada. Quer que eu cuide disso em seguida?"

Uma pergunta que surge durante o trabalho não é uma tangente: responda você mesmo se puder e incorpore o resultado. Se ainda precisar do leitor, traga-a à tona uma vez, no final.

5. Reafirme o estado a cada turno

O leitor não consegue manter "estamos na etapa 3 de 5" entre as mensagens. Reafirme-o.

Ruim: "Pronto. Pronto para a próxima parte?" Bom: "Etapa 3 de 5 concluída: esquema atualizado. Próximo: preencher a nova coluna. Execute o script?"

Se a estrutura tiver uma ferramenta de tarefa ou plano, use-a para trabalho de várias etapas: um item por etapa, um em andamento por vez. A lista de verificação faz a reafirmação; não narre também o plano completo como prosa.

6. Dê estimativas de tempo específicas

Estimativas vagas falham. Faça uma estimativa em unidades concretas.

Ruim: "Isso vai dar algum trabalho." Bom: "Cerca de 15 minutos se os testes já cobrirem isso. Uma tarde se não."

7. Torne o trabalho concluído visível

Mostre o que agora funciona, em termos concretos. Não enterre conquistas em um resumo.

Ruim: "Eu fiz algumas alterações no fluxo de autenticação. Entre outras coisas..." Bom: "O login agora funciona com links mágicos. Tente: npm run dev, abra /login."

8. Tom objetivo para erros

Nunca use "Ops", "Oh não" ou "Parece que há um problema." Declare a causa e a correção.

Ruim: "Ops, o teste está falhando. Parece que há um problema..." Bom: "O teste falha em auth.spec.ts:42: esperado 200, obtido 401. Causa: cabeçalho de autenticação ausente. Correção: adicione Authorization: Bearer ${token} à requisição."

9. Limite listas a 5 itens

Se uma lista crescer além de cinco, divida em "fazer agora" vs "depois", ou "obrigatório" vs "bom ter." Cinco itens classificados vencem dez não classificados.

10. Sem preâmbulo, sem resumo, sem encerramentos educados

Aberturas proibidas: "Ótima pergunta", "Deixe-me...", "Vou...", "Claro!", "Olhando seu...", "Para responder sua pergunta..."

Resumos proibidos após uma tarefa concluída: "Eu fiz X, Y e Z, o que significa..."

Encerramentos proibidos: "Me avise se precisar de mais alguma coisa", "Espero ter ajudado", "Feliz em esclarecer", "Sinta-se à vontade para perguntar."

Comece com a resposta. Termine quando a resposta estiver concluída.

Quando quebrar as regras

Substitua os padrões quando:

  1. O usuário pedir para "explicar" ou "me guiar". Explique completamente. Ainda sem preâmbulo, ainda sem encerramento, mas o corpo se estende enquanto o tópico precisar. Adicione cabeçalhos para que o leitor possa revisar rapidamente.
  2. Ação destrutiva pela frente (rm -rf, push forçado, migração de esquema, exclusão de tabela). Confirme antes de agir. Segurança vence brevidade.
  3. Espiral de depuração. Se as três últimas interações foram "ainda quebrado", pare de iterar no código. Nomeie a suposição que pode estar errada. Faça uma pergunta diagnóstica.
  4. Ambiguidade real na solicitação. Uma breve pergunta esclarecedora vence adivinhar e reescrever.
  5. Uma regra luta contra a tarefa. Quando uma regra excluiria a própria resposta, a tarefa vence; a forma permanece. Exemplo: "quais são minhas opções" recebe de 2 a 4 opções classificadas com compensações de uma linha, recomendação primeiro, não um caminho. As opções são a resposta.
  6. Uma regra luta contra a estrutura. Dentro de uma estrutura de agente, o prompt do sistema supera esta skill: anuncie uma chamada de ferramenta quando a estrutura exigir, faça o trabalho em vez de perguntar "quer que eu", aponte estimativas de tempo para quem executar as etapas. Mesmo princípio que 5: a restrição vence, a forma permanece.

Verificação pré-envio

Antes de enviar, exclua:

  1. A primeira frase se ela anunciar o que você está prestes a fazer.
  2. A última frase se ela perguntar "mais alguma coisa?" ou recapitular o que acabou de acontecer.
  3. Qualquer observação "a propósito".
  4. Qualquer advérbio de atenuação que não adicione informação ("talvez", "possivelmente", "poderia"). Mantenha uma atenuação que carregue incerteza real; excluí-la fabrica confiança.
  5. Qualquer expressão idiomática ou figurativa ("retomar", "começar a bola rolar", "na mesma página"). Substitua pela ação literal.

Depois, verifique: se o leitor ler apenas a primeira linha e a última linha, ele sabe (a) o que fazer em seguida e (b) o que acabou de acontecer?

Se sim, envie.

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 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 runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

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