# Learning Resource Recommender

> Recommend external English and IELTS learning resources from IELTS Buddy data and the bundled developer-maintained resource catalog; can generate a validated resource recommendation DOCX.

- **Type:** Skill
- **Install:** `agentstack add skill-jobo16-ielts-all-in-one-skills-learning-resource-recommender`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Jobo16](https://agentstack.voostack.com/s/jobo16)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **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/learning-resource-recommender
- **Website:** https://ieltsbuddy.igocn.cn

## Install

```sh
agentstack add skill-jobo16-ielts-all-in-one-skills-learning-resource-recommender
```

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

## About

# Learning Resource Recommender

## Core Rule

Recommend resources as a learning decision, not a link dump. Use IELTS Buddy state and the learner's current weakness first, then choose a small number of external resources that fit the skill, level, time budget, and learning mode.

The learning-resource catalog is bundled in this Skill and maintained by the repository developer. Do not depend on external local paths or ask the learner to provide the catalog.

## Inputs

Use any available combination:

- IELTS Buddy route progress, weak skills, vocabulary progress, or recent practice errors.
- User goal: IELTS band, CEFR level, target skill, accent preference, topic interest, available minutes.
- The bundled catalog at `references/learning-english-catalog.md`.
- Direct resource candidates supplied in chat.

## Workflow

1. Identify the learner's current need:
   - listening input;
   - pronunciation/speaking;
   - reading input;
   - writing support;
   - vocabulary;
   - grammar;
   - exam-specific IELTS practice;
   - background immersion.
2. Run `scripts/extract_learning_resource_catalog.py` without a path to read the bundled catalog.
3. Filter candidates by:
   - target skill;
   - level or difficulty cues;
   - IELTS relevance;
   - availability of transcripts/subtitles/exercises;
   - cognitive load and time budget;
   - whether the learner needs input, output, or review.
4. Recommend 3-7 resources only.
5. For each resource, explain:
   - why this resource fits the current need;
   - how to use it this week;
   - what output or review artifact to bring back to the Agent.
6. Prefer official, stable, learner-friendly resources when choices are close.
7. If a resource is entertainment-first, label it as immersion, not IELTS practice.

## Default Output

Use concise chat for quick recommendations. When the user asks for a study pack, weekly resource plan, or printable recommendation list, deliver a validated `.docx`.

1. Build a recommendation plan.
2. Generate the DOCX with `scripts/create_resource_recommendations_docx.py`.
3. Validate it with `scripts/validate_resource_recommendations_docx.py`.
4. Return the absolute path to the final DOCX.

## Bundled Resources

- `scripts/extract_learning_resource_catalog.py`: parse a Markdown resource catalog into JSON candidates with title, URL, description, and heading path.
- `scripts/create_resource_recommendations_docx.py`: create a recommendation DOCX with ranked resources and a weekly usage plan.
- `scripts/validate_resource_recommendations_docx.py`: verify required sections, tables, Times New Roman, and plan content.
- `references/learning-english-catalog.md`: bundled developer-maintained external learning-resource catalog.

## JSON Recommendation Plan

```json
{
  "learner_goal": "IELTS Listening Band 7.0",
  "focus": "listening",
  "level": "B1-B2",
  "time_budget": "30 minutes/day",
  "rationale": "The learner needs transcript-supported listening and paraphrase review.",
  "recommendations": [
    {
      "rank": 1,
      "title": "BBC 6 Minute English",
      "url": "https://www.bbc.co.uk/learningenglish/english/features/6-minute-english",
      "category": "听力学习 / 播客资源",
      "fit": "Short episodes with learner-friendly topics and transcripts.",
      "how_to_use": "Listen once without transcript, then mark 5 paraphrases from the transcript.",
      "bring_back": "Three new phrases and one sentence you failed to catch."
    }
  ],
  "weekly_plan": [
    "Day 1-2: BBC 6 Minute English transcript listening.",
    "Day 3-4: One IELTS listening section and error notebook."
  ]
}
```

```bash
python scripts/extract_learning_resource_catalog.py --skill listening --limit 30
python scripts/create_resource_recommendations_docx.py resource_recommendation_plan.json
python scripts/validate_resource_recommendations_docx.py ~/Desktop/IELTS_Resource_Recommendations_YYYYMMDD_HHMM.docx --plan-json resource_recommendation_plan.json
```

## Quality Bar

- Do not recommend more than seven resources at once.
- Do not treat general English resources as IELTS materials unless they train a concrete IELTS subskill.
- Include a use method, not just a URL.
- Prefer bundled-catalog parsing over web browsing for normal recommendations.

## 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-learning-resource-recommender
- 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%.