own-words

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

own-words

own-words convierte un tema en un mazo de tarjetas de preguntas. Cada tarjeta hace una pregunta, tú escribes tu respuesta, y solo entonces aparece la respuesta preparada; la marcas como "lo sabía" o "ver de nuevo" y continúas.

Tengo TDAH. Leer primero una respuesta preparada siempre se sentía como comprensión, y luego la siguiente pregunta real descubría que no lo era. Escribir mi propia respuesta primero es lo que funcionó, así que el mazo ahora me obliga a hacerlo antes de mostrarme nada.

¿Nuevo aquí? Prueba el tutorial de 2 minutos.

Pruébalo, no hay nada que instalar

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

Hay dos mazos en esa página: "Cómo funciona own-words", 8 tarjetas, y "Claude Code en 30 preguntas", 30 tarjetas. Abre uno, responde tres o cuatro tarjetas, y ya has visto todo el asunto.

Crea tu propio mazo

No se necesita cuenta para nada de esto.

Pega el JSON del mazo en el cuadro de la página de inicio. Una respuesta entre comillas o una línea de chat alrededor del JSON está bien; el cuadro encuentra el mazo dentro de él.

Pulsa "Copiar el prompt" en la misma página, entrega el prompt a cualquier asistente junto con tu tema, y pega de vuelta lo que responda.

Instala el plugin de Claude Code:

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

Luego ejecuta /own-words con un tema o un archivo. Escribe <topic-slug>.deck.json en el directorio actual, lo verifica, e imprime el enlace que lo abre.

Un mazo es un solo archivo JSON: una clave, un título y bloques de tarjetas, cada tarjeta una pregunta y una respuesta. Los dos mazos anteriores están en decks/ exactamente en esa forma, sin nada que el formato no te dé. El archivo también es cómo un mazo se mueve a otro dispositivo: el enlace para la demo de 30 tarjetas tiene unos 17 KB porque todo el mazo viaja dentro de él, así que guarda mazos largos como archivos y comparte el enlace para los cortos.

Una tarjeta también puede llevar un peso, de "w": 1 a 100. Cuando cualquier tarjeta de un mazo tiene uno, tres filtros en el encabezado muestran todo el mazo, solo tarjetas con peso 60 o más, o solo 85 o más, así que una sesión corta cubre lo que más importa. Una tarjeta sin peso siempre se muestra.

Cuando una respuesta es demasiado difícil de leer

Una vez que se muestra la respuesta, toca las palabras que no entiendes, o selecciona una frase, y luego pulsa "Simpler, not longer". La página construye una solicitud cuyo presupuesto de palabras es la longitud de la propia respuesta; envíala a Claude o a cualquier chat y pega la respuesta de vuelta. La página rechaza una respuesta con más palabras que el presupuesto, así que la tarjeta se aclara sin crecer. Con el plugin, Claude Code también escribe la versión más simple en tu .deck.json junto a la respuesta original, que nunca cambia. Por ejemplo, con "existential" y "witness table" marcados:

Antes, 30 palabras: some nombra un tipo concreto que el compilador conoce pero oculta, mientras que any es una caja existencial resuelta en tiempo de ejecución mediante una tabla de testigos, por lo que sus llamadas no pueden especializarse.

Después, 26 palabras: some: un tipo real que el compilador conoce, solo que sin nombre. any: una caja (acepta cualquier tipo que coincida) abierta en tiempo de ejecución, por lo que sus llamadas no pueden especializarse.

Dónde vive el mazo

El enlace lleva todo el mazo dentro de la URL, después de #d=, comprimido con lz-string. Un fragmento de URL nunca se envía en la solicitud HTTP, así que un enlace de mazo se abre sin que ningún servidor tenga el mazo. deck.html renderiza cualquier mazo que se le entregue y no sabe nada más.

Cada mazo que abres se guarda en el localStorage de este navegador, bajo ownwords:decks:<key> y ownwords:index, junto con tus respuestas y marcas; la página de inicio los lista bajo "Mis mazos". No hay cuenta y nada de lo que escribes se almacena en un servidor. Borrar los datos del sitio para la página elimina los mazos y el progreso, y "Mis mazos" se vacía; el archivo .deck.json o el enlace trae de vuelta un mazo, el progreso no vuelve.

La única vez que tu texto se mueve es con el botón de copiar en la página de una tarjeta. Construye una forma de texto plano del mazo: cada tarjeta que tocaste, con la pregunta, tu propia redacción y tu marca, y luego los números de las tarjetas que dejaste solas. Nada se copia hasta que lo pulsas. Pegar esa forma de vuelta en el chat que escribió el mazo es cómo pides tarjetas más difíciles.

HTML y JavaScript simples, sin paso de compilación, una dependencia incluida (lz-string). Las páginas piden a Google Fonts dos tipografías; bloquea eso y todo sigue funcionando con una fuente del sistema, incluso desde una ruta file://.

connector/ es un pequeño servidor MCP remoto para que claude.ai pueda darte un enlace de mazo directamente. Una instancia pública se ejecuta en https://own-words-mcp.alexslkmain.workers.dev/mcp: en claude.ai abre Configuración > Conectores > Añadir conector personalizado, pega esa URL y elige Sin inicio de sesión. No mantiene estado y no almacena nada, el mazo va en el enlace. Para ejecutar el tuyo, consulta connector/README.md.

Desinstalar

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

El sitio no necesita nada instalado, así que cerrar la pestaña es suficiente.

Requisitos

Un navegador moderno, para el sitio y para cualquier enlace de mazo. El plugin necesita Claude Code.

Esta es la herramienta de una persona en la versión 0.3.0. La uso a diario con mis propios mazos; las cadenas en inglés dentro de ella son nuevas, así que si una línea suena rara, esa es la razón.

Si lo probaste en algo que realmente necesitabas aprender, ¿escribir tu propia respuesta primero cambió lo que recordabas una semana después? Abre un issue y cuéntamelo: https://github.com/alexslkgit/own-words/issues

MIT, ver LICENSE.