Agent skill · research science · affaan-m
continuous-learning-v2
Instinct-based learning system that observes sessions via hooks, creates atomic instincts with confidence scoring, and evolves them into skills/commands/agents. v2.1 adds project-scoped instincts to prevent cross-project contamination. Use when capturing lessons from a session, managing instincts, or promoting them into skills, commands, or agents.
Why this skill is useful
Adds a framework for creating and managing atomic instincts that enhance AI's ability to learn and adapt behaviors based on user interactions.
What it needs
About 7k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
Continuous Learning v2.1 - Instinct -Based Architecture An advanced learning system that turns your Claude Code sessions into reusable knowledge through atomic "instincts" - small learned behaviors with confidence scoring. v2.1 adds project-scoped instincts — React patterns stay in your React project, Python conventions stay in your Python project, and universal patterns (like "always validate input") are shared globally. When to Activate Setting up automatic learning from Claude Code sessions Configuring instinct-based behavior extraction via hooks Tuning confidence thresholds for learned behaviors Reviewing, exporting, or importing instinct libraries Evolving instincts into full skills, commands, or agents Managing project-scoped vs global instincts Promoting instincts from project to global scope What's New in v2.1 Feature v2.0 v2.1 --------- ------ ------ Storage Global (~/.claude/homunculus/) Project-scoped (${XDGDATAHOME:-~/.local/share}/ecc-homunculus/projects/<hash>/) Scope All instincts apply everywhere Project-scoped + global Detection None git remote URL / repo path Promotion N/A Project → global when seen in 2+ projects Commands 4 (status/evolve/export/import) 6 (+promote/projects) Cross-project Contamination risk Isolated by default What's New in v2 (vs v1) Feature v1 v2 --------- ---- ---- Observation Stop hook (session end) PreToolUse/PostToolUse (100% reliable) Analysis Main context Background agent (Haiku) Granularity Full skills Atomic "instincts" Confidence None 0.3-0.9 weighted Evolution Direct to skill Instincts -> cluster -> skill/command/agent Sharing None Export/import instincts The Instinct Model An instinct is a small learned behavior: Properties: Atomic -- one trigger, one action Confidence-weighted -- 0.3 = tentative, 0.9 = near certain Domain-tagged -- code-style, testing, git, debugging, workflow, etc. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/continuous-learning-v2--599f82