Communitygithub.com

study-site

Úsalo al crear cualquier página de estudio, página de notas de capítulo, revisión o preparación de exámenes, o índice de estudio de un curso, a partir de diapositivas, PDFs, exámenes anteriores, hojas de ejercicios o solo un nombre de tema.

¿Qué es study-site?

Esta skill permite construir páginas HTML de estudio interactivas y autocontenidas, publicadas como artefactos (o guardadas como archivos `.html`). Cada página se basa en una plantilla (`assets/template.html`) que incluye funciones estándar como tema claro/oscuro, barra de progreso, búsqueda y diagramas SVG. La skill guía al asistente para que primero pregunte al usuario sobre el curso, capítulo y ubicación en el índice, luego recopile y lea todo el material adjunto (diapositivas, apuntes, exámenes anteriores), y finalmente construya la página siguiendo reglas pedagógicas: explicación → diagrama → explicación del diagrama → ejemplo resuelto → preguntas de exámenes anteriores → preguntas de opción múltiple. Para páginas de curso se añaden herramientas de revisión (chuletario y flashcards) y un modo examen con temporizador. La skill se adapta por tipo de asignatura (teoría, sistemas, lenguajes, matemáticas, descriptiva) y aplica diseño minimalista, sin elementos superfluos, usando colores con significado semántico.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ranjit-choudhary/claude-skills-ranjit/tree/HEAD/study-site

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Study Site

Construye páginas de estudio HTML interactivas y autocontenidas, publicadas como artefactos (o guardadas como archivos .html cuando los artefactos no están disponibles). Cada página comienza desde assets/template.html, por lo que las características estándar nunca se olvidan.

0. Ajustes — edítalos para ti

AjusteValor
URL del índice maestro (hub que enlaza todos los cursos)none — defínelo con la URL de tu hub, o deja none para omitir las actualizaciones del índice
Tema predeterminadolight (siempre se incluye un alternador de modo oscuro)
Navegación de capítulosSolo enlace de vuelta al índice del curso — sin enlaces de capítulo anterior/siguiente
Estilo de tarjeta de índiceMínimo: icono, código del curso, nombre del curso — sin estadísticas

1. Preguntar primero (una ronda de preguntas)

Pregunta solo lo que no esté claro desde la solicitud:

  1. ¿Es para un curso? Si es así: ¿qué curso, qué capítulo o fragmento? Una página de curso obtiene modo examen y herramientas de revisión además de las funciones estándar; una página que no es de curso (tema general, explicación única) los omite.
  2. ¿Dónde debe listarse? Directamente en el índice maestro, dentro de un índice de estudio del curso (¿cuál?), o en ningún lado. Omite esta pregunta si el ajuste del índice maestro es none.
  3. Si la URL del índice de estudio del curso no se conoce, pregúntala — el enlace de vuelta de la página la necesita.

Si el usuario ha guardado notas sobre cómo quiere que se enseñe un curso (memoria, instrucciones del proyecto, mensajes anteriores), léelas y síguelas por encima de los valores predeterminados a continuación.

2. Recopilar material antes de construir

  • Lee cada archivo adjunto por completo: diapositivas, apuntes, exámenes anteriores, hojas de ejercicios.
  • Recopila las preguntas de años anteriores (PYQs) y preguntas de ejercicios pertenecientes a cada tema.
  • Corrige silenciosamente los errores en el material fuente; no los señales a menos que te lo pidan.
  • Solo entonces planifica la lista de temas: una <section class="topic"> por tema lógico, lo suficientemente pequeño para terminarlo en una sola sesión.

3. Reglas de enseñanza (todas las asignaturas)

  • No asumas conocimientos previos. Construye desde lo básico, define cada término en su primer uso, elabora en lugar de comprimir.
  • Orden dentro de cada tema: explicación → su diagrama inmediatamente después → explicación del diagrama → ejemplo resuelto → PYQs/preguntas de ejercicios → preguntas de opción múltiple de práctica. Nunca agrupes los diagramas al final.
  • Cada diagrama recibe una explicación. Nunca publiques un diagrama sin explicación.
  • Marca los puntos importantes para el examen con .callout.imp y las trampas comunes con .callout.mistake.
  • Preguntas: escribe cada pregunta completa antes de su solución, nunca condensada. Responde todas las preguntas; no dejes ninguna sin responder. Etiqueta las PYQs con fuente, año y puntuación (ej. PYQ 2024 Parcial · 5M).
  • Al menos 3 preguntas de opción múltiple de práctica por tema, con distractores plausibles y una explicación .why.
  • Los diagramas son SVG en línea, nunca ASCII. Usa un .stepper (un figure.fig.step por estado) para cualquier cosa que evolucione paso a paso.
  • No incluyas planes de estudio o calendarios a menos que se te pida.

4. Adaptar por asignatura

Tipo de asignaturaÉnfasis
Teoría / demostraciones (teoría de la computación, matemáticas discretas, algoritmos)Diagramas de estado para cada autómata; steppers que recorren cadenas de entrada; plantillas de demostración (pumping lemma, reducciones, inducción) como pasos para rellenar; muchos ejemplos pequeños
Sistemas (sistemas operativos, arquitectura de computadores, redes)Visual primero; steppers para pipelines, diagramas de Gantt de planificación, reemplazo de páginas, búsquedas en caché; ejercicios numéricos resueltos paso a paso; ejercicios de final de capítulo del libro de texto
Lenguajes / notación formal (lenguajes de programación, compiladores)BNF/EBNF, árboles de análisis sintáctico y gramáticas de atributos como árboles SVG limpios; expresiones regulares construidas pieza por pieza; preguntas de ejercicios resueltas en línea
Matemáticas intensivas (aprendizaje automático, estadística, señales)Intuición primero, luego la derivación línea por línea con cada paso justificado; gráficos en SVG; ejercicios resueltos del libro de texto
Descriptiva (biología, administración, humanidades)Impulsado por exámenes anteriores: agrupar PYQs por tema, respuestas modelo con la extensión del examen, diagramas de flujo y tablas comparativas para procesos

Elige la fila más cercana para una asignatura no listada. Los propios apuntes del curso del usuario anulan esta tabla.

5. Funciones de la página (integradas en la plantilla)

FunciónCómo funcionaTu trabajo
Tema claro + alternador oscuroClaro por defecto; 🌙 alterna; la elección se recuerdaUsa solo las variables CSS — sin colores fijos
Restaurar desplazamientoLa posición se guarda y restaura al reabrirNada
Seguimiento de progreso"Marcar como hecho" por tema, barra de progreso, ✓ en el índiceid único en cada sección de tema
BúsquedaFiltra temas y resalta coincidenciasNada
Copiar imagenBotón al pasar el ratón sobre cada figure.fig que copia un PNG (siempre visible en táctil)Envuelve cada diagrama o imagen en figure.fig
Amigable para móvilesResponsivo; las tablas se desplazan lateralmenteMantén los SVG basados en viewBox; sin anchos fijos
MCQs de prácticaRetroalimentación instantánea; las respuestas se recuerdandata-answer = índice basado en 0 de la opción correcta
Mostrar respuestadetails.answerUsa para cada solución larga
Enlace de vueltaEl encabezado enlaza al índice de estudio del cursoRellena {{COURSE_INDEX_URL}}
Solo páginas de curso: herramientas de revisiónChuleta (.cheatsheet) + flashcards (.flashdeck)Resumen de una página de fórmulas, definiciones, diagramas clave; 10+ flashcards
Solo páginas de curso: modo examenDifuminado hasta que se inicia; temporizador; los MCQs se califican al enviar; respuestas modelo reveladasMezcla MCQs (data-marks) y preguntas largas con el estilo de los exámenes anteriores del curso; establece data-minutes

El progreso y las puntuaciones viven en el navegador del espectador, por página — una página de índice no puede mostrar el progreso del capítulo y nada se sincroniza entre dispositivos.

6. Reglas de diseño

  • Mínimo y tranquilo. Cuerpo con serifa para lectura larga, interfaz sin serifa. Ancho de contenido ~820px.
  • Evita el "slop" de IA: sin degradados morados, banners de héroe, diseños centrados en todo, Inter o confeti de emojis.
  • El color tiene significado: azul = información, dorado = importante para el examen, rojo = error, verde = correcto/hecho.
  • Diagramas SVG: etiqueta todo; usa var(--text), var(--accent), etc. para trazos y rellenos; texto ≥12px en ancho de móvil.

7. Páginas de índice de estudio del curso

Para un índice o hub de curso: tarjetas mínimas (ver ajustes), mismo encabezado (búsqueda + alternador de tema), restaurar desplazamiento, luz por defecto.

8. Construir, publicar, verificar

  1. Copia assets/template.html, rellena los {{placeholders}}, elimina los bloques solo de curso para páginas que no son de curso (o descoméntalos para páginas de curso).
  2. Publica como artefacto (o guarda el .html). Muéstralo primero; verifica después.
  3. Verifica en escritorio y aproximadamente 390px de ancho, en ambos temas: cada figura tiene un botón de copia, cada MCQ tiene un data-answer correcto, cada pregunta tiene una respuesta, no quedan {{placeholders}}.
  4. Agrega el enlace de la página al índice maestro o del curso según lo elegido en el paso 1. No rediseñes el índice.

Skills relacionados