Agent skill

Readback

by iurysza in iurysza/module-graph

Restate the user's intention to verify alignment. An agent skill from iurysza/module-graph.

MITAuto-check passed

Install Readback

skills CLI
$ npx skills add iurysza/module-graph --skill readback -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install iurysza/module-graph readback --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/iurysza/module-graph.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/readback .claude/skills/readback && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
readback
GitHub stars
419
Token cost
~505 tokens
SKILL.md length
285 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

Restate the user's intention to verify alignment. An agent skill from iurysza/module-graph.

  • Works in 6 steps: Inspect the relevant context. → Infer the user's intention or meaning. → Keep important constraints and conditions. → …
  • SKILL.md covers Definition, Purpose, Process and Domain Language +…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Readback is an agent skill from iurysza/module-graph. Restate the user's intention to verify alignment.

Its SKILL.md is about 510 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: A Gradle Plugin for visualizing your project's structure, powered by mermaidjs. The licence is MIT.

Example prompts

  • “/readback”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Inspect the relevant context.
  2. Infer the user's intention or meaning.
  3. Keep important constraints and conditions.
  4. Name assumptions or unresolved ambiguity.
  5. Give the readback.
  6. Stop and wait for confirmation or correction.

What it can do on your machine

Read from SKILL.md and the folder at commit 15b0135. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Readback loads about 505 tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 285 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~15
When it runs · the whole SKILL.md, loaded when a task matches
~505

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from iurysza/module-graph at commit 15b0135, republished under its MIT licence (© iurysza). 285 words, ~505 tokens.

Download SKILL.mdSave it as .claude/skills/readback/SKILL.md (or your agent's skills folder).
name
readback
description
Restate the user's intention to verify alignment.
metadata.category
writing-style

Definition

A readback repeats an instruction, request, or piece of information back to the user. It states what the agent believes the user asked or meant, so the user can confirm or correct the understanding before work continues.

Use it to catch misunderstandings before they become wrong work.

Purpose

  • Confirm that the agent correctly received and understood the user's instruction or intent.
  • Allow the user to verify accuracy and correct any misunderstanding.
  • Prevent errors caused by acting on a mistaken interpretation.

Process

  1. Inspect the relevant context.
  2. Infer the user's intention or meaning.
  3. Keep important constraints and conditions.
  4. Name assumptions or unresolved ambiguity.
  5. Give the readback.
  6. Stop and wait for confirmation or correction.

Domain Language + Plain-English Gloss

Use established terms of art when they accurately describe the user's intent, but immediately gloss them in plain English.

Prefer:

Use a vertical slice — build one small part of the feature end-to-end so it can actually be tested.

Over either:

Use a vertical slice.

or:

Build one small part through every layer of the system...

The idea is to preserve useful domain language without requiring the user to already know it.

Do not introduce jargon just to sound technical. Use it when it gives the idea a useful name.

Rules

  • Do not turn the readback into an implementation plan.
  • Do not silently resolve meaningful ambiguity.
  • Preserve conditions closely enough that their meaning cannot be lost.
  • Use domain language when useful, followed by a plain-English gloss.
  • If the user corrects the readback, update it before proceeding.

Principle

Make sure your response sounds like a person talking to another. Drop jargon, ceremony, repetition, and unnecessary structure. Preserve the meaning and try to match user's tone/voice.

© iurysza, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/readback of iurysza/module-graph.

Open the folder on GitHubat commit 15b0135

Compare with similar skills

Readback next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Readback compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Readback this skilliurysza/module-graph419—~505Automated safety check: PassMIT
Intent Requirements IntakeYeachan-Heo/oh-my-claudecode40k—~1.5kAutomated safety check: PassMIT
Ccs Alignthedotmack/claude-mem98k—~6.1kAutomated safety check: PassApache-2.0
Browser Intentruvnet/ruflo74k—~1.2kAutomated safety check: NotesMIT
Intent Recognitionn8n-io/n8n207k—~7.1kAutomated safety check: PassCustom licence
Bio Read Alignment Bowtie2 AlignmentGPTomics/bioSkills1.2k1 repos~3.6kAutomated safety check: PassMIT

Similar skills

  • Intent Requirements Intake

    Yeachan-Heo/oh-my-claudecode

    Turns a pasted chat log or spoken problem report from support or ops staff into a reviewed five-section intent.md through numbered batches of questions.

    40k GitHub stars~1.5k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Ccs Align

    thedotmack/claude-mem

    Run the CCS Align seat's hourly breathing cycle — prove the local claude-mem worker is healthy, pull needle observations through search → timeline → getobservations, land them in a seat-owned middle…

    98k GitHub stars~6.1k tokensUpdated yesterday
    Auto-check passed
  • Browser Intent

    ruvnet/ruflo

    Execute a natural-language browser intent via page-agent (browseract) when the target is easier to describe than to select — degrades gracefully when page-agent or an OpenAI-compatible LLM provider…

    74k GitHub stars~1.2k tokensUpdated today
    Productivity & AutomationAuto-check: notes
  • Official

    Classifies automation requests using two decisions: anchor (which primitive owns the top-level control flow — workflow-anchored, agent-anchored, needs-clarification, or out-of-scope) and embedsother…

    207k GitHub stars~7.1k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Aligns DNA short reads to a reference with Bowtie2, choosing end-to-end (whole read must align) vs local (soft-clip read ends) mode and a sensitivity preset; the de-facto aligner for ChIP-seq…

    1.2k GitHub starsUsed in 1 repo~3.6k tokens
    Research & ScienceAuto-check passed
  • Aligns RNA-seq reads to a genome with STAR, the fast splice-aware aligner whose splice-junction database (built from a GTF at sjdbOverhang = readlength-1) and two-pass mode set junction sensitivity…

    1.2k GitHub starsUsed in 1 repo~4.7k tokens
    Research & ScienceAuto-check passed

More from iurysza/module-graph

All 16 skills in this repo
  • Audio Transcribe

    iurysza/module-graph

    Transcribes local audio into Markdown with Gemini 3.5 Transcribe, including speaker labels and provider timestamps.

    419 GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Chatgpt Imagegen

    iurysza/module-graph

    Generates or edits raster images through OpenAI's Image API.

    419 GitHub starsUsed in 1 repo~726 tokens
    Auto-check passed
  • Gemini Tts

    iurysza/module-graph

    Generates spoken MP3 audio from text or Markdown with Gemini TTS.

    419 GitHub starsUsed in 1 repo~968 tokens
    Auto-check passed
  • Skill Cleaner

    iurysza/module-graph

    Audits installed Agent Skills for duplicates, unused candidates, loaded roots, oversized descriptions, and prompt cost.

    419 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Brainstorming

    iurysza/module-graph

    Explores and validates a feature, component, workflow, or behavior change before implementation.

    419 GitHub stars~723 tokensUpdated today
    Auto-check passed
  • Domain Modeling

    iurysza/module-graph

    Maintains project domain language, context maps, diagrams, and architectural decisions under ai-artifacts.

    419 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Questions about Readback

What does Readback do?

Restate the user's intention to verify alignment. An agent skill from iurysza/module-graph. Readback is an agent skill from iurysza/module-graph. Restate the user's intention to verify alignment.

How do I install Readback in Claude Code?

Run `npx skills add iurysza/module-graph --skill readback -a claude-code`. Or copy the skill folder (.agents/skills/readback in iurysza/module-graph) into .claude/skills/readback in your project. Claude Code loads it when a task matches its description.

How do I install Readback in Codex?

Run `npx skills add iurysza/module-graph --skill readback -a codex`. Or copy the skill folder (.agents/skills/readback in iurysza/module-graph) into .agents/skills/readback in your project. Codex loads it when a task matches its description.

Can I use Readback in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add iurysza/module-graph --skill readback -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/readback, .gemini/skills/readback, .github/skills/readback and .opencode/skills/readback in your project.

What does Readback need to run?

SKILL.md names no scripts, command-line tools or credentials: Readback is instructions for the agent only.

Does Readback access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Readback safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Readback use?

Readback is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Readback use?

About 505 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Readback?

Skills that share tags, products or a category with Readback: Intent Requirements Intake (Yeachan-Heo/oh-my-claudecode, 40k stars), Ccs Align (thedotmack/claude-mem, 98k stars), Browser Intent (ruvnet/ruflo, 74k stars) and Intent Recognition (n8n-io/n8n, 207k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Readback?

iurysza (a GitHub user) maintains it in iurysza/module-graph, which has 419 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 7, 2026.

Source: iurysza/module-graph on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.