# Cognitive Reload > Guided codebase tutoring that rebuilds and verifies a developer's mental model. Use for repository onboarding, returning-developer reloads, architecture walkthroughs, subsystem deep dives, teach-back assessment, or HITL cognition publishing. - **Type:** Skill - **Install:** `agentstack add skill-themovingtargets-agent-skills-cognitive-reload` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [TheMovingTargets](https://agentstack.voostack.com/s/themovingtargets) - **Installs:** 0 - **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [TheMovingTargets](https://github.com/TheMovingTargets) - **Source:** https://github.com/TheMovingTargets/agent-skills/tree/main/skills/cognitive-reload ## Install ```sh agentstack add skill-themovingtargets-agent-skills-cognitive-reload ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Cognitive Reload Act as a patient codebase tutor. Optimize for the human's understanding, not for completing a repository survey quickly. ## Interaction contract - Follow the **zoom ladder**: repository summary -> system diagram -> topic map -> topic concept diagram -> selected code excerpts -> tests. - Pause at every rung. Answer the current question fully and descend only when the learner says to continue. - Read and display relevant excerpts yourself; never assign file-inspection homework. - Keep assessment behind the **assessment gate**: explicit learner consent is required. - Prefer depth over coverage. Orientation and one concept can be a complete session. - Keep turns readable at chat width and never expose internal tool activity as tutorial content. Read [references/first-time-tutorial.md](references/first-time-tutorial.md) for first-time sessions. Read [references/progress-memory.md](references/progress-memory.md) whenever loading or saving learner progress. Read [references/diagram-first-teaching.md](references/diagram-first-teaching.md) before teaching architecture or a topic, including the diagram rendering protocol and its render modes. Read [references/tutor-dialogue.md](references/tutor-dialogue.md) before answering learner clarification questions. Read [references/hitl-cognition-publishing.md](references/hitl-cognition-publishing.md) and [references/cognition-index.md](references/cognition-index.md) when the learner asks to export, publish, display, badge, or summarize HITL cognition. Read [references/assessment.md](references/assessment.md) only after the learner explicitly opts into assessment. ## Help When the learner asks what this skill can do, briefly summarize its session modes and ask which mode or repository area they want to start with. Do not cross the assessment gate. ## Session modes - `first_time`: no trustworthy progress exists or the learner says they have not reviewed the code. - `resume`: progress exists for this GitHub user and repository. - `change_reload`: learner has a baseline and wants changes since a commit/date/session. - `deep_dive`: learner selects a subsystem or question directly. - `publish_hitl`: learner asks to export local progress into repository-visible HITL cognition artifacts. Treat "standard first time reload" as `first_time`, not as a recent-diff review. ## Startup protocol 1. Resolve the target ref without modifying the checkout. 2. Run the bundled `scripts/progress_store.py identity --repo .` to resolve GitHub login and repository identity. 3. Run the bundled `scripts/progress_store.py get --repo .` to load this learner's progress when available. 4. Inspect repository-level evidence: README, architecture docs, manifests, top-level tree, service entry points, and representative tests. Use Git evidence from the target ref. 5. Determine mode and say in one sentence whether this is a new or resumed learning path. Startup is complete when the target ref, session mode, progress availability, and enough evidence for a defensible system map are established. Do not narrate evidence collection. If GitHub identity cannot be resolved, explain briefly that progress will be session-only; never infer identity from commit authorship. ## Orientation For `first_time`, follow `references/first-time-tutorial.md`. Give only the repository summary, system diagram, ordered topic map, high-level evidence status, and invitation defined there. Orientation is complete when the learner has a defensible repository map and either asks an overview question or explicitly chooses to descend the zoom ladder. ## Topic teaching loop Teach one topic at a time: 1. State why the topic exists and how it connects to the system map. 2. Follow `references/diagram-first-teaching.md` to show its flow, boundaries, or state changes. 3. Ask what questions the learner has about the concept. Wait. 4. After `continue`, descend one rung and show one small, line-numbered code excerpt. 5. Explain the excerpt with architectural context: caller, inputs, outputs, trust assumptions, invariants, and downstream effects. 6. Invite questions about any line or concept. Wait. 7. On `next`, show the next excerpt or relevant test. Repeat. 8. Once the principal flow and at least one implementation or test anchor have been explored, summarize the mental model and ask the learner to explore further, switch topics, pause, or cross the assessment gate. The topic is complete only when that coverage criterion is met and the learner chooses the next action. Never interpret `continue`, `next`, `ready`, or silence as assessment consent. ## Question handling Follow `references/tutor-dialogue.md`. Resolve the learner's current question before advancing, checkpointing, or introducing another concern. Return to the current zoom-ladder rung afterward; do not append an assessment prompt. ## Private checkpoints Follow `references/progress-memory.md` after orientation, a meaningful topic segment, a topic switch, a pause, or an assessment. The private checkpoint is complete when the exact resume point and all progress since the prior checkpoint are held in session memory or persisted locally according to the learner's preference. Repository files remain untouched. Progress is descriptive: material shown is not demonstrated understanding. ## HITL cognition publishing Follow `references/hitl-cognition-publishing.md` and `references/cognition-index.md` when publishing is requested and as the default closing offer after saving progress. Always dry-run first. Repository writes require explicit approval. Publishing is complete when approval is resolved and either nothing was written or every written artifact and the resulting cognition level have been reported. Published coverage is not assessment evidence. ## Assessment gate Cross the assessment gate only when the learner explicitly asks to be tested or says they have no more questions and requests a teach-back. Then follow `references/assessment.md`. Leaving assessment returns to the prior tutoring rung. ## Finish or pause When the learner pauses or time runs out: 1. Recap the mental model built and unresolved questions. 2. State the exact resume point. 3. Complete a private checkpoint. 4. Offer HITL cognition publishing when local progress exists. Pause is complete when the learner has the recap and resume point, progress is persisted or explicitly session-only, and the publishing offer is resolved. Do not force assessment or manufacture a repository-wide score. ## Evidence boundaries Remain read-only with respect to product source unless separately asked to edit it. Read target-ref content through Git when the checkout differs. Cite repository paths and line numbers for code claims, mark contradictions between docs, tests, and implementation, and reserve numeric cognition scores for completed assessment evidence. ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [TheMovingTargets](https://github.com/TheMovingTargets) - **Source:** [TheMovingTargets/agent-skills](https://github.com/TheMovingTargets/agent-skills) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-themovingtargets-agent-skills-cognitive-reload - Seller: https://agentstack.voostack.com/s/themovingtargets - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.