Skip to content
v0.1.4latest release159 skills5 categories7 sub-categories303 tested scripts468 reference docsContact us

vocabulary-game-generator

Generate vocabulary games for language classes from a word list: printable word searches (easy, medium and hard directions, solution grid and positions), unique bingo cards with free squares and a shuffled caller list, and 20 classroom games (back to the board, taboo, pelmanism, dominoes, word-formation races, sentence auction, running dictation of definitions, info-gap crosswords and more) with the language each practises. Covers making games learning-rich (recall over recognition, production, recycling), spacing encounters across lessons, and choosing and grouping words. Use when a teacher wants a vocabulary game, review activity, bingo, word search or fun way to recycle a word list.

Languages, Linguistics & Translation / Language Teachingv1.0.0Updated OCT 25 20261 reference2 scripts

Games pay off when learners retrieve and use words, and when the same words come back across lessons. scripts/wordsearch.py builds a word search with a solution; scripts/bingo_cards.py builds unique bingo cards and a caller list. game-bank.md has 20 games and a recycling plan.

Trigger Conditions

Activate this skill when the user:

  • Wants a vocabulary game, bingo, word search or review activity
  • Has a word list from a unit and wants ways to recycle it
  • Needs a fast-finisher or end-of-lesson activity
  • Asks how to make vocabulary stick

Speaking activities: communicative-activity-generator. Warmers: warm-up-icebreaker-generator. Young learners: young-learner-esl-activity-generator.

Workflow

text
1. WORDS    -> the list (8-12 new items at lower levels), grouped by topic or word family
2. CHOOSE   -> recognition game or recall game (references/game-bank.md); mix both across the week
3. BUILD    -> python scripts/bingo_cards.py --file words.txt --cards 24 --size 4
               python scripts/wordsearch.py --file words.txt --level medium
4. CALLER   -> write definitions, gapped sentences or picture prompts for each word (not just the word)
5. PRODUCE  -> add a production step: sentence, collocation, spelling
6. RECYCLE  -> schedule the words again next lesson, next week, next month

Output

Give the game materials ready to print, teacher instructions (3-5 steps), the caller prompts written out for bingo, the production follow-up and a note on when to recycle the words. For bingo, prefer more words than squares so that cards differ and winners come one at a time.

Scripts

bash
python scripts/wordsearch.py --file words.txt [--words ...] [--size 12] [--level easy|medium|hard] [--seed 1]

Exit codes: 0 printed, 1 a word could not be placed, 2 no words or a word longer than the grid.

bash
python scripts/bingo_cards.py --file words.txt [--words ...] [--cards 20] [--size 3|4|5] [--free] [--seed 1]

Exit codes: 0 printed, 2 too few words or read error.

Additional Resources

FileContent
game-bank.md20 vocabulary games with what they practise, levels, grouping and procedure; learning-rich games; encounters and recycling; choosing words
More in Language Teaching

academic-english-eap-course-planner

Plan English for Academic Purposes (EAP) courses: pre-sessional, in-sessional, foundation, IELTS preparation and discipline-specific EAP, with syllabus strands (academic reading, lecture listening and note-taking, essay and report writing, paraphrase, summary and synthesis, referencing and plagiarism, seminars and presentations, academic vocabulary, critical thinking), a 10-week pre-sessional outline, exit assessment, IELTS-CEFR alignment and academic style (formality, hedging, cohesion, reporting verbs). Estimates study hours and weeks to close an IELTS gap from overall or per-skill scores (IELTS rounding, minimum per skill, priority skills, feasibility before a deadline), and checks learner texts for contractions, informal words with academic alternatives, unhedged claims, 'you', And/But/So starts, rhetorical questions and missing citations.

actfl-proficiency-curriculum-mapper

Map world language curricula to the ACTFL framework: proficiency levels (Novice, Intermediate, Advanced, Superior, Distinguished with sublevels), functions, contexts, text types and accuracy, proficiency vs performance, the three modes of communication (interpretive, interpersonal, presentational), the 5 Cs World-Readiness Standards, backward-designed thematic units with Integrated Performance Assessments, typical programme targets and FSI time estimates. Looks up approximate ACTFL-CEFR-ILR equivalences with what each level can do, and checks a unit map for missing modes, rehearsed skits mislabelled as interpersonal, translation or word lists as interpretive tasks, and units without an integrated performance assessment.

adult-literacy-esl-lesson-builder

Build lessons for adult ESL learners who are developing literacy (LESLLA learners: pre-literate, non-literate, semi-literate, literate in a non-Roman script): learner profiles and sensitive initial assessment, principles (oral language first, known to new, systematic phonics with adult-relevant text, repetition, classroom skills, respect for experience), a lesson routine (oral warm-up, review, new grapheme, blending, segmenting, decodable text, writing, functional literacy, Language Experience Approach), a phonics sequence for adults, sight words, functional literacy targets (forms, signs, medicine labels) and portfolio assessment. Checks whether a reading text is decodable with the letter-sound patterns and sight words taught so far, catching untaught digraphs, listing non-decodable words with the untaught part, and suggesting the most useful next patterns.

authentic-material-lesson-adapter

Turn authentic material (news articles, podcasts, videos, songs, menus, timetables, adverts, social media posts, forms, infographics) into language lessons by grading the task rather than the text. Selects texts for interest, relevance, exploitability, coverage, cultural load and rights; finds the 4-6 words to pre-teach, words to gloss on the page and words learners can ignore, plus names and cultural references to explain, with reading time by level; and builds a lesson shape (lead-in, pre-teach, gist or scanning, graded detail task, language focus on chunks and register, response) with task ideas per material type and level from A1 to C1. Covers copyright, fair dealing and fair use, Creative Commons and attribution.

can-do-statement-writer

Write and review can-do statements for language courses, units, lessons and learner self-assessment, CEFR or NCSSFL-ACTFL style: action (observable verb) + text or situation + level-specific conditions, learner ('I can') and descriptor ('Can') versions, progressions of one activity from A1 to C1, and coverage of reception, production, interaction and mediation. Includes a verb bank by mode and level and condition and text-type banks. Lints statements for teacher-centred phrasing, knowledge instead of use (learn, know, understand the passive), missing context, two skills in one statement, vague quality words, grammar items as outcomes, overlong statements and missing modes in a set.

cefr-aligned-syllabus-builder

Build language course syllabuses aligned to the CEFR (A1-C2, plus levels, Companion Volume 2020): entry and exit levels, guided learning hours and course length (with an L1-distance adjustment), syllabus type (topic, functional-notional, task-based, skills-based, multi-strand), unit-by-unit can-do outcomes, grammar from a core inventory by level, vocabulary, functions, pronunciation, balance of reception, production, interaction and mediation, recycling and assessment points. Checks a syllabus for units without can-do statements, core grammar for the level not covered, items above the course level, skills missing from most units and units with no vocabulary or functions.