La gente subestima el poder del conocimiento estructurado. Permite tipos de aplicaciones completamente nuevos.
Ahora mismo la gente escribe skills que capturan un solo aspecto de algo. Un skill para resumir, un skill para revisión de código, etc. (A menudo) un archivo con una capacidad.
Eso está bien para tareas simples, pero la profundidad real requiere algo más.
Imagina un skill de terapia que proporcione información relevante sobre patrones cognitivos conductuales, teoría del apego, técnicas de escucha activa, marcos de regulación emocional, etc.
Un solo archivo de skill no puede contener eso.
Skill Graphs
Un skill graph es una red de archivos de skill conectados mediante wikilinks.
En lugar de un archivo grande, tienes muchas piezas pequeñas y componibles que se referencian entre sí. Cada archivo es un pensamiento completo, técnica o skill, y [[los wikilinks entre ellos crean un grafo navegable]]
Un skill graph aplica el mismo patrón de descubrimiento de skills de forma recursiva dentro del propio grafo.
Cada nodo tiene una descripción YAML que el agente puede escanear sin leer el archivo completo.
Cada wikilink tiene significado porque está integrado en la prosa, así que el agente sigue rutas relevantes y omite lo que no importa.
Divulgación progresiva:
índice → descripciones → enlaces → secciones → contenido completo
La mayoría de las decisiones ocurren antes de leer un solo archivo completo.
Los Primitivos
Ya tienes todo lo que necesitas.
- Wikilinks que se leen como prosa en las oraciones, por lo que transmiten significado, no solo referencias.
- Frontmatter YAML con descripciones para que el agente pueda escanear sin leer archivos completos.
- MOCs (Mapas de Contenido) que organizan grupos de skills relacionados en subtemas navegables.
Un skill enlaza a otros skills, que enlazan a otros skills, y el grafo se profundiza tanto como el dominio lo requiera.
El Plugin Arscontexta
Arscontexta es un skill graph que le enseña a tu agente cómo construir skill graphs.
(Bueno, en realidad se trata de construir bases de conocimiento, pero es lo mismo...)
~250 archivos Markdown interconectados que enseñan a un agente cómo construir una base de conocimiento masiva, es decir, un skill graph para ti.
Un solo archivo de skill no podría hacer eso.
Pero las cosas cambian si construyes un grafo de afirmaciones de investigación (o skills) interconectadas sobre ciencia cognitiva, Zettelkasten, teoría de grafos, arquitectura de agentes, donde cada pieza enlaza con otras, cada una es componible y todo el conjunto es navegable.
Lo que Esto Permite
Piénsalo:
- Un skill graph de trading: gestión de riesgos, psicología del mercado, dimensionamiento de posiciones, análisis técnico; cada pieza enlazada a conceptos relacionados para que el contexto fluya entre ellas.
- Un skill graph legal: patrones contractuales, requisitos de cumplimiento, especificidades jurisdiccionales, cadenas de precedentes; todo navegable desde un solo punto de entrada.
- Un skill graph empresarial: estructura organizativa, conocimiento del producto, procesos, contexto de incorporación, cultura, panorama competitivo.
Ninguno de estos cabe en un solo archivo, pero todos funcionan como grafos.
Cómo Construir Uno
La forma fácil: instala el plugin arscontexta para Claude Code, selecciona el preset de investigación y apúntalo a cualquier tema.
Él configura la estructura de carpetas Markdown por ti y luego la llenas con /learn y /reduce.
La forma manual es más simple de lo que crees.
Un skill graph no necesita vivir en tu carpeta .claude/skills/. La clave es un archivo índice que le dice al agente qué existe y cómo navegarlo.
Así es como se ve un índice para un skill graph de trabajo de conocimiento:
1# trabajo-de-conocimiento23Los agentes también necesitan herramientas para pensar. Así como Zettelkasten, las notas permanentes y los palacios de la memoria le dieron a los humanos estructuras externas para pensar, los sistemas de conocimiento operados por agentes les dan a los agentes estructuras externas para pensar.45## Síntesis67Argumentos desarrollados sobre cómo encajan las piezas:89- [[el sistema es el argumento]] — filosofía con prueba de trabajo; cada nota, enlace y MOC demuestra la metodología que describe10- [[la arquitectura coherente emerge de wikilinks propagación de activación y topología de mundo pequeño]] — el triángulo fundamental que responde cómo es la estructura, por qué funciona, cómo la navegan los agentes y cuándo reevaluar11...1213## MOCs por Tema1415El dominio se divide en siete áreas interconectadas:1617- [[estructura-del-grafo]] — cómo los wikilinks, la topología y los patrones de enlace crean grafos de conocimiento navegables18- [[cognición-del-agente]] — cómo piensan los agentes a través de estructuras externas: navegación, sesiones, límites de atención19 - [[cognición-del-agente-ganchos]] — cumplimiento de ganchos, composición y ciencia cognitiva de la calidad automatizada20 - [[cognición-del-agente-plataformas]] — niveles de capacidad de plataforma, capas de abstracción, arquitectura de archivos de contexto21- [[descubrimiento-recuperación]] — cómo las descripciones, la divulgación progresiva y la búsqueda permiten encontrar y cargar contenido22- [[procesamiento-flujo-de-trabajo]] — cómo el rendimiento, las sesiones y las transferencias mueven el trabajo a través del sistema23...2425## Afirmaciones Transversales2627- [[la participación forzada produce conexiones débiles]] — el análogo social de la acumulación sobre la productividad: forzar la participación por el simple hecho de hacerlo produce conexiones superficiales, así como la acumulación sin síntesis produce grafos de conocimiento superficiales2829## Exploraciones Necesarias3031- Falta: comparación entre patrones de navegación humanos y de agentes. ¿Necesitan los agentes arquitecturas diferentes?32- Límites de escalabilidad: ¿a qué tamaño del sistema falla la curación humana?
El índice no es una tabla de búsqueda; es un punto de entrada que dirige la atención. El agente lo lee, comprende el panorama y sigue los enlaces que importan para la conversación actual.
Cada archivo enlazado es una afirmación metodológica independiente (= skill). Así es como se ve un nodo:

Observa cómo los wikilinks dentro de la prosa le indican al agente cuándo y por qué seguirlos.
Un mapa de contenido (MOC) organiza los subtemas cuando el grafo se vuelve más grande.
La Evolución
Los skills son ingeniería de contexto, básicamente conocimiento curado inyectado donde importa.
Los skill graphs son el siguiente paso.
En lugar de una sola inyección, el agente navega una estructura de conocimiento, extrayendo exactamente lo que la situación actual requiere.
Esta es la diferencia entre un agente que sigue instrucciones y un agente que entiende un dominio.
Arscontexta es un plugin de Claude Code que hace esto para construir sistemas de conocimiento. 249 archivos de conocimiento estructurado que el agente recorre para derivar un sistema de conocimiento local que realmente se adapte a tu flujo de trabajo.
Úsalo y construye skill graphs para todo lo demás.
Heinrich





