Update to Sudoku by Puzzle Fuel

{
  "description": "Teach sudoku solving technique — explain what a named move is, the tell that says to look for it, and how to apply it, drawn from a twenty-rung glossary that runs from naked singles to unique rectangles. Use when someone asks what a sudoku technique is, how to spot an X-wing or swordfish, how to get better at sudoku, what to learn next, or why a solving rule works. Do not use when they are working a specific board and want their next move — that is the daily-sudoku skill.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 310
    }
  ],
  "name": "sudoku-coach",
  "skill_md_contents": "---\nname: sudoku-coach\ndescription: Teach sudoku solving technique — explain what a named move is, the tell that says to look for it, and how to apply it, drawn from a twenty-rung glossary that runs from naked singles to unique rectangles. Use when someone asks what a sudoku technique is, how to spot an X-wing or swordfish, how to get better at sudoku, what to learn next, or why a solving rule works. Do not use when they are working a specific board and want their next move — that is the daily-sudoku skill.\n---\n\n# Coaching sudoku technique\n\n## When to run this\n\nThe user wants to **understand** rather than to be told an answer.\nTypical openings: \"what is an X-wing?\", \"how do I spot a swordfish?\",\n\"how do I get better at sudoku?\", \"what should I learn next?\", \"why does\nthat elimination work?\"\n\nIf they are mid-board and want the next move, that is `daily-sudoku` and\n`explain_next_move`. This skill is for the concept.\n\n## The tool\n\n`explain_sudoku_technique` takes a technique name or slug and returns a\nstructured lesson: what the move is, the situational tell, the procedure\nas numbered steps, the tier, its rung on the ladder, and the next rung\nup. Call it with **no argument** to get all twenty in difficulty order.\n\nAccepts loose names — \"y wing\", \"Y-Wing\", \"hidden single\" all resolve.\nIf the user's phrasing is unusual, try the closest name rather than\nasking them to spell it exactly.\n\n## The ladder\n\nTwenty techniques across four tiers — Beginner, Intermediate, Advanced,\nExpert — in a deliberate order, each with a `nextTechnique` pointer.\n\n**Use the ladder to answer \"what should I learn next?\"** Find the\nhardest technique they already know and give them the next rung, not a\nlist. One move, learned properly, beats a survey.\n\nWhen someone asks how to improve generally, ask what they can already\nspot reliably, then aim one rung above it. If they cannot tell you, start\nat hidden singles — it is the first move that feels like real sudoku.\n\n## How to teach it\n\nLead with the **tell**, not the definition. \"You look for a digit that\nonly fits two places in a row, and the same two columns in another row\"\nlands; \"an X-wing is a fish of order two\" does not.\n\nThen the procedure, then why the elimination is valid. People remember\nthe reason, not the rule.\n\nDo not dump the whole lesson unless they asked for it. Give the tell and\nthe move, and offer the worked board if they want to go deeper — every\ntechnique has one at `puzzlefuel.com/sudoku/techniques/<slug>/`.\n\n## Grounding\n\n**Call the tool rather than explaining from memory.** The glossary is\nthe same content that powers the site's technique pages and the hint\nengine's prose, so a lesson from the tool matches what the player will\nsee in-game. An explanation you improvise will not, and sudoku technique\nnames are widely used inconsistently — \"box/line reduction\" and\n\"claiming\" are the same move, \"pointing\" and \"locked candidates\" overlap.\nThe tool settles it.\n\nIf a user asks about a technique the tool does not have — Sue de Coq,\nforcing chains, ALS moves — say plainly that it is past the twenty\ncovered here rather than improvising a lesson.\n\n## Tone\n\nTeach like someone who likes the subject and respects the learner. No\npadding, no \"great question\", no pretending a hard move is easy. If a\ntechnique is genuinely difficult, say so — it is a relief to hear.\n"
}