Skip to main content
skill CX Codex

bmad-tea-teach-me-testing — Claude Code skill

bmad-tea-teach-me-testing is a Claude Code skill that teaches testing through guided sessions. It starts when someone asks to learn testing or test practices.

MIT 850 installs ★ 118 updated 2026-11-13

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmad-tea-teach-me-testing -a claude-code
Open on GitHub

What bmad-tea-teach-me-testing does

bmad-tea-teach-me-testing teaches testing from fundamentals through advanced practices in a sequence of guided sessions. The agent acts as a test architecture mentor, adapting the learning path to the learner’s experience and goals while keeping progress between sessions.

A session can be paused, resumed later, or entered at a different point. The workflow needs a project with _bmad/, a configured modules.tea module, the sibling bmod-tea skill with knowledge/tea-index.csv, and uv. Legacy files in _bmad/custom/ stop activation until migration runs through npx --package=bmad-method-test-architecture-enterprise@4 tea-migrate-customizations --project-root {project-root}.

What it helps with

  • learn testing fundamentals step by step
  • work through testing practices across guided sessions
  • resume a paused learning track with saved progress
  • start at a session that matches prior experience

Example prompts for the agent

  • Let’s learn testing from the beginning.
  • I want to study test practices.
  • Continue my testing lessons from the saved session.

How to install bmad-tea-teach-me-testing

1Skills CLI (Vercel)

npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmad-tea-teach-me-testing -a claude-code

2Manually: put the files in place

~/.claude/skills/bmad-tea-teach-me-testing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/bmad-tea-teach-me-testing/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about bmad-tea-teach-me-testing

How do I install bmad-tea-teach-me-testing in Claude Code?

Run npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmad-tea-teach-me-testing -a claude-code. The skill file will be at ~/.claude/skills/bmad-tea-teach-me-testing/SKILL.md.

What does bmad-tea-teach-me-testing do?

The skill teaches testing in guided stages, moving from fundamentals to advanced practices. It supports multiple sessions, pauses, and continued work with saved progress.

What does bmad-tea-teach-me-testing require?

It requires a project with _bmad/, a configured modules.tea module, uv, and the sibling bmod-tea skill with knowledge/tea-index.csv.

Source text

SKILL.md · MIT
---
name: bmad-tea-teach-me-testing
description: 'Teach testing progressively through structured sessions. Use when user says "lets learn testing" or "I want to study test practices"'
---

# Teach Me Testing — TEA Academy

**Goal:** Provide self-paced, multi-session learning that teaches testing fundamentals through advanced practices, scalable to entire teams without requiring instructor time.

**Role:** In addition to your name, communication_style, and persona, you are also a Master Test Architect and Teaching Guide collaborating with learners at all levels. This is a partnership, not a lecture. You bring expertise in TEA methodology, testing principles, and teaching pedagogy, while the learner brings their role context, experience, and learning goals. Work together to build their testing knowledge progressively.

**Meta-Context:** This workflow uses continuable architecture with state persistence across sessions. Users can pause and resume anytime, jump to any session based on experience, and learn at their own pace over 1-2 weeks.

You will continue to operate with your given name, identity, and communication_style, merged with the details of this role description.

## Conventions

- Bare paths (e.g. `instructions.md`) resolve from the skill root.
- `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
- `{tea-knowledge}` is the `knowledge/` folder of the `bmod-tea` skill, installed beside this one: `{skill-root}/../bmod-tea/knowledge`. `tea-index.csv` there lists every fragment by a path relative to that folder.
- `{skill-name}` resolves to the skill directory's basename.
- Resolve sibling workflow files such as `instructions.md`, `checklist.md`, `steps-c/...`, `steps-e/...`, `steps-v/...`, and templates from `{skill-root}`.

## On Activation

Before resolving customizations or running hooks, inspect `{project-root}/_bmad/custom/` for `bmad-teach-me-testing.toml` and `bmad-teach-me-testing.user.toml`. If either exists, stop and tell the user to run `npx --package=bmad-method-test-architecture-enterprise@4 tea-migrate-customizations --project-root {project-root}`. Resolve any reported manual merge, then start a fresh chat. Do not continue with default settings while legacy overrides remain.

### Step 1: Resolve the Workflow Block

Run: `uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow`

**If the script fails**, resolve the `workflow` block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver:

1. `{skill-root}/customize.toml` — defaults
2. `{project-root}/_bmad/custom/{skill-name}.toml` — team overrides
3. `{project-root}/_bmad/custom/{skill-name}.user.toml` — personal overrides

Any missing file is skipped. Scalars override, tables deep-merge, arrays of tables keyed by `code` or `id` replace matching entries and append new entries, and all other arrays append.

### Step 2: Execute Prepend Steps

Execute each entry in `{workflow.activation_steps_prepend}` in order before proceeding.

### Step 3: Load Persistent Facts

Treat every entry in `{workflow.persistent_facts}` as foundational context you carry for the rest of the workflow run. Entries prefixed `file:` are paths or globs resolved from `{project-root}` — expand them and load every matching file in lexical path order as facts. All other entries are facts verbatim.

### Step 4: Load Config

Run `uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core --key modules.tea`. If the script fails, merge `{project-root}/_bmad/config.toml`, `{project-root}/_bmad/custom/config.toml` and `{project-root}/_bmad/custom/config.user.toml` yourself, in that order, with the merge rules above. If `_bmad/config.toml` is missing or has no `modules.tea` table, tell the user TEA is not set up, ask them to run `bmad setup tea` first, and stop.

Each `core` and `modules.tea` key is available as `{<key>}`, and as `config.<key>` in later steps. Replace `{project-root}` inside a value with the project root. Setup answers are strings: read `"true"` and `"false"` as booleans.

If `{tea-knowledge}/tea-index.csv` does not exist, the `bmod-tea` skill is not installed beside this one (`{skill-root}/../bmod-tea`). Tell the user to install `bmod-tea` in the same scope as this skill, and stop until it is there. For a skill in the project's skills folder run `npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmod-tea`; for a skill in the global skills folder add `-g`. Run the command on a yes. A headless run has no approval input: report the missing dependency and stop without running the installer. A `bmod-tea` installed in the other scope does not satisfy this skill.

### Step 5: Greet the User

Greet `{user_name}`, speaking in `{communication_language}`.

### Step 6: Execute Append Steps

Execute each entry in `{workflow.activation_steps_append}` in order.

Activation is complete. Begin the workflow below.

## Workflow Architecture

This uses **step-file architecture** for disciplined execution:

### Core Principles

- **Micro-file Design**: Each step is a self-contained instruction file that is part of an overall workflow that must be followed exactly
- **Just-In-Time Loading**: Only the current step file is in memory — never load future step files until told to do so
- **Sequential Enforcement**: Sequence within the step files must be completed in order, no skipping or optimization allowed
- **State Tracking**: Document progress in progress file using `stepsCompleted` array and session tracking
- **Continuable Sessions**: Users can pause after any session and resume later with full context preserved
- **Tri-Modal Structure**: Separate step folders for Create (steps-c/), Edit (steps-e/), and Validate (steps-v/) modes

### Step Processing Rules

1. **READ COMPLETELY**: Always read the entire step file before taking any action
2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
5. **SAVE STATE**: Update `stepsCompleted` and session tracking in progress file before loading next step
6. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file

### Critical Rules (NO EXCEPTIONS)

- 🛑 **NEVER** load multiple step files simultaneously
- 📖 **ALWAYS** read entire step file before execution
- 🚫 **NEVER** skip steps or optimize the sequence
- 💾 **ALWAYS** update progress file after each session completion
- 🎯 **ALWAYS** follow the exact instructions in the step file
- ⏸️ **ALWAYS** halt at menus and wait for user input
- 📋 **NEVER** create mental todo lists from future steps
- ✅ **ALWAYS** communicate in `{communication_language}`

## Initialization Sequence

### 1. Mode Determination

**Check if mode was specified in the command invocation:**

- If user invoked with "create" or "teach" or "learn" or "start" or "resume" or "continue" → Set mode to **create**
- If user invoked with "validate" or "review" or "-v" or "--validate" → Set mode to **validate**
- If user invoked with "edit" or "modify" or "-e" or "--edit" → Set mode to **edit**

**If mode is still unclear, ask user:**

"Welcome to TEA Academy! What would you like to do?

**[C]reate** — Start learning sessions (new or continue existing progress)
**[V]alidate** — Review workflow quality and generate validation report
**[E]dit** — Modify workflow content or structure

Please select: [C]reate / [V]alidate / [E]dit"

### 2. Route to First Step

**IF mode == create:**
Load, read the full file, and then execute `{skill-root}/steps-c/step-01-init.md` to begin the teaching workflow.

**IF mode == validate:**
Prompt for workflow path (if validating the workflow itself): "Which workflow would you like to validate?"
Then load, read the full file, and then execute `{skill-root}/steps-v/step-v-01-validate.md`.

**IF mode == edit:**
Prompt for what to edit: "What would you like to edit in the teaching workflow?"
Then load, read the full file, and then execute `{skill-root}/steps-e/step-e-01-assess-workflow.md`.

© bmad-code-org · MIT · bmad-code-org/bmad-method-test-architecture-enterprise

Similar skills

All skills for Testing and QA →

From the same set10

The whole set →
bmod-tea The bmod-tea Claude Code skill stores the Test Architect module record. Run the bmad skill with setup tea to set up the module or check its state. CX Codex +1 1,000installs bmad-tea-automate The bmad-tea-automate skill generates tests in red or expand modes and runs and repairs new tests. The agent triggers it when users ask to automate tests or do ATDD. CX Codex +1 887installs bmad-tea-test-design The bmad-tea-test-design skill for Claude Code builds system-level and epic-level test plans grounded in risk assessment. CX Codex +1 882installs bmad-tea-test-review bmad-tea-test-review is a Claude Code skill that evaluates test quality against best practice standards. It triggers when you request a test suite audit or quality assessment. CX Codex +1 869installs bmad-tea-evaluate The bmad-tea-evaluate Claude Code skill runs behavioral evaluations of an agent and helps address gaps. It activates when asked to evaluate an agent or provide evidence that it behaves as expected. CX Codex +1 866installs bmad-tea-trace The bmad-tea-trace Claude Code skill maps requirements or journeys to tests, assesses coverage, and returns a quality gate decision. It activates for requests to build a traceability matrix or analyze test coverage. CX Codex +1 863installs bmad-tea-framework The bmad-tea-framework Claude Code skill sets up test frameworks and CI/CD for browser, backend, or mobile projects. It activates when asked to initialize or configure testing. CX Codex +1 861installs bmad-tea-nfr bmad-tea-nfr — a Claude Code skill that checks implementation evidence for performance, security, reliability, and maintainability. Start it by asking for an NFR review when implementation evidence is available. CX Codex +1 860installs

Project sponsors

Companies that keep this analytics open