Self-Learning Skills — мета-скилл для AI-агентов: сохраняем hard-won знания между сессиями

Каждая сессия с AI-агентом, где вы часами дебажите проблему или заново находите нетривиальный путь — как достучаться до продакшен-базы? где лежат креды? какая команда деплоя? как верифицировать изменения вживую? — заканчивается одинаково: знание исчезает вместе с контекстом. Следующая сессия стартует с нуля и проходит тот же путь заново.

Self-Learning Skills — мета-скилл, который учит агента распознавать момент получения «золотого пути» и сохранять его как переиспользуемый навык. Следующая сессия начинается уже с известным маршрутом.

Как это работает

Цикл одинаков для всех поддерживаемых инструментов:

1. Распознать момент — задача, которая получилась только после нескольких попыток; неочевидная команда; факт о проекте, который вы не знали заранее; операционный workflow, который точно повторится; или ваша прямая команда «запомни это».
2. Захватить, без лишних промптов — агент действует по триггеру немедленно, сам выбирает scope и имя навыка, и сообщает постфактум. Сохраняется процедура (не одноразовый ответ) плюс заметка «что не сработало».
3. Переиспользовать — в следующей сессии запись загружается автоматически: через совпадение описания навыка, через правило или через always-read instructions.

Различается только куда сохраняется знание и как авто-загружается:

Установка

npx (рекомендуется, работает с 70+ агентами)

npx skills add kulaxyz/self-learning-skills                 # проект (авто-определение агентов)
npx skills add kulaxyz/self-learning-skills -g              # глобально — все проекты
npx skills add kulaxyz/self-learning-skills -a claude-code  # конкретный агент

Разовый запуск без установки:

npx skills use kulaxyz/self-learning-skills --skill self-learning | claude

Claude Code plugin

/plugin marketplace add kulaxyz/self-learning-skills
/plugin install self-learning@self-learning-skills

Ручная установка

git clone https://github.com/kulaxyz/self-learning-skills

# Claude Code — глобально (или в .claude/skills/ проекта для шаринга через git)
cp -R self-learning-skills/skills/self-learning ~/.claude/skills/

# Cursor — авто-загрузка .cursor/rules/
mkdir -p .cursor/rules
cp self-learning-skills/.cursor/rules/self-learning.mdc .cursor/rules/

# Любой AGENTS.md-агент (Codex, Zed, Aider, Gemini CLI, …)
curl https://raw.githubusercontent.com/kulaxyz/self-learning-skills/main/AGENTS.md >> AGENTS.md

Триаж: скилл, заметка или пропустить?

Агент не засоряет конфигурацию однострочниками. Каждый урок маршрутизируется:

Правило промоушна: не канонизируем догадки

Триаж определяет детализацию; правило промоушна — уверенность. Навык авторитетен — следующая сессия доверяет ему без перепроверки — поэтому сессия повышается до навыка только при соблюдении всех трёх условий:

1. Прёйденная проверка — путь действительно верифицирован (тест пройден, чистый выход, зелёная сборка, воспроизводимый repro). «Вроде сработало» не считается.
2. Именованный паттерн отказа — назван конкретный сбой, который навык избегает или диагностирует.
3. Минимум один отброшенный тупик — конкретный подход, который был испробован и исключён.

Пропуск любого из трёх — и знание остаётся в tentative-заметках (либо пропускается) вместо того, чтобы стать навыком.

Безопасность

Собранные навыки и правила коммитятся и шарится — поэтому скилл никогда не записывает секретные значения: ни паролей, ни токенов, ни connection strings, ни API-ключей. Записывается только где найти секрет (имя переменной окружения, клиентская/селекторная функция, MCP-инструмент, секрет-менеджер).

Структура репозитория

self-learning-skills/
├── AGENTS.md                       # кросстуловая версия цикла
├── skills.sh.json                  # registry manifest для npx skills
├── .claude-plugin/
│   └── marketplace.json            # манифест плагина Claude Code
├── skills/
│   └── self-learning/              # Agent Skills standard (Claude Code + клиенты)
│       ├── SKILL.md                # «распознать момент» + процедура сбора
│       ├── references/
│       │   └── skill-authoring.md  # спецификация для авторинга навыков
│       └── assets/
│           └── SKILL.template.md   # шаблон для создаваемых навыков
└── .cursor/
    └── rules/
        ├── self-learning.mdc       # Cursor-адаптер (always-applied правило)
        └── learned/                # собранные Cursor-правила

Построено на открытом стандарте Agent Skills. Лицензия MIT.