tutor-setup

Descripción general de la skill tutor-setup

Qué hace tutor-setup

tutor-setup convierte materiales de aprendizaje o una base de código en un Obsidian StudyVault. Está pensado para quienes quieren un espacio de estudio estructurado, no solo un resumen en bruto: la skill puede crear notas, extraer material fuente y añadir una organización orientada a la práctica.

Para quién encaja mejor

Usa la skill tutor-setup si necesitas una forma repetible de convertir PDF, páginas web, archivos de texto o un repositorio fuente en un vault útil para estudiar o hacer onboarding. Es especialmente relevante para personas autodidactas, docentes y equipos que prefieren una base de conocimiento ligera antes que una respuesta puntual.

En qué se diferencia

Su valor principal es la configuración según el modo. tutor-setup detecta automáticamente si la carpeta actual es una fuente documental o un proyecto de código, y ajusta el flujo en consecuencia. Eso hace que tutor-setup para Skill Scaffolding sea útil cuando quieres una sola skill que gestione dos tipos de entrada muy comunes sin tener que reescribir el proceso a mano cada vez.

Cómo usar la skill tutor-setup

Instala y coloca los archivos correctamente

Ejecuta el comando de instalación desde tu entorno de skills y luego trabaja dentro del directorio de trabajo actual, porque tutor-setup impone un límite estricto de CWD. El flujo de instalación de tutor-setup depende de que los archivos fuente se copien primero en la carpeta de trabajo; no saldrá de ese límite para recuperarlos.

Dale el tipo de entrada adecuado

El patrón de uso de tutor-setup es sencillo: proporciona una ruta local de origen o una URL y deja que la skill determine el modo. Para mejores resultados, sé explícito en la petición sobre el resultado que quieres; por ejemplo: “Crea un Obsidian StudyVault a partir de estos apuntes de clase con resúmenes por capítulo y preguntas de práctica” o “Construye un vault de onboarding a partir de este repo para un nuevo desarrollador”.

Lee primero estos archivos

Empieza por SKILL.md, porque ahí se definen las reglas de detección de modo, el límite de CWD y los dos flujos de trabajo. Si tu copia los incluye, revisa references/templates.md y cualquier nota de apoyo enlazada desde la skill para entender la estructura esperada del vault antes de pedir la salida. En un contexto de repositorio, también conviene revisar README.md, AGENTS.md y cualquier carpeta rules/, resources/, references/ o scripts/ si está presente.

Consejos de prompting que cambian la calidad de salida

Indica desde el principio el tipo de fuente, el público objetivo y el nivel de profundidad. Un prompt débil como “usa tutor-setup en esta carpeta” deja demasiado a la inferencia; uno más sólido dice qué debe optimizar el vault, por ejemplo preparación de exámenes, onboarding o repaso rápido. Si estás usando tutor-setup para Skill Scaffolding, incluye la forma deseada de la salida, el nivel de granularidad de las notas y cualquier restricción sobre terminología, tono o nombres de archivo.

Preguntas frecuentes sobre la skill tutor-setup

¿Es tutor-setup mejor que un prompt normal?

Sí, cuando quieres un flujo repetible con límites más claros y selección de modo. Un prompt normal puede resumir contenido, pero tutor-setup añade un proceso más explícito para descubrir documentos, manejar fuentes y crear el vault.

¿Cuándo no debería usar tutor-setup?

No lo uses si tus archivos fuente están fuera del directorio de trabajo actual y no puedes copiarlos antes. Tampoco es una buena opción si solo quieres una respuesta breve, porque la skill está pensada para producir un StudyVault estructurado y no una explicación rápida.

¿Es tutor-setup apta para principiantes?

Sí, si puedes apuntarla a una carpeta y describir el resultado de estudio que buscas. El principal riesgo para principiantes es aportar una entrada demasiado vaga; la skill funciona mejor cuando especificas si quieres notas de estudio, preguntas de práctica o un vault de onboarding para desarrolladores.

¿tutor-setup funciona tanto para documentación como para código?

Sí. Esa es una de sus fortalezas principales: tutor-setup detecta automáticamente Document Mode o Codebase Mode a partir del contenido de CWD. Si la carpeta es ambigua, confirma el modo en tu prompt para que el flujo siga alineado con tu intención.

Cómo mejorar la skill tutor-setup

Dale material fuente más limpio

Las mejores salidas de tutor-setup salen de entradas bien acotadas: una sola carpeta, un conjunto de fuentes claro y archivos fáciles de clasificar. Si el material está desordenado, mezclado o duplicado, el vault suele heredar esa confusión.

Especifica el uso final, no solo la fuente

Dile a tutor-setup para qué servirá el vault: repaso de exámenes, retención de conceptos, onboarding de equipo o incorporación a un proyecto. Esa decisión influye en qué se destaca en las notas, qué secciones merecen más detalle y cómo deben formularse las preguntas de práctica.

Revisa el primer vault para detectar errores de modo

El fallo más común es una selección de modo incorrecta o una estructura demasiado genérica. Si la primera pasada no encaja, afina el prompt nombrando el tipo de fuente, confirmando el modo y señalando las carpetas o documentos más importantes antes de pedir una revisión.

Itera con restricciones concretas

Para usar mejor tutor-setup, pide revisiones específicas en lugar de volver a ejecutar todo. Por ejemplo: “reduce la profundidad de las notas”, “añade más preguntas de práctica”, “enfócate en la terminología de onboarding” o “divide los temas densos en notas de estudio más pequeñas”. Así mantienes la salida alineada sin perder la estructura que la skill ya creó.