La gente subestima el poder del conocimiento estructurado. Permite tipos de aplicaciones completamente nuevos.
Ahora mismo la gente escribe habilidades que capturan un aspecto de algo. Una habilidad para resumir, una 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 una habilidad de terapia que proporcione información relevante sobre patrones cognitivo-conductuales, teoría del apego, técnicas de escucha activa, marcos de regulación emocional, etc.
Un solo archivo de habilidad no puede contener eso.
Grafos de habilidades
Un grafo de habilidades es una red de archivos de habilidad conectados con wikilinks.
En lugar de un archivo grande, tienes muchas piezas pequeñas y componibles que se referencian entre sí. Cada archivo es un pensamiento, técnica o habilidad completa, y [[los wikilinks entre ellos crean un grafo navegable]].
Un grafo de habilidades aplica el mismo patrón de descubrimiento de habilidades recursivamente 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á entretejido en la prosa, así que el agente sigue las rutas relevantes y salta 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.
Las primitivas
Ya tienes todo lo que necesitas.
- Wikilinks que se leen como prosa en oraciones, así que llevan 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 habilidades relacionadas en subtemas navegables
Las habilidades enlazan a otras habilidades que enlazan a otras habilidades, y el grafo se profundiza tanto como el dominio lo requiera.
Plugin arscontexta
arscontexta es un grafo de habilidades que enseña a tu agente cómo construir grafos de habilidades.
(Bueno, en realidad se trata de construir bases de conocimiento, pero es lo mismo...)
~250 archivos Markdown conectados que enseñan a un agente cómo construir una base de conocimiento masiva, también conocida como grafo de habilidades, para ti.
Un solo archivo de habilidad no podría hacer eso.
Pero las cosas cambian si construyes un grafo de afirmaciones de investigación (/habilidades) interconectadas sobre ciencia cognitiva, zettelkasten, teoría de grafos, arquitectura de agentes, donde cada pieza enlaza a otras, cada una es componible y todo es navegable.
Lo que esto permite
Piénsalo:
- Un grafo de habilidades de trading: gestión de riesgos, psicología del mercado, dimensionamiento de posiciones, análisis técnico, cada pieza vinculada a conceptos relacionados para que el contexto fluya entre ellos.
- Un grafo de habilidades legales: patrones de contratos, requisitos de cumplimiento, especificidades de jurisdicción, cadenas de precedentes, todo navegable desde un punto de entrada.
- Un grafo de habilidades de empresa: 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 de Claude Code, elige el preset de investigación y apúntalo a cualquier tema.
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 piensas.
Un grafo de habilidades 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 grafo de habilidades de trabajo de conocimiento:
1# trabajo-de-conocimiento23Los agentes también necesitan herramientas para pensar. Así como el Zettelkasten, las notas perennes y los palacios de memoria dieron a los humanos estructuras externas para pensar, los sistemas de conocimiento operados por agentes 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 surge de la propagación de wikilinks y la topología de mundo pequeño]] — el triángulo fundamental que responde cómo se ve la estructura, por qué funciona, cómo los agentes la navegan y cuándo reevaluar11...1213## MOCs por tema1415El dominio se divide en siete áreas interconectadas:1617- [[estructura-de-grafo]] — cómo los wikilinks, la topología y los patrones de enlace crean grafos de conocimiento navegables18- [[cognición-de-agente]] — cómo los agentes piensan a través de estructuras externas: navegación, sesiones, límites de atención19 - [[ganchos-de-cognición-de-agente]] — cumplimiento de ganchos, composición y ciencia cognitiva de la calidad automatizada20 - [[plataformas-de-cognición-de-agente]] — 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 entre dominios2627- [[el compromiso forzado produce conexiones débiles]] — el análogo social de la acumulación sobre la productividad: forzar el compromiso por el simple hecho de la actividad 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 escalado: ¿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, entiende el panorama y sigue los enlaces que importan para la conversación actual.
Cada archivo enlazado es una afirmación metodológica independiente (= habilidad). Así es como se ve un nodo:
Observa cómo los wikilinks dentro de la prosa le dicen al agente cuándo y por qué seguirlos.
Un mapa de contenidos (MOCs) organiza subtemas cuando el grafo se vuelve más grande.
La evolución
Las habilidades son ingeniería de contexto, básicamente conocimiento curado inyectado donde importa.
Los grafos de habilidades son el siguiente paso.
En lugar de una inyección, el agente navega una estructura de conocimiento, trayendo 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 adapta a tu flujo de trabajo.
Úsalo y construye grafos de habilidades para todo lo demás.
heinrich
