Графы навыков > SKILL.md

Люди недооценивают силу структурированных знаний. это делает возможным создание совершенно новых видов приложений

сейчас люди пишут навыки, которые охватывают лишь один аспект чего-либо. навык для саммаризации, навык для код-ревью и так далее. (часто) один файл с одной возможностью

это нормально для простых задач, но для настоящей глубины требуется нечто иное

представьте себе терапевтический навык, который предоставляет актуальную информацию о когнитивно-поведенческих паттернах, теории привязанности, техниках активного слушания, фреймворках эмоциональной регуляции и так далее

один файл навыка не может вместить всё это

графы навыков

граф навыков — это сеть файлов навыков, соединенных вики-ссылками

вместо одного большого файла у вас есть множество маленьких компонуемых фрагментов, ссылающихся друг на друга. каждый файл — это одна законченная мысль, техника или навык, а [[вики-ссылки между ними создают проходимый граф]]

граф навыков применяет тот же паттерн обнаружения навыков рекурсивно внутри самого графа

у каждого узла есть yaml-описание, которое агент может сканировать, не читая файл целиком

каждая вики-ссылка несет смысл, так как она вплетена в текст, поэтому агент следует по релевантным путям и пропускает то, что не важно

прогрессивное раскрытие:

индекс → описания → ссылки → разделы → полный контент

большинство решений принимается до прочтения хотя бы одного полного файла

примитивы

у вас уже есть всё необходимое

• вики-ссылки, которые читаются как связный текст в предложениях, поэтому они несут смысл, а не просто являются ссылками
• YAML frontmatter с описаниями, чтобы агент мог сканировать их без чтения полных файлов
• MOC (карты контента), которые организуют кластеры связанных навыков в навигационные подтемы

навык ссылается на другие навыки, которые ссылаются на третьи, и граф уходит настолько глубоко, насколько требует предметная область

плагин arscontexta

arscontexta — это граф навыков, который учит вашего агента строить графы навыков

(ладно, на самом деле он о создании баз знаний, но это одно и то же...)

~250 связанных markdown-файлов, которые учат агента создавать для вас огромную базу знаний, она же граф навыков

один файл навыка не смог бы этого сделать

но всё меняется, если вы строите граф взаимосвязанных исследовательских утверждений (/навыков) о когнитивной науке, zettelkasten, теории графов, архитектуре агентов, где каждая часть ссылается на другие, каждая компонуема, и всё это проходимо

что это дает

подумайте об этом:

• граф навыков трейдинга: управление рисками, психология рынка, расчет размера позиции, технический анализ — каждая часть связана с родственными концепциями, чтобы контекст перетекал между ними
• юридический граф навыков: шаблоны договоров, требования комплаенса, специфика юрисдикции, цепочки прецедентов — всё доступно для прохождения от одной точки входа
• корпоративный граф навыков: оргструктура, знания о продукте, процессы, контекст онбординга, культура, конкурентный ландшафт

ничто из этого не поместится в один файл, но всё это работает как графы

как построить такой граф

легкий способ: установите плагин arscontexta claude code, выберите пресет исследования и укажите любую тему

он настроит структуру папок markdown за вас, а затем вы заполните её с помощью /learn и /reduce

ручной способ проще, чем вы думаете

граф навыков не обязательно должен находиться в вашей папке .claude/skills/. главное — это индексный файл, который сообщает агенту, что существует и как по этому перемещаться

вот как выглядит индекс для графа навыков умственного труда:

# knowledge-work

Agents need tools for thought too. Just as Zettelkasten, evergreen notes, and memory palaces gave humans external structures to think with, agent-operated knowledge systems give agents external structures to think with.

## Synthesis

Developed arguments about how the pieces fit together:

- [[the system is the argument]] — philosophy with proof of work; every note, link, and MOC demonstrates the methodology it describes
- [[coherent architecture emerges from wiki links spreading activation and small-world topology]] — the foundational triangle that answers what structure looks like, why it works, how agents navigate it, and when to reassess
...

## Topic MOCs

The domain breaks into seven interconnected areas:

- [[graph-structure]] — how wiki links, topology, and linking patterns create traversable knowledge graphs
- [[agent-cognition]] — how agents think through external structures: traversal, sessions, attention limits
  - [[agent-cognition-hooks]] — hook enforcement, composition, and cognitive science of automated quality
  - [[agent-cognition-platforms]] — platform capability tiers, abstraction layers, context file architecture
- [[discovery-retrieval]] — how descriptions, progressive disclosure, and search enable finding and loading content
- [[processing-workflow]] — how throughput, sessions, and handoffs move work through the system
...

## Cross-Domain Claims

- [[forced engagement produces weak connections]] — the social analog of accretion over productivity: forcing engagement for activity's sake produces shallow connections, just as accumulation without synthesis produces shallow knowledge graphs

## Explorations Needed

- Missing: comparison between human and agent traversal patterns. do agents need different architectures?
- Scaling limits: at what system size does human curation fail?

индекс — это не таблица поиска, это точка входа, направляющая внимание. агент читает его, понимает ландшафт и переходит по ссылкам, которые важны для текущего разговора

каждый связанный файл — это самостоятельное методологическое утверждение (= навык). вот как выглядит один узел:

посмотрите, как вики-ссылки внутри текста подсказывают агенту, когда и зачем переходить по ним

карты контента (MOC) организуют подтемы, когда граф становится больше.

эволюция

навыки — это инжиниринг контекста, по сути, кураторские знания, внедряемые там, где это важно

графы навыков — это следующий шаг

вместо одной инъекции агент перемещается по структуре знаний, подтягивая именно то, что требует текущая ситуация

в этом разница между агентом, который следует инструкциям, и агентом, который понимает предметную область

arscontexta — это плагин claude code, который делает это для создания систем знаний. 249 файлов структурированных знаний, по которым агент проходит, чтобы создать локальную систему знаний, действительно подходящую под ваш рабочий процесс

используйте его и стройте графы навыков для всего остального

Это перевод статьи из X.com. Оригинал