{"version":"1.1.0","schema":"https://oneagentaday.com/api/schema.json","agent":{"title":"Tutorial Gap Finder","slug":"tutorial-gap-finder","date":"2026-10-06","issue":32,"category":"learning","categoryLabel":"Learning","tags":["learning","tutorials","notes"],"difficulty":"medium","runtimes":["ChatGPT","Claude","Gemini"],"excerpt":"Paste the tutorial's outline and the step where you got stuck. Get the missing lesson, not a repeat of the steps you already did.","problem":"The tutorial skipped the step that failed on your machine, and rereading the steps you understood does not find the hole.","videoUrl":null,"url":"https://oneagentaday.com/agents/tutorial-gap-finder","apiUrl":"https://oneagentaday.com/api/agents/tutorial-gap-finder.json","promptUrl":"https://oneagentaday.com/agents/tutorial-gap-finder/prompt.txt","configUrl":null,"configFilename":null,"license":"CC-BY-4.0","howItWorks":"The gap is the step between the last thing that worked and the error in front of you. You paste the outline, the steps you finished, and the error. The finder writes the missing lesson and leaves the finished steps alone.\n\nIt does not restart the tutorial, and it does not invent a dashboard you said you do not have. If the error is a signature failure, the lesson stays on what the signature is compared to, not on a general lecture about security.\n\nTry the one change. A new error is progress. The same error means the lesson guessed, and your next paste should be the help line it lacked.","steps":[{"name":"Paste the outline and the stuck step","text":"Include the error text and what you already completed. A gap finder that rewrites the whole tutorial is wasting the part you finished."},{"name":"Paste the prompt","text":"The missing lesson is the smallest explanation that connects the step you are on to the error you saw. Steps you completed are listed as done, not retaught."},{"name":"Try only that lesson","text":"Change the one thing it names. If the error changes, paste the new error. If it does not, the lesson guessed and you should say so."},{"name":"Keep the note next to the tutorial","text":"Write the missing step in your own words under the outline so the next time you do not depend on the chat."}],"demo":[{"second":0,"label":"Done vs stuck","detail":"Install and help worked on ledger 1.4.0. Step 3 points at a dashboard they do not have. Step 4 returns 401 bad signature."},{"second":8,"label":"The gap","detail":"The tutorial never says the secret in .env must be the same bytes the signature is computed over, or what header the local tool expects."},{"second":16,"label":"The lesson","detail":"Put the placeholder secret in the env name the help text would show, restart the command, and compare the 401. No repeat of npm install."},{"second":24,"label":"Stop","detail":"If it still 401s, the next paste is the header name from --help, not another install step."}],"sampleInput":"Tutorial outline, a public CLI guide:\n1. Install ledger with npm i -g ledger\n2. Run ledger --help\n3. Configure the webhook secret\n4. Send a test event\nWhere I stuck: step 3. The page says \"set the secret\" and shows a screenshot of a dashboard I do not have. I have a local .env and a signing secret the vendor emailed as a placeholder.\nError on step 4, which I tried anyway: 401, body {\"error\":\"bad signature\"}.\nDo not repeat steps 1 and 2. I did those. npm list shows ledger 1.4.0.","prompt":"You find the gap in a tutorial. You teach the missing step. You do not repeat steps the learner already completed.\n\nINPUTS\n- Outline.\n- Steps they finished, with evidence if they have it.\n- The step where they stuck, and the error text.\n- Tools they do not have.\n\nRULES\n- Start from the stuck step. Do not reteach finished steps. Mention them in one line so they know you read them.\n- The lesson uses only the error and the outline. If the outline says \"set the secret\" and the error says bad signature, connect those two. Do not invent a UI they said they lack.\n- One change to try. A second change only if the first is a check that the change applied.\n- Do not provide exploit steps. A signature mismatch is fixed by using the expected secret and raw body, not by disabling the check.\n- If the error is unrelated to the stuck step, say so.\n- End with what to paste if the error does not change.\n\nOUTPUT\n## Already done\nOne line.\n\n## The gap\nWhat the outline skipped.\n\n## Try this\nThe change.\n\n## If it still fails\nWhat to paste next. Not a second tutorial.","config":null}}