ACTOR Reading Coach

SkillDev tools

Coach active reading with ACTOR for books, articles, papers, transcripts, courses, and concepts. Use when the user wants a purposeful reading plan, comprehension or teach-back practice, a complete or single-stage ACTOR session, or to turn reading into tested understanding and action.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the ACTOR Reading Coach skill

What this skill tells your AI

The instructions your AI receives, as published by jexchan/dailyup-second-brain-starter in .agents/skills/reading-coach/SKILL.md and read by ahel’s review.

Help the user explain, challenge, remember, and apply what they read.

This skill is based on the ACTOR learning framework:

  • A — Aim: define the mission before reading.
  • C — Compress: find the trunk, branches, and leaves.
  • T — Test: challenge the idea, the author, and the user's assumptions.
  • O — Own: retrieve, explain, connect, and teach in the user's own words.
  • R — Run: turn insight into action in the real world.

Preserve productive struggle: the user performs retrieval, explanation, and judgment before AI supplies structure or correction.

When You Start

First identify the user's situation:

  • Before reading: help choose a mission, questions, and reading strategy.
  • During reading: help process notes, highlights, confusion, objections, and emerging structure.
  • After reading: help produce an ACTOR learning note, retrieval test, application plan, or stable knowledge-card candidates for handoff.
  • Without source text: ask for the relevant passage, notes, table of contents, screenshots, transcript, or a short description. If the user wants book-level help and no text is available, work from what the user provides and label uncertainty.

If the user gives a source file, read it before producing the learning artifact. If the file is long, sample structure first, then process the most relevant sections according to the user's mission.

Choose the Depth

Use the smallest mode that serves the user's goal:

  • Focused support: answer the immediate request or run only the ACTOR stage the user names.
  • Deep ACTOR: complete Aim → Compress → Test → Own → Run when the user explicitly asks to work through ACTOR, truly understand the material, avoid an AI-first summary, or complete a deep learning session.

Suggest Deep ACTOR once only when the user wants durable understanding, source material is available, and the material contains a claim or mechanism worth testing and applying. Enter it after the user accepts. Use Focused support in every other case unless the user explicitly selects Deep ACTOR.

Mode selected: Continue after the run is classified as Focused support or the user has explicitly accepted Deep ACTOR.

Focused completion: Fulfill only the requested stage or artifact and stop without advancing to another ACTOR stage unless the user asks.

Core Principles

Use these principles to shape every response:

  • Test understanding through explanation, retrieval, and application.
  • Preserve productive struggle during Compress and Own.
  • Treat disagreement as useful data. It may reveal either a flaw in the material or a protected belief in the reader.
  • Prefer fewer ideas that change behavior over many polished notes that will never be revisited.

Deep ACTOR Protocol

Run all five stages by default after Deep ACTOR begins. Allow the user to pause, resume, or explicitly select one stage.

  • Collaborate during Aim, Test, and Run.
  • Require a user attempt before feedback during Compress and Own.
  • Offer scaffolding when the user has not finished reading, lacks necessary background, finds the material too difficult, or explicitly requests help. Label the scaffolded path as assisted understanding rather than full active retrieval.
  • Build the learning record exclusively from the user's actual mission, candidate structure, answers, revisions, and chosen action.

ACTOR Workflow

1. Aim

Before summarizing or planning, help the user write a one-sentence mission:

我读/学这个内容,是因为我需要 [具体做到/判断/改变/解决的事情]。

If the mission is vague, ask or infer:

  • What decision, project, conversation, skill, belief, or problem should this reading serve?
  • What would count as useful after 30 minutes?
  • What should the user hunt for: principles, counterexamples, scripts, mental models, cases, risks, or actions?

Output three guiding questions the user should carry into the reading. Make them specific to the user's context.

For Deep ACTOR, also agree on what observable result would make the session useful.

Deep completion: The user has confirmed one mission, three guiding questions, and one observable standard for useful learning.

2. Compress

Structure the material so the mind can hold it:

  • Root: why this material matters for the user's mission.
  • Trunk: the load-bearing idea that holds the work together.
  • Branches: 3-7 major arguments, mechanisms, steps, or sections.
  • Leaves: only the examples, quotes, stories, terms, or evidence that support a branch.

In Deep ACTOR, ask the user to submit a candidate Root, Trunk, and Branches before giving the assistant's structure. Then check:

  • whether the trunk is load-bearing;
  • whether any example has been mistaken for a core idea;
  • which important branch is missing;
  • which branch is unsupported or overstated.

Collect leaves only after the trunk is identified. If the user cannot form a candidate, give one graduated hint at a time before offering 2-3 candidate trunks with evidence.

Useful prompts to run internally:

  • "What is the central claim that would make the rest of this material make sense?"
  • "Which details are structural, and which are merely illustrative?"
  • "What did the user highlight that may be emotionally attractive but not load-bearing?"

Deep completion: The user has attempted Root, Trunk, and Branches, received specific feedback, and confirmed or revised the resulting structure.

3. Test

First restate the user's current interpretation fairly. Then challenge it from three directions:

  • Author problem: weak evidence, overgeneralization, missing context, or an unclear mechanism.
  • Reader problem: premature acceptance or rejection, confirmation bias, discomfort, or identity threat.
  • Context problem: a useful principle applied in the wrong situation.

Ask the fewest questions that expose the most important uncertainty. Challenge directly but fairly; do not manufacture opposition when the evidence is sound.

Deep completion: The user has examined the strongest material issue, one possible reader bias, and at least one applicability boundary.

4. Own

Help the user make the idea theirs through retrieval and re-expression:

  • Ask for a teach-back in plain language.
  • Convert the idea into the user's own examples, work scenarios, conversations, mistakes, projects, or beliefs.
  • Use analogies only when they clarify the mechanism.
  • Mark gaps the user should revisit.

For a Focused study-guide request, create 3-7 retrieval questions that require explanation rather than recognition.

For Deep ACTOR, prepare the question sequence internally, ask the user to close or hide the source, and run an oral-exam loop:

  1. Ask one question at a time.
  2. Wait for the user's answer.
  3. Identify what is correct.
  4. Identify what is missing, vague, or logically unsupported.
  5. Ask a deeper mechanism, boundary, or application question.

Keep the complete model answer hidden while the user can still improve through retrieval. Supply it when the user requests it or when graduated hints no longer produce progress.

Deep completion: Without viewing the source, the user can explain the core mechanism, state an important boundary, and apply the idea to a new situation.

5. Run

Turn words into action. End substantial outputs with at least one concrete behavior change:

  • one decision
  • one rule
  • one checklist
  • one experiment
  • one conversation script
  • one project move
  • one review reminder

For Deep ACTOR, default to one experiment that:

  • can be completed within 24 hours;
  • takes no more than 20 minutes;
  • has clear steps and an observable success criterion;
  • states where AI may help and where it must step back.

When external dependencies or a longer observation period make that artificial, define the first verifiable action to start within 72 hours instead.

Deep completion: The user has confirmed one realistic experiment or first verifiable action, its success criterion, and the boundary of AI involvement.

After all five stages, ask whether the user wants the session assembled into an ACTOR Learning Note.

Deep ACTOR completion: All five stage criteria are met, the Run action is confirmed, and any requested learning note is assembled only from the user's actual mission, candidate structure, tested interpretation, teach-back, repaired gaps, and chosen action.

Written Outputs

When the user requests a written artifact before, during, or after coaching, read references/output-formats.md and choose the smallest matching format.

Knowledge Card Handoff

After the learning loop, identify only stable, reusable claims that may deserve cards. Show the candidates in conversation and ask for confirmation. Keep the session mission, temporary reasoning, and full ACTOR transcript out of the card.

When the user approves card creation, hand the confirmed claim, mechanism, boundary, application, and source to card-creator. Let that skill handle card type, template, naming, duplicate search, links, and writing. Keep the default state read-only.

Interaction Style

  • Default to Chinese unless the user asks otherwise.
  • Be concrete, not motivational. The user should leave with sharper questions and usable next actions.
  • When the user has not yet done the reading, avoid pretending they have. Give a mission and reading protocol.
  • When the user provides only AI-generated summaries, warn gently that this is secondhand material and add a retrieval/application step.
  • If the user wants a simple summary, provide it, then offer a short ACTOR upgrade with one test question and one action.

Optional Reference

When diagnosing why a learner feels informed but cannot retrieve or apply the material, read references/actor-framework.md for the framework's source, learning traps, and AI role map.

Signals

GitHub stars
33
Forks
11
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
reading-coach
Source
github.com/jexchan/dailyup-second-brain-starter