К основному содержанию
скилл CX Codex

capy-cortex — скилл для Claude Code: обучаемая память агента

Скилл capy-cortex ведёт локальную базу правил, антипаттернов и предпочтений агента и сама подсовывает нужные записи в контекст. Полезен, когда агент повторяет одни и те же ошибки от сессии к сессии.

MIT ★ 138 обновлён 2026-09-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add happycapy-ai/Happycapy-skills --skill capy-cortex -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/capy-cortex/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/capy-cortex/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
brain:init coco-research Скилл brain:init для Claude Code создаёт в каталоге проекта базу знаний project_brain.db и наполняет её данными из заметок, документации и истории решений. CX Codex +1 ★ 328звёзд репо replay Rohit Ghumare Команда replay ищет накопленный опыт и прошлые ошибки в базе SQLite перед стартом задачи. Помогает вспомнить тонкости проекта и снизить число правок. CX Codex +1 ★ 2 966звёзд репо claudex kunwar-shah MCP-сервер claudex для Claude Code, сохраняющий знания между сессиями и поиском прошлых разговоров. Хранит соглашения проекта, архитектуру и решения, позволяет искать контекст и возвращать его в новые сессии. CX Codex +1 ★ 97звёзд репо claude-memory-architecture gupsammy Правило claude-memory-architecture фиксирует внутреннюю архитектуру плагина claude-memory: хуки жизненного цикла сессий, схему базы SQLite, миграции и семантический поиск. CX Codex +1 ★ 276звёзд репо claude-memory Samarth Gupta Плагин claude-memory складывает прошлые сессии Claude в локальную SQLite с полнотекстовым поиском и подставляет контекст последнего разговора в начало нового. ★ 276звёзд репо recall bledden recall сохраняет обмены Claude Code в локальной SQLite-базе. Он нужен, когда контекст приходится искать между сессиями или восстанавливать после очистки. ★ 23звёзд репо

Из того же набора41

Весь набор →
video-frames Скилл video-frames для Claude Code извлекает кадры и миниатюры из видеофайлов с помощью ffmpeg. Создаёт кадры для просмотра происходящего на экране или сохранения превью. CX Codex +1 ★ 138звёзд репо weather Скилл weather показывает текущую погоду и прогноз по городу или аэропорту через командную строку. Подходит для быстрых ответов и запросов в JSON. CX Codex +1 ★ 138звёзд репо oss-contributor-swarm Скилл oss-contributor-swarm разворачивает рой из 9 агентов для автономного поиска простых задач на GitHub, написания кода и отправки пулреквестов. CX Codex +1 ★ 138звёзд репо llm-council Скилл llm-council запускает веб-панель, где можно параллельно опросить несколько ИИ-моделей, сравнить ответы и получить сводку. Есть анонимное голосование моделей. CX Codex +1 ★ 138звёзд репо happycapy-skill-creator Скилл happycapy-skill-creator адаптирует готовые инструменты из репозитория anthropics/skills под окружение HappyCapy. Убирает зависимости от Docker и упаковывает результат в архив .skill. CX Codex +1 ★ 138звёзд репо youtube-music Ищет треки в YouTube Music и открывает их в браузере. Голосом ищет песни и запускает воспроизведение через MCP. CX Codex +1 ★ 138звёзд репо agent-4-code-writer Субагент agent-4-code-writer для Claude Code, который пишет код исправления или новой функции в составе роя контрибьюторов open source на основе готового плана задачи. CX Codex ★ 138звёзд репо agent-3-codebase-explorer Субагент agent-3-codebase-explorer исследует репозиторий перед исправлением или новой функцией: находит нужные файлы, разбирает структуру и готовит карту кодовой базы. CX Codex ★ 138звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой