# Continuous Learning

> Automatically extract reusable patterns from Claude Code sessions and save them as learned skills for future use.

- **Type:** Skill
- **Install:** `agentstack add skill-moutons-skills-validator-continuous-learning`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [moutons](https://agentstack.voostack.com/s/moutons)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [moutons](https://github.com/moutons)
- **Source:** https://github.com/moutons/skills-validator/tree/main/tests/fixtures/skills/valid/complete/continuous-learning

## Install

```sh
agentstack add skill-moutons-skills-validator-continuous-learning
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Continuous Learning Skill

Automatically evaluates Claude Code sessions on end to extract reusable patterns that can be saved as learned skills.

## When to Activate

- Setting up automatic pattern extraction from Claude Code sessions
- Configuring the Stop hook for session evaluation
- Reviewing or curating learned skills in `~/.claude/skills/learned/`
- Adjusting extraction thresholds or pattern categories
- Comparing v1 (this) vs v2 (instinct-based) approaches

## How It Works

This skill runs as a **Stop hook** at the end of each session:

1. **Session Evaluation**: Checks if session has enough messages (default: 10+)
2. **Pattern Detection**: Identifies extractable patterns from the session
3. **Skill Extraction**: Saves useful patterns to `~/.claude/skills/learned/`

## Configuration

Edit `config.json` to customize:

```json
{
  "min_session_length": 10,
  "extraction_threshold": "medium",
  "auto_approve": false,
  "learned_skills_path": "~/.claude/skills/learned/",
  "patterns_to_detect": ["error_resolution", "user_corrections", "workarounds", "debugging_techniques", "project_specific"],
  "ignore_patterns": ["simple_typos", "one_time_fixes", "external_api_issues"]
}
```

## Pattern Types

| Pattern                | Description                           |
| ---------------------- | ------------------------------------- |
| `error_resolution`     | How specific errors were resolved     |
| `user_corrections`     | Patterns from user corrections        |
| `workarounds`          | Solutions to framework/library quirks |
| `debugging_techniques` | Effective debugging approaches        |
| `project_specific`     | Project-specific conventions          |

## Hook Setup

Add to your `~/.claude/settings.json`:

```json
{
  "hooks": {
    "Stop": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/skills/continuous-learning/evaluate-session.sh"
          }
        ]
      }
    ]
  }
}
```

## Why Stop Hook?

- **Lightweight**: Runs once at session end
- **Non-blocking**: Doesn't add latency to every message
- **Complete context**: Has access to full session transcript

## Related

- [The Longform Guide](https://x.com/affaanmustafa/status/2014040193557471352) - Section on continuous learning
- `/learn` command - Manual pattern extraction mid-session

---

## Comparison Notes (Research: Jan 2025)

### vs Homunculus (github.com/humanplane/homunculus)

Homunculus v2 takes a more sophisticated approach:

| Feature     | Our Approach               | Homunculus v2                                |
| ----------- | -------------------------- | -------------------------------------------- |
| Observation | Stop hook (end of session) | PreToolUse/PostToolUse hooks (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                      |

**Key insight from homunculus:**

> "v1 relied on skills to observe. Skills are probabilistic—they fire ~50-80% of the time. v2 uses hooks for observation (100% reliable) and instincts as the atomic unit of learned behavior."

### Potential v2 Enhancements

1. **Instinct-based learning** - Smaller, atomic behaviors with confidence scoring
2. **Background observer** - Haiku agent analyzing in parallel
3. **Confidence decay** - Instincts lose confidence if contradicted
4. **Domain tagging** - code-style, testing, git, debugging, etc.
5. **Evolution path** - Cluster related instincts into skills/commands

See: `/Users/affoon/Documents/tasks/12-continuous-learning-v2.md` for full spec.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [moutons](https://github.com/moutons)
- **Source:** [moutons/skills-validator](https://github.com/moutons/skills-validator)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-moutons-skills-validator-continuous-learning
- Seller: https://agentstack.voostack.com/s/moutons
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
