Catalog
affaan-m/continuous-learning

affaan-m

continuous-learning

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

global
0installs0uses~956
v1.2Saved Apr 20, 2026

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

Status

This v1 skill is still supported, but continuous-learning-v2 is the preferred path for new installs. Keep v1 when you explicitly want the simpler Stop-hook extraction flow or need compatibility with older learned-skill workflows.

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:

{
  "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:

{
  "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
  • The Longform Guide - Section on continuous learning
  • /learn command - Manual pattern extraction mid-session

Comparison Notes (Research: Jan 2025)

vs 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: docs/continuous-learning-v2-spec.md for full spec.

Files3
3 files · 3.8 KB

Select a file to preview

Overall Score

68/100

Grade

C

Adequate

Safety

75

Quality

65

Clarity

75

Completeness

55

Summary

This skill automatically extracts reusable patterns from Claude Code sessions at their conclusion and saves them as learned skills. It operates as a Stop hook that evaluates session transcripts, identifies extractable patterns (error resolutions, debugging techniques, workarounds, project-specific conventions), and signals Claude to persist these patterns to ~/.claude/skills/learned/.

Detected Capabilities

Session transcript parsing and evaluationPattern detection from conversation historyPersistent skill generation and storageJSON configuration managementHook-based automation (Stop hook integration)Directory initialization and path resolutionConditional logic for minimum session length filtering

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

extract learned patternscontinuous learning setupsession evaluationsave reusable skillspattern extraction hook

Risk Signals

INFO

File write to home directory (~/.claude/skills/learned/)

evaluate-session.sh:45, config.json:4
INFO

JSON parsing with jq on untrusted config file

evaluate-session.sh:33-37
WARNING

Transcript file path from stdin JSON without validation

evaluate-session.sh:42-46
INFO

Graceful fallback when jq is unavailable, uses defaults

evaluate-session.sh:33-35
INFO

No actual skill generation implemented—script only logs intent

evaluate-session.sh:58-59

Referenced Domains

External domains referenced in skill content, detected by static analysis.

x.com

Use Cases

  • Automatically capture reusable debugging techniques from completed sessions
  • Extract project-specific conventions and patterns for future reference
  • Build a personal library of error resolutions and workarounds discovered during development
  • Reduce repetitive problem-solving by learning from past session outcomes
  • Configure extraction thresholds to balance pattern capture quality vs. noise

Quality Notes

  • Skill describes its purpose clearly but actual implementation is incomplete—the evaluate-session.sh script logs pattern detection intent but does not implement the extraction logic itself.
  • Good architectural decision: uses Stop hook instead of UserPromptSubmit to avoid per-message latency overhead.
  • Comparison with Homunculus v2 is informative and shows authors understand the design space, but v2 spec is not provided (referenced as external doc).
  • Configuration system is well-structured with sensible defaults (min_session_length: 10, extraction_threshold: medium, auto_approve: false).
  • Pattern types and ignore lists are clearly documented with practical categories (error_resolution, workarounds, debugging_techniques).
  • Hook setup instructions are clear and include proper JSON syntax examples.
  • Missing: actual implementation details for pattern extraction, skill template generation, and confidence scoring mentioned in v2 notes.
  • Error handling exists (set -e, directory creation, jq fallback) but transcript validation is minimal.
  • No documentation on what happens when auto_approve is true or how manual curation works.
  • The script reads from stdin but does not validate the JSON structure before extracting transcript_path.
Model: claude-haiku-4-5-20251001Analyzed: Apr 20, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Version History

v1.2

Content updated

2026-04-20

Latest
v1.1

Content updated

2026-04-12

v1.0

Seeded from github.com/affaan-m/everything-claude-code

2026-03-16

Add affaan-m/continuous-learning to your library

Command Palette

Search for a command to run...