# Listening Error Review

> Review IELTS Listening or dictation mistakes after browser practice by using transcripts, user answers, and results to classify sound, spelling, distractor, number, grammar, and paraphrase errors, then generate a validated Listening Error Notebook DOCX.

- **Type:** Skill
- **Install:** `agentstack add skill-jobo16-ielts-all-in-one-skills-listening-error-review`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Jobo16](https://agentstack.voostack.com/s/jobo16)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Jobo16](https://github.com/Jobo16)
- **Source:** https://github.com/Jobo16/ielts-all-in-one-skills/tree/main/skills/ielts-buddy/workflows/listening-error-review
- **Website:** https://ieltsbuddy.igocn.cn

## Install

```sh
agentstack add skill-jobo16-ielts-all-in-one-skills-listening-error-review
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Listening Error Review

## Core Rule

Listening playback and dictation input are browser-owned. Local Agent value starts after the attempt: classify errors, build replay targets, and schedule drills.

## Inputs

Use any available combination:

- browser result summary;
- transcript or dictation text;
- user answer and correct answer;
- audio timestamp or section number;
- question type and answer key;
- user-pasted notes from the web session.

If the user only asks to do dictation, provide the listening-dictation route from `references/web-workspace.md`.

## Error Taxonomy

Classify each miss into the main cause:

- sound discrimination;
- weak form or connected speech;
- spelling;
- singular/plural;
- number, date, or unit;
- word boundary;
- distractor;
- paraphrase;
- grammar fit;
- attention/location loss.

Avoid generic “listen more” feedback.

## Workflow

1. List missed items only.
2. For each item, show correct answer, user answer, error type, and one replay target.
3. Create a 1-2 minute micro-drill:
   - shadow the phrase;
   - spell the answer;
   - distinguish singular/plural;
   - predict answer grammar before replay;
   - identify distractor phrase.
4. Save high-value phrases to vocabulary only when the user asks or when the phrase is clearly reusable.
5. Record learning events after grading.

## Default Deliverable

Deliver a validated Listening Error Notebook `.docx` by default when there are 2+ missed items, a full dictation review, or a section review. For one quick miss, concise chat is acceptable.

1. Build an error-notebook plan from transcript/result data.
2. Generate the DOCX with `scripts/create_listening_error_notebook_docx.py`.
3. Validate it with `scripts/validate_listening_error_notebook_docx.py`.
4. Return the absolute path to the final DOCX.
5. If validation fails, fix the plan and rerun generation plus validation.

## Bundled Resources

- `scripts/create_listening_error_notebook_docx.py`: create a Listening Error Notebook DOCX with error map, item analysis, replay plan, micro-drills, and vocabulary.
- `scripts/validate_listening_error_notebook_docx.py`: verify required sections, table, Times New Roman, and plan content.

## JSON Error Notebook Plan

```json
{
  "source_title": "IELTS Listening Section 2",
  "section_title": "Community centre booking",
  "summary": "The main issue was plural endings and distractors after correction phrases.",
  "items": [
    {
      "question_number": "12",
      "user_answer": "ticket",
      "correct_answer": "tickets",
      "error_type": "singular/plural",
      "transcript": "You will need to bring your tickets to the entrance.",
      "cause": "The final /s/ was weak but grammatically required by bring your ...",
      "replay_target": "bring your tickets",
      "micro_drill": "Replay the phrase twice and mark whether the answer must be singular or plural before listening again."
    }
  ],
  "review_plan": ["Replay only the target phrases, not the whole audio."],
  "vocabulary": [
    {"phrase": "entrance", "meaning": "入口", "source_sentence": "bring your tickets to the entrance"}
  ]
}
```

```bash
python scripts/create_listening_error_notebook_docx.py listening_error_plan.json
python scripts/validate_listening_error_notebook_docx.py ~/Desktop/IELTS_Listening_Error_Notebook_YYYYMMDD_HHMM.docx --plan-json listening_error_plan.json
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Jobo16](https://github.com/Jobo16)
- **Source:** [Jobo16/ielts-all-in-one-skills](https://github.com/Jobo16/ielts-all-in-one-skills)
- **License:** MIT
- **Homepage:** https://ieltsbuddy.igocn.cn

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jobo16-ielts-all-in-one-skills-listening-error-review
- Seller: https://agentstack.voostack.com/s/jobo16
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.