progressive-hint-ladder

Guide learners through a six-level progressive hint ladder with reflection-gated escalation.

583|96|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/GarethManning/education-agent-skills --skill progressive-hint-ladder
Or copy as Structured Prompt for Agent▌
Please help me install this Agent Skill.
Skill: progressive-hint-ladder
Source: https://github.com/GarethManning/education-agent-skills/tree/main/skills/student-learning/progressive-hint-ladder
Command: npx skills add https://github.com/GarethManning/education-agent-skills --skill progressive-hint-ladder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Progressive Hint Ladder helps learners avoid skipping effortful thinking by providing graduated assistance—ranging from a diagnostic nudge to a near-complete scaffold—only after the learner reflects on what the previous hint enabled.

Core Features & Use Cases

  • Graduated six-level hint ladder: escalates from a “show your thinking” diagnostic prompt through conceptual, analogy, principle reminder, procedural nudge, and near-complete scaffold.
  • Reflection-gated escalation: requires the learner to explain what the last hint told them and whether they can take the next step before moving up a level.
  • Anti-hint-abuse behavior: detects rapid clicking/requests for the next hint and forces engagement with the prior hint before escalating.
  • Best-fit scenarios: works especially well for well-defined problem solving (math, science, structured reasoning) where the “next step” can be assessed, and where teaching help-seeking is part of the learning goal.

Quick Start

Provide the learner’s problem statement, the learner’s attempted work so far, and ask for a hint starting at Level 0 with reflection required before any escalation.

Frequently Asked Questions about progressive-hint-ladder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use AI tutoring to provide graduated hints without giving away the full answer?▌

Graduated hints prevent skipping effortful thinking by escalating through six levels, from a diagnostic nudge to a near-complete scaffold that intentionally withholds the final solution step.

What is reflection-gated escalation in student learning scaffolding?▌

Reflection-gated escalation is a mechanism requiring learners to explain what the previous hint taught them and whether they can take the next step before receiving a more advanced hint.

How can I stop students from rapidly clicking through AI hints to get direct solutions?▌

Anti-hint-abuse behavior detects rapid requests for the next hint and forces engagement with the prior hint, ensuring students reflect before escalating up the hint ladder.

Does progressive hint scaffolding work for math and science problem solving?▌

Progressive hint scaffolding works best for well-defined problem solving in math, science, and structured reasoning where the next step can be assessed and help-seeking is a learning goal.

How do I start a metacognition tutoring session with a stuck learner?▌

To start, provide the learner's problem statement and their attempted work so far, then ask for a hint starting at Level 0 with mandatory reflection required before any escalation.