capy-cortex — скилл для Claude Code: обучаемая память агента
Скилл capy-cortex ведёт локальную базу правил, антипаттернов и предпочтений агента и сама подсовывает нужные записи в контекст. Полезен, когда агент повторяет одни и те же ошибки от сессии к сессии.
MIT ★ 138 обновлён 2026-09-03
npx skills add happycapy-ai/Happycapy-skills --skill capy-cortex -a claude-codeЧто делает capy-cortex
Скилл держит локальную базу знаний агента в SQLite с полнотекстовым индексом FTS5 и моделью TF-IDF на sklearn. Хуки читают её сами: на старте сессии подгружаются антипаттерны, предпочтения и принципы, на каждый промпт приходят правила по теме задачи.
Учится на ходе работы. Ошибки из PostToolUseFailure записываются как антипаттерны, Stop вытаскивает правки и предпочтения из разговора, reflect.py разбирает транскрипты сессий, consolidate.py группирует похожие правила в принципы, decay гасит то, что давно не подтверждалось. Хук PreToolUse(Bash) попутно блокирует известные опасные команды, так что скилл меняет поведение агента шире, чем одна память.
Скрипты вызываются через python3, база лежит в ~/.claude/skills/capy-cortex/cortex.db. Кластеризацию делает sklearn, поэтому библиотека должна стоять в том же окружении, иначе consolidate.py не отработает. Хуки запускаются автоматически, руками их не дёргают.
Какие задачи решает
- запомнить, что агент уже ломал в этом проекте
- подтянуть правила по стеку перед началом задачи
- собрать разрозненные правки пользователя в принципы
- заблокировать повторный запуск опасной bash-команды
- посмотреть, что накопилось в базе знаний
Примеры запросов агенту
- Покажи, какие правила по React и TypeScript у тебя уже записаны
- Добавь антипаттерн: не делать force push в main
- Прогони консолидацию и перечисли принципы, которые получились
Как установить capy-cortex
1Через Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill capy-cortex -a claude-code2Вручную: положить файлы
~/.claude/skills/capy-cortex/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/capy-cortex/
1Через Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill capy-cortex -a codex2Вручную: положить файлы
.agents/skills/capy-cortex/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill capy-cortex -a cursor2Вручную: положить файлы
.cursor/skills/capy-cortex/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install happycapy-ai/Happycapy-skills skills/capy-cortex2Вручную: положить файлы
.github/skills/capy-cortex/SKILL.md1Через Skills CLI (Vercel)
npx skills add happycapy-ai/Happycapy-skills --skill capy-cortex -a gemini-cli2Командой платформы
gemini skills install https://github.com/happycapy-ai/Happycapy-skills --path skills/capy-cortexВручную: положить файлы
.devin/skills/capy-cortex/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о capy-cortex
Как установить capy-cortex в Claude Code?
Выполните npx skills add happycapy-ai/Happycapy-skills --skill capy-cortex -a claude-code. После этого скилл лежит в ~/.claude/skills/capy-cortex/SKILL.md.
Что делает capy-cortex?
Хранит правила, предпочтения и антипаттерны в SQLite и подгружает подходящие записи через хуки. Ошибки и правки из разговора тоже попадают в базу.
Что нужно для консолидации правил?
consolidate.py кластеризует записи через sklearn, поэтому библиотека должна быть в том же Python-окружении, что и остальные скрипты. Без неё консолидация не пройдёт.
Исходный текст
SKILL.md · MIT
--- name: capy-cortex description: "Autonomous learning system - learns from mistakes, reflects on sessions, and gets smarter over time. The AI brain." --- # Capy Cortex - Autonomous Learning System You have a persistent learning brain powered by SQLite + FTS5 + sklearn TF-IDF. Knowledge is automatically loaded via hooks. This file describes manual operations. ## Architecture - **Database**: `~/.claude/skills/capy-cortex/cortex.db` (SQLite + FTS5 + WAL) - **Hooks** (automatic, never call manually): - SessionStart: Loads anti-patterns, preferences, principles - UserPromptSubmit: Retrieves task-relevant rules via FTS5 - PreToolUse(Bash): Blocks known dangerous commands - PostToolUseFailure: Records errors as anti-patterns - Stop: Extracts corrections and preferences from conversation - **Scripts** (for manual/scheduled use): - `cortex.py`: Core engine (retrieve, add rules, stats) - `reflect.py`: Deep session analysis - `consolidate.py`: Cluster rules into principles (sklearn) - `bootstrap.py`: Mine historical sessions ## Manual Commands ```bash # Check system health python3 ~/.claude/skills/capy-cortex/scripts/cortex.py stats # Retrieve rules for a topic python3 ~/.claude/skills/capy-cortex/scripts/cortex.py retrieve "react typescript" # Add a rule manually python3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-rule "Always use TypeScript strict mode" "best_practice" # Add an anti-pattern python3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-ap "Never force push to main" "critical" # Add a preference python3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-pref "User prefers functional components over class components" # Run consolidation (clusters rules into principles) python3 ~/.claude/skills/capy-cortex/scripts/consolidate.py # Retrain TF-IDF model python3 ~/.claude/skills/capy-cortex/scripts/cortex.py retrain # Apply confidence decay python3 ~/.claude/skills/capy-cortex/scripts/cortex.py decay ``` ## How It Learns 1. **Automatic** (via hooks): Errors are captured, corrections noted, preferences extracted 2. **Reflection**: Deep analysis of session transcripts extracts patterns 3. **Consolidation**: sklearn clustering groups similar rules into principles 4. **Decay**: Old, unreinforced rules fade; validated rules strengthen 5. **Retrieval**: Two-stage FTS5 + TF-IDF returns only relevant knowledge (O(1) context)
© happycapy-ai · MIT · happycapy-ai/Happycapy-skills