understand-repitch

Re-explains the current task at project altitude when the user loses the thread.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/mnazaal/dotfiles --skill understand-repitch-mnazaal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: understand-repitch
Source: https://github.com/mnazaal/dotfiles/tree/main/.agents/skills/understand-repitch
Command: npx skills add https://github.com/mnazaal/dotfiles --skill understand-repitch-mnazaal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Mid-conversation, users sometimes lose track of what the AI is doing — "wait, what?", "I'm lost", "I don't follow". This Skill stops forward work and re-pitches the current moment in plain language, grounded in project artifacts, instead of repeating the same explanation louder or continuing the task. ## Core Features & Use Cases - Immediate stop-and-repitch: Halts all forward work so the re-explanation is the entire next message, not a footnote to continued task execution. - Project-altitude framing: Restates what is being done and why it serves the project goal in one or two sentences before re-explaining the point that did not land. - Artifact-grounded language: Anchors statements in files, PLAN.md sections, commits, or log entries rather than conversation memory, using CONTEXT.md vocabulary. - Routing to deeper comprehension skills: Escalates to understand-project when the whole project thread is lost, or to plan-interview when the re-pitch reveals drift from the agreed plan. - Use Case: During a multi-step refactor the user replies "hold on, why are we touching this file?" — the Skill pauses the refactor, re-pitches the current step in plain project terms, and asks one check question before resuming. ## Quick Start Tell the AI "wait, I'm lost — re-explain what you're doing right now" and it will stop work and re-pitch the current step at project altitude.

Frequently Asked Questions about understand-repitch

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

FAQPage Schema
How do I get an AI assistant to re-explain what it is doing?▼

Signal confusion with phrases like "wait, what?", "I'm lost", or "re-explain". The Skill stops all forward work and re-pitches the current step in one or two plain sentences tied to the project goal, then asks at most one check question.

What triggers a mid-conversation re-pitch versus a full project re-explanation?▼

A re-pitch handles losing the current moment — one confusing message or step. If the user has lost the whole project thread, the Skill routes to understand-project instead, which rebuilds grasp of the entire project.

Does re-explaining mean the plan or work gets changed?▼

No. An interruption is treated as a comprehension gap, not disagreement or a change request. Nothing is decided, reverted, or simplified until the user explicitly says so.

When should I not use a quick re-pitch?▼

Avoid it when confusion traces to an overloaded term (resolve it via the glossary rule) or when the re-pitch reveals the work has drifted from the agreed plan — in that case stop and route to plan-interview or research-plan before resuming.

Why does the re-pitch reference files and commits instead of chat history?▼

Grounding statements in artifacts like PLAN.md sections, commits, and log entries keeps explanations verifiable and stable, whereas conversation memory can be ambiguous or misremembered.