Learn Skill | Agent Skills

Learn

Extract patterns from git history, PRs, and handoffs to create durable artifacts (skills, rules, hooks).

For single-session reflection, use Skill("reflect") instead.

Methodology: Use compound-learnings skill for frequency thresholds and artifact categorization logic.

Data Sources

| Source | Command | What to Extract | |--------|---------|-----------------| | Git commits | git log --oneline -100 | Repeated fix types, patterns | | PR descriptions | gh pr list --state merged -L 20 --json title,body | Lessons, decisions | | Handoffs | .agents/handoffs/*.md (main worktree) | Patterns, What Worked/Failed | | Existing learnings | CLAUDE.md Key Learnings section | Already encoded patterns |

Process

Step 1: Locate Main Worktree

MAIN_WORKTREE=$(git worktree list --porcelain | grep "^worktree" | head -1 | cut -d' ' -f2)
HANDOFF_DIR="$MAIN_WORKTREE/.agents/handoffs"

Step 2: Gather Patterns

Git history:

git log --oneline -100 | cut -d' ' -f2-

Merged PRs (if gh available):

gh pr list --state merged -L 20 --json title,body 2>/dev/null

Handoff files:

ls "$HANDOFF_DIR"/*.md 2>/dev/null && cat "$HANDOFF_DIR"/*.md

Existing Key Learnings:

grep -A 50 "Key Learnings" CLAUDE.md 2>/dev/null

Step 3: Analyze Patterns

Apply compound-learnings skill methodology:

Consolidate similar patterns by semantic meaning
Apply frequency thresholds (skip 1x, note 2x, recommend 3+, strong recommend 4+)
Categorize into artifact types using the decision tree

Step 4: Present Findings

## Compound Learnings Analysis

**Sources scanned:**
- Git commits: X
- PRs: Y
- Handoffs: Z

### Strong Signal (4+ occurrences)

| Pattern | Count | Artifact | Rationale |
|---------|-------|----------|-----------|
| ... | ... | ... | ... |

### Emerging Patterns (2-3 occurrences)

| Pattern | Count | Potential | Notes |
|---------|-------|-----------|-------|
| ... | ... | ... | ... |

### Recommended Actions

1. **[Artifact Type]**: `name`
   - Draft content: ...

Step 5: Create Artifacts

Use AskUserQuestion to confirm each recommendation:

"Create these artifacts?"

If approved, create using appropriate tools:

Rules → Edit CLAUDE.md or create lesson in .agents/lessons/
Skills → Create in appropriate plugin's skills directory
Hooks → Create in .claude/hooks/
Commands → Create in appropriate plugin's commands directory

Agent Skills: Learn

Install this agent skill to your local

Skill Files