canvas

Descripción general de la skill canvas

Qué hace canvas

La skill canvas crea diagramas JSON Canvas con posicionamiento libre, lo que la convierte en una muy buena opción para mapas mentales, grafos de conocimiento, mapas conceptuales y tableros de planificación. Está pensada para casos en los que el diseño importa más que la secuencia, y usa coordenadas explícitas x/y para que el diagrama se coloque con intención, en lugar de dejar que el modelo lo adivine.

Casos de uso ideales

Usa esta skill canvas cuando necesites un diagrama espacial que se lea como un mapa: ideas agrupadas, notas enlazadas, estructuras de investigación o planificación visual. Es especialmente útil en flujos de trabajo de Diagramming cuando quieres que los nodos, las etiquetas y las relaciones sean editables y compatibles con una salida estilo Obsidian Canvas.

Cuándo no usarla

Si tu objetivo es un proceso paso a paso, elige mejor una skill de flowchart o estilo UML. Si necesitas visualización de datos, gráficos o comparación numérica, canvas no es la herramienta adecuada. El principal obstáculo para adoptarla es esperar un flujo narrativo automático de un formato diseñado para la disposición espacial.

Cómo usar la skill canvas

Instala y localiza la fuente

Ejecuta npx skills add markdown-viewer/skills --skill canvas para instalar la skill canvas. Después de instalarla, lee primero SKILL.md y luego abre references/syntax.md para ver las reglas y ejemplos de atributos. Este repo tiene un solo archivo de referencia de apoyo, así que no necesitas buscar entre una estructura de archivos grande.

Qué incluir en tu prompt

Una buena solicitud para canvas debería incluir: el tema, los grupos principales, el número de nodos, los enlaces obligatorios, la dirección de lectura preferida y si el diagrama debe ser compacto o espacioso. Por ejemplo, en vez de “haz un canvas sobre estrategia de producto”, pide “un canvas para Diagramming de un taller de estrategia de producto con 1 nodo central, 4 grupos de trabajo, 12 notas secundarias y enlaces entre riesgos y dependencias”.

Flujo de trabajo práctico

Empieza por el contenido, no por el diseño. Dale primero al modelo el material en bruto y luego pídele que coloque los nodos en una cuadrícula y los conecte. Un prompt sólido para canvas suele decir qué debe ir en los nodos de texto, qué debe agruparse y qué debe enlazarse. Si ya conoces la estructura, nombra los grupos de forma explícita para que la skill pueda asignar las coordenadas de manera coherente.

Archivos y reglas que debes revisar primero

Lee references/syntax.md para confirmar los campos obligatorios de los nodos, los tipos de nodo compatibles y las opciones de color. En SKILL.md, las reglas más importantes son la estructura JSON, los requisitos de los nodos y el formato de conexión de aristas. Esos son los detalles que más a menudo rompen la instalación o el uso de canvas cuando se pasan por alto.

Preguntas frecuentes sobre la skill canvas

¿canvas es solo para Obsidian Canvas?

No. El formato es compatible con Obsidian Canvas, pero la skill canvas en realidad se centra en generar diagramas JSON Canvas que pueden usarse en visores y flujos de trabajo compatibles. Si ya trabajas con sistemas de notas basados en canvas, encaja de forma natural.

¿Qué diferencia a canvas de un prompt normal?

Un prompt normal puede describir un diagrama en prosa; canvas produce datos de diagrama estructurados con nodos, posiciones y aristas. Eso lo hace mejor para tareas repetibles de Diagramming, más fácil de editar y más limpio para usos posteriores. También reduce la incertidumbre sobre el diseño, que en la práctica es la diferencia más importante.

¿canvas es apta para principiantes?

Sí, si puedes describir el contenido con claridad. No necesitas conocer de antemano la sintaxis JSON, pero sí debes aportar una estructura sensata. Los principiantes obtienen mejores resultados cuando especifican primero un número reducido de grupos y luego lo amplían con nodos secundarios.

¿Cuándo debería evitar canvas?

Evítala cuando la salida deba ser un mapa de proceso, un diagrama de secuencia o un gráfico analítico. También resulta menos útil si no puedes definir las relaciones entre ideas, porque la skill depende de una colocación de nodos y unas aristas con sentido.

Cómo mejorar la skill canvas

Dale al modelo un briefing de diseño

La forma más rápida de mejorar la salida de canvas es especificar la topología, no solo el tema. Indica si el centro debe ramificarse hacia fuera, si los grupos deben ir separados y qué nodos merecen énfasis visual. Para una solicitud de guía en canvas, detalles como “tres grupos, lectura de izquierda a derecha, un nodo de resumen por grupo” son mucho más útiles que “haz que se vea bonito”.

Aporta el contenido completo de los nodos

El uso sólido de canvas depende de tener listas las etiquetas reales. Si solo das un tema, el modelo tendrá que inventar la estructura y puede generar nodos genéricos. Una mejor entrada sería algo como: “Nodo central: Customer onboarding. Grupo A: pasos de adquisición. Grupo B: riesgos de activación. Grupo C: materiales de soporte. Incluye 2 enlaces desde riesgos hacia materiales de soporte”.

Vigila los fallos más comunes

Los problemas más habituales son campos obligatorios ausentes, nodos superpuestos, demasiados nodos en un mismo grupo y aristas que no reflejan la relación prevista. Otro problema frecuente es pedir tipos de diagrama que no encajan en canvas. Si ocurre, ajusta el prompt indicando qué debe ir como nodos de texto, qué debe ir como nodos de archivo o enlace y a qué distancia deben quedar los grupos entre sí.

Itera con una segunda pasada más precisa

Si la primera salida es estructuralmente correcta pero débil a nivel visual, pide un canvas revisado con más separación, etiquetas más cortas o una jerarquía de grupos más clara. Si la primera salida es conceptualmente débil, sustituye etiquetas vagas por sustantivos y verbos concretos. La mejora más fiable viene de darle a la skill canvas mejor contenido de origen, no solo de pedir un diseño más bonito.