skills README

The project's README from github.com/almendili/skills. As one markdown file: README.md.

skills

Agent skills — portable instruction packs in the SKILL.md format, usable by any harness that reads it (Claude Code, Codex, Cursor, Gemini CLI, and others).

Skill What it does
architecture-map Builds an interactive isometric map of a repository — buildings sized by real measurements, flows tracing real call paths, and a drift counter that fails CI when the map falls behind the code.

Installing

Skills are discovered from a directory your tool scans. Symlink rather than copy, so git pull here updates every install at once:

# Claude Code (global, all projects)
ln -s "$PWD/architecture-map" ~/.claude/skills/architecture-map

# Codex
ln -s "$PWD/architecture-map" ~/.codex/skills/architecture-map

# Tools using the shared convention
ln -s "$PWD/architecture-map" ~/.agents/skills/architecture-map

# Scoped to one project, whatever the tool
ln -s "$PWD/architecture-map" /path/to/repo/.claude/skills/architecture-map

Create the target directory first if it does not exist. Skills load when a session starts, so open a new one afterwards.

What is in a skill

Portability

Nothing here depends on a specific harness. Where a skill wants a structured question it names one tool's mechanism as an example and gives a plain-text fallback; where it needs its own directory it resolves the path rather than reading a tool-specific environment variable.

skills (almendili/skills)

Searching Database…

382 ·GitHub
Что это?Коллекция агентских навыков — переносимых наборов инструкций в формате SKILL.md, которые может загрузить и использовать любой харнесс ИИ-агента для кодинга, включая Claude Code, Codex, Cursor и Gemini CLI.
Это кодовая библиотека или что-то другое?Это не библиотека для импорта в код — каждый навык это папка с markdown-инструкциями, опциональной справочной документацией, скриптами и ресурсами, которые ИИ-агент читает и выполняет во время работы.
Как установить эти навыки?Создайте симлинк на этот репозиторий (или отдельные папки навыков) в том каталоге, который ваш агентский харнесс сканирует на предмет навыков, при необходимости сначала создав целевой каталог.
Какие кодинг-агенты реально могут использовать эти навыки?Подойдёт любой харнесс, читающий формат SKILL.md, причём Claude Code, Codex, Cursor и Gemini CLI прямо названы поддерживаемыми.
Нужно ли что-то перезапускать после установки навыка?Да — навыки загружаются только при старте сессии, так что после подключения навыка симлинком нужно открыть новую сессию в вашем агентском инструменте.
Что делает входящий навык «architecture-map»?Он строит интерактивную изометрическую карту репозитория: здания масштабируются по реальным метрикам, потоки прослеживают реальные пути вызовов, а счётчик расхождений валит CI, когда карта перестаёт соответствовать коду.
Как навык решает, когда срабатывать?Поле description в YAML frontmatter файла SKILL.md называет ситуации, в которых навык должен применяться, а не просто описывает, что он делает, — именно с этим харнесс и сопоставляет.
Какие ещё файлы может включать навык кроме SKILL.md?У навыка могут быть папка references/ для подробностей, загружаемых только при необходимости, папка scripts/ для исполняемых файлов, которые запускает навык (пути разрешаются относительно его собственного каталога, а не целевого проекта), и папка assets/ для файлов, копируемых в проект, над которым идёт работа.
Привязаны ли эти навыки к возможностям одного конкретного ИИ-инструмента?Нет — там, где навыку нужен структурированный механизм, он называет функцию одного инструмента в качестве примера, но всегда предлагает запасной вариант на простом тексте, а путь к своему каталогу определяет сам, не полагаясь на специфичную для инструмента переменную окружения.
Creator
almendili
Size
0.1 MB
Stars
382
Updated
CommitAug 18
Age
2mo
Commits · 90 Days