name: learn description: "Use when user asks to "learn about topic", "research subject", "create learning guide", "build knowledge base", "study topic". Gathers online sources and synthesizes comprehensive guide with RAG index."

/learn - Learning Guide Generator

Research any topic by gathering online resources and synthesize into a comprehensive learning guide with RAG-optimized indexes.

Depth Levels

Level	Sources	Use Case
`brief`	10	Quick overview, time-sensitive
`medium`	20	Default - balanced coverage
`deep`	40	Comprehensive, academic depth

Arguments

Parse from $ARGUMENTS:

•topic: The subject to learn about (required)
•--depth: brief (10 sources), medium (20, default), or deep (40)
•--no-enhance: Skip enhancement pass (default: enhance enabled)

Execution

Phase 1: Parse Arguments

javascript

const args = '$ARGUMENTS';

// Extract depth flag
const depthMatch = args.match(/--depth=(brief|medium|deep)/);
const depth = depthMatch ? depthMatch[1] : 'medium';
const noEnhance = args.includes('--no-enhance');

// Extract topic (everything except flags)
const topic = args
  .replace(/--depth=(brief|medium|deep)/g, '')
  .replace(/--no-enhance/g, '')
  .trim();

if (!topic) {
  return 'Usage: /learn <topic> [--depth=brief|medium|deep]';
}

// Generate slug for filenames
const slug = topic
  .toLowerCase()
  .replace(/[^a-z0-9\s-]/g, '')
  .replace(/\s+/g, '-')
  .replace(/-+/g, '-')
  .replace(/^-|-$/g, '')
  .substring(0, 64);

// Source counts by depth
const sourceCounts = { brief: 10, medium: 20, deep: 40 };
const minSources = sourceCounts[depth];

Phase 2: Check Existing Guide

javascript

// Check if guide already exists
const existingGuide = await Glob({ pattern: `agent-knowledge/${slug}.md` });

if (existingGuide.length > 0) {
  // Ask user: update existing or create fresh?
  const choice = await request_user_input({
    questions: [{
      question: `A guide for "${topic}" already exists. What would you like to do?`,
      header: 'Existing guide',
      options: [
        { label: 'Update existing', description: 'Add new sources and refresh content' },
        { label: 'Create fresh', description: 'Start over with new research' }
      ],
    }]
  });

  if (choice === 'Create fresh') {
    // Will overwrite
  }
}

Phase 3: Spawn Learn Agent

javascript

const taskOutput = await Task({
  subagent_type: "learn:learn-agent",
  model: "opus",
  prompt: `Research and create a learning guide.

Topic: ${topic}
Slug: ${slug}
Depth: ${depth}
Min Sources: ${minSources}
Enhance: ${!noEnhance}

Output directory: agent-knowledge/

Create:
1. ${slug}.md - Comprehensive learning guide
2. resources/${slug}-sources.json - Source metadata with confidence ratings
3. Update CLAUDE.md and AGENTS.md master indexes

Return structured results between === LEARN_RESULT === markers.`
});

Phase 4: Parse Results

javascript

function parseLearnResult(output) {
  const match = output.match(/=== LEARN_RESULT ===[\s\S]*?({[\s\S]*?})[\s\S]*?=== END_RESULT ===/);
  return match ? JSON.parse(match[1]) : null;
}

const result = parseLearnResult(taskOutput);

Phase 5: Present Results

markdown

## Learning Guide Created

**Topic**: {topic}
**File**: agent-knowledge/{slug}.md
**Sources**: {sourceCount} resources analyzed

### Quality Assessment

| Metric | Rating |
|--------|--------|
| Coverage | {coverage}/10 |
| Source Diversity | {diversity}/10 |
| Example Quality | {examples}/10 |
| Confidence | {confidence}/10 |

### Source Breakdown

| Type | Count |
|------|-------|
| Official Docs | {n} |
| Tutorials | {n} |
| Q&A/Stack Overflow | {n} |
| Blog Posts | {n} |
| GitHub Examples | {n} |

### Next Steps

- [ ] Review the guide at `agent-knowledge/{slug}.md`
- [ ] Check source quality in `agent-knowledge/resources/{slug}-sources.json`
- [ ] Run `/learn {related-topic}` to expand your knowledge base

Output Structure

Each /learn run creates/updates:

code

agent-knowledge/
  CLAUDE.md           # Master index (updated)
  AGENTS.md           # Master index for OpenCode/Codex (updated)
  {slug}.md           # Topic-specific guide (created)
  resources/
    {slug}-sources.json  # Source metadata (created)

Error Handling

Error	Action
No topic provided	Show usage help
WebSearch fails	Retry with alternative queries
Insufficient sources	Warn user, proceed with available
Enhancement fails	Skip enhancement, note in output

Example Usage

bash

/learn recursion
/learn react hooks --depth=deep
/learn "kubernetes networking" --depth=brief
/learn python async --no-enhance