How do I install the Capy Cortex skill?

Run npx skillmds@latest add happycapy-ai/capy-cortex in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Capy Cortex safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Capy Cortex?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Capy Cortex free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Capy Cortex?

happycapy-ai (@happycapy-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Capy Cortex by happycapy-ai — Agent Skill

Name: Capy Cortex
Rating: 4.2 (5 reviews)
Author: happycapy-ai

File contents

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

# 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

Automatic (via hooks): Errors are captured, corrections noted, preferences extracted
Reflection: Deep analysis of session transcripts extracts patterns
Consolidation: sklearn clustering groups similar rules into principles
Decay: Old, unreinforced rules fade; validated rules strengthen
Retrieval: Two-stage FTS5 + TF-IDF returns only relevant knowledge (O(1) context)

---name: capy-cortexdescription: Autonomous learning system - learns from mistakes, reflects on sessions, and gets smarter over time. The AI brain.---# Capy Cortex - Autonomous Learning SystemYou 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 healthpython3 ~/.claude/skills/capy-cortex/scripts/cortex.py stats# Retrieve rules for a topicpython3 ~/.claude/skills/capy-cortex/scripts/cortex.py retrieve "react typescript"# Add a rule manuallypython3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-rule "Always use TypeScript strict mode" "best_practice"# Add an anti-patternpython3 ~/.claude/skills/capy-cortex/scripts/cortex.py add-ap "Never force push to main" "critical"# Add a preferencepython3 ~/.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 modelpython3 ~/.claude/skills/capy-cortex/scripts/cortex.py retrain# Apply confidence decaypython3 ~/.claude/skills/capy-cortex/scripts/cortex.py decay```## How It Learns1. **Automatic** (via hooks): Errors are captured, corrections noted, preferences extracted2. **Reflection**: Deep analysis of session transcripts extracts patterns3. **Consolidation**: sklearn clustering groups similar rules into principles4. **Decay**: Old, unreinforced rules fade; validated rules strengthen5. **Retrieval**: Two-stage FTS5 + TF-IDF returns only relevant knowledge (O(1) context)

Frequently asked questions

Capy Cortex