own-words

npx add-mcp 'https://own-words-mcp.alexslkmain.workers.dev/mcp'

own-words

own-words transforma um tópico em um baralho de cartões de perguntas. Cada cartão faz uma pergunta, você digita sua resposta, e só então a resposta preparada aparece; você marca "Eu sabia" ou "ver de novo" e segue em frente.

Eu tenho TDAH. Ler uma resposta preparada primeiro sempre parecia entendimento, e então a próxima pergunta real descobria que não era. Digitar minha própria resposta primeiro foi o que funcionou, então o baralho agora me faz fazer isso antes de me mostrar qualquer coisa.

Novo aqui? Experimente o tutorial de 2 minutos.

Experimente, nada para instalar

https://alexslkgit.github.io/own-words/

Dois baralhos estão nessa página: "Como o own-words funciona", 8 cartões, e "Claude Code em 30 perguntas", 30 cartões. Abra um, responda três ou quatro cartões, e você já viu a coisa toda.

Crie seu próprio baralho

Sem conta para nada disso.

Cole o JSON do baralho na caixa da página inicial. Uma resposta cercada por cercas ou uma linha de chat ao redor do JSON é aceitável; a caixa encontra o baralho dentro dela.

Pressione "Copiar o prompt" na mesma página, entregue o prompt a qualquer assistente junto com seu tópico, e cole de volta o que ele responder.

Instale o plugin do Claude Code:

claude plugin marketplace add alexslkgit/own-words
claude plugin install own-words@own-words

Depois execute /own-words com um tópico ou um arquivo. Ele escreve <topic-slug>.deck.json no diretório atual, verifica e imprime o link que o abre.

Um baralho é um único arquivo JSON: uma chave, um título e blocos de cartões, cada cartão uma pergunta e uma resposta. Os dois baralhos acima estão em decks/ exatamente nessa forma, sem nada neles que o formato não te dê. O arquivo também é como um baralho vai para outro dispositivo: o link para a demonstração de 30 cartões tem cerca de 17 KB porque o baralho inteiro viaja dentro dele, então mantenha baralhos longos como arquivos e compartilhe o link para os curtos.

Um cartão também pode carregar um peso, "w": 1 a 100. Quando qualquer cartão em um baralho tem um, três paradas no cabeçalho mostram o baralho inteiro, apenas cartões com peso 60 ou mais, ou apenas 85 ou mais, então uma sessão curta cobre o que mais importa. Um cartão sem peso é sempre mostrado.

Quando uma resposta é difícil demais para ler

Assim que a resposta é mostrada, toque nas palavras que você não entende, ou selecione uma frase, e então pressione "Mais simples, não mais longo". A página constrói uma solicitação cujo orçamento de palavras é o comprimento da própria resposta; envie para o Claude ou qualquer chat e cole a resposta de volta. A página recusa uma resposta com mais palavras do que o orçamento, então o cartão fica mais claro sem crescer. Com o plugin, o Claude Code também escreve a versão mais simples no seu .deck.json ao lado da resposta original, que ele nunca altera. Por exemplo, com "existencial" e "tabela de testemunhas" marcados:

Antes, 30 palavras: some nomeia um tipo concreto que o compilador conhece mas esconde, enquanto any é uma caixa existencial resolvida em tempo de execução através de uma tabela de testemunhas, então suas chamadas não podem ser especializadas.

Depois, 26 palavras: some: um tipo real que o compilador conhece, apenas sem nome. any: uma caixa (aceita qualquer tipo correspondente) aberta em tempo de execução, então suas chamadas não podem ser especializadas.

Onde o baralho vive

O link carrega o baralho inteiro dentro da URL, depois de #d=, comprimido com lz-string. Um fragmento de URL nunca é enviado na solicitação HTTP, então um link de baralho abre sem que nenhum servidor segure o baralho. deck.html renderiza qualquer baralho que recebe e não sabe mais nada.

Cada baralho que você abre é mantido no localStorage deste navegador, sob ownwords:decks:<key> e ownwords:index, junto com suas respostas e marcações; a página inicial os lista sob "Meus baralhos". Não há conta e nada que você escreve é armazenado em um servidor. Limpar os dados do site para a página remove os baralhos e o progresso, e "Meus baralhos" esvazia; o arquivo .deck.json ou o link traz um baralho de volta, o progresso não volta.

A única vez que seu texto se move é o botão de copiar em uma página de cartão. Ele constrói uma forma de texto simples do baralho: cada cartão que você tocou, com a pergunta, suas próprias palavras e sua marcação, e então os números dos cartões que você deixou de lado. Nada é copiado até você pressionar. Colar esse formulário de volta no chat que escreveu o baralho é como você pede cartões mais difíceis.

HTML e JavaScript simples, sem etapa de build, uma dependência vendida (lz-string). As páginas pedem ao Google Fonts duas tipografias; bloqueie isso e tudo ainda funciona com uma fonte do sistema, inclusive a partir de um caminho file://.

connector/ é um pequeno servidor MCP remoto para que o claude.ai possa te entregar um link de baralho diretamente. Uma instância pública roda em https://own-words-mcp.alexslkmain.workers.dev/mcp: no claude.ai abra Configurações > Conectores > Adicionar conector personalizado, cole essa URL e escolha Sem login. Ele não mantém estado e não armazena nada, o baralho vai para o link. Para rodar o seu próprio, veja connector/README.md.

Desinstalar

claude plugin uninstall own-words@own-words
claude plugin marketplace remove own-words

O site não precisa de nada instalado, então fechar a aba é suficiente.

Requisitos

Um navegador moderno, para o site e para qualquer link de baralho. O plugin precisa do Claude Code.

Esta é a ferramenta de uma pessoa na versão 0.3.0. Eu a uso diariamente nos meus próprios baralhos; as strings em inglês nela são novas, então se uma linha parecer estranha, é por isso.

Se você experimentou em algo que realmente precisava aprender, escrever sua própria resposta primeiro mudou o que você lembrou uma semana depois? Abra uma issue e me conte: https://github.com/alexslkgit/own-words/issues

MIT, veja LICENSE.