Skill Claude

Teach Me

teach-me/

3 views 0 downloads

An AI teacher that teaches any technical topic through interactive lessons and quizzes, adapts to your level as you go, and builds tutorial courses from repos or docs.

Teach Me: Brain Lab skill for Claude Code

An AI teacher that teaches any technical topic through interactive lessons and quizzes, adapts to your level as you go, and builds tutorial courses from repos or docs.

What it does

Studies before it teaches. A 6-stage pipeline: study, understand, map, plan, prepare, teach.
Interactive lessons that adapt to your level as you answer.
Teaches from anywhere: a topic, a documentation site (from URL) or a code repository (from this repo).
Quiz mode: say "quiz me" and the roles flip.
Remembers you. Saves your progress; say "continue" to pick up where you left off.
Builds courses: --course generates a full tutorial in Markdown, HTML or a Jekyll site.

Use

/teach-me React hooks
/teach-me Kubernetes from https://kubernetes.io/docs/
/teach-me this codebase from this repo --course --format=html

Install

Download this skill and copy the teach-me folder to .claude/skills/teach-me/ in your project, or to ~/.claude/skills/teach-me/ to use it in every project. Claude Code finds it on its own; you can also call it with /teach-me.

Part of the Teaching bundle.

Source: endorphin-ai/hasbrains-agent-kit. License: MIT.

Files (23)

# Analysis Output Schema

## For Repo Sources

```json
{
  "source_type": "repo",
  "project_name": "string",
  "summary": "One paragraph: what it does and why",
  "tech_stack": ["language", "framework", "database"],
  "entry_points": ["path/to/main/file"],
  "architecture_layers": [
    {
      "name": "HTTP/API Layer",
      "files": ["src/routes/index.ts"],
      "purpose": "Maps URLs to handler functions"
    }
  ],
  "concepts": [
    {
      "id": "c01",
      "name": "Project Setup & Configuration",
      "complexity": 1,
      "prerequisites": [],
      "files": ["package.json", "tsconfig.json"],
      "description": "How the project is structured and configured",
      "key_patterns": ["environment variables", "TypeScript strict mode"]
    }
  ],
  "learning_order": ["c01", "c02"],
  "tutorial_groups": [
    {
      "tutorial_number": 1,
      "title": "What Are We Building?",
      "concepts": ["c01"],
      "estimated_minutes": 20,
      "milestone": "Learner can describe the architecture and run the project"
    }
  ]
}
```

## For Docs Sources

```json
{
  "source_type": "docs",
  "source_url": "https://example.dev/docs/intro",
  "project_name": "string",
  "summary": "What this tool/library/framework does and who it's for",
  "version": "version covered",
  "total_docs_pages": 45,
  "docs_structure": [
    {
      "section": "Getting Started",
      "pages": [
        {
          "title": "Installation",
          "url": "https://example.dev/docs/install",
          "classification": "essential"
        }
      ]
    }
  ],
  "concepts": [
    {
      "id": "c01",
      "name": "Installation & First Run",
      "complexity": 1,
      "prerequisites": [],
      "source_pages": ["https://example.dev/docs/install"],
      "description": "Setting up the tool and running the first example",
      "best_example": "code snippet from docs",
      "docs_gap": "Docs show install command but don't explain what gets created"
    }
  ],
  "learning_order": ["c01", "c02"],
  "docs_gaps": [
    "Selectors scattered across 4 pages with no comparison",
    "No progressive project — every example is isolated",
    "POM explained but never shown in a real test suite"
  ],
  "tutorial_groups": [
    {
      "tutorial_number": 1,
      "title": "Write Your First Test",
      "concepts": ["c01", "c02"],
      "source_pages": ["https://example.dev/docs/install", "https://example.dev/docs/first-test"],
      "estimated_minutes": 20,
      "milestone": "Learner has a passing test",
      "fills_gap": "Explains project structure the docs skip"
    }
  ]
}
```

## For Topic Sources

```json
{
  "source_type": "topic",
  "topic": "Building REST APIs with Go",
  "summary": "What the learner will build and why this topic matters",
  "prerequisites_assumed": ["Basic Go syntax", "HTTP fundamentals"],
  "concepts": [
    {
      "id": "c01",
      "name": "HTTP Server Basics",
      "complexity": 1,
      "prerequisites": [],
      "description": "Setting up a basic HTTP server in Go",
      "key_patterns": ["net/http", "handler functions", "ListenAndServe"]
    }
  ],
  "learning_order": ["c01", "c02"],
  "progressive_project": {
    "name": "Bookstore API",
    "description": "A REST API for managing a bookstore with auth, CRUD, and search",
    "final_state": "Fully tested API with JWT auth, PostgreSQL, and Docker deployment"
  },
  "tutorial_groups": [
    {
      "tutorial_number": 1,
      "title": "Your First HTTP Endpoint",
      "concepts": ["c01"],
      "estimated_minutes": 25,
      "milestone": "Learner has a running server that responds to GET /health"
    }
  ]
}
```

## Classification Values

### File Classification (Repo)
- `core` — Essential to understanding the project
- `supporting` — Helpers, utils, config, types
- `peripheral` — Tests, CI, docs, scripts, lockfiles

### Page Classification (Docs)
- `essential` — Core concepts every user MUST understand
- `practical` — How-to guides, common tasks
- `reference` — API docs, config options, method lists
- `advanced` — Edge cases, performance, plugins, internals
- `skip` — Changelog, contributing, legacy content

### Complexity Rating
- `1` — Beginner (setup, basic usage, hello world)
- `2` — Beginner+ (core features, standard patterns)
- `3` — Intermediate (combining concepts, real-world usage)
- `4` — Advanced (optimization, complex patterns, edge cases)
- `5` — Expert (internals, plugin systems, architecture)