Agent skill

Reader Simulation

by open-octo in open-octo/octo-agent

扮演一个指定的读者画像,第一次读这篇稿子,报告真实的阅读体验——哪里读进去了、 哪里走神、哪里犯困、哪里读不懂。Use when 用户说"站在读者角度看看这篇文章" "假设一个外行读者会怎么看这段""这篇文章对专业读者来说会不会太浅",需要的 是"读起来是什么感觉"而不是"哪里有技术性问题"。技术性的结构/论证问题诊断用 structural-diagnosis,逐段文字打磨用…

Apache-2.0Auto-check passed

Install Reader Simulation

skills CLI
$ npx skills add open-octo/octo-agent --skill reader-simulation -a claude-code

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

GitHub CLI
$ gh skill install open-octo/octo-agent reader-simulation --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/open-octo/octo-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/internal/skills/experts/reader-simulation .claude/skills/reader-simulation && 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
reader-simulation
GitHub stars
125
Token cost
~514 tokens
SKILL.md length
53 words
Files
3
Skills in repo
43
Repo updated
First seen
Licence
Apache-2.0

At a glance

扮演一个指定的读者画像,第一次读这篇稿子,报告真实的阅读体验——哪里读进去了、 哪里走神、哪里犯困、哪里读不懂。Use when 用户说"站在读者角度看看这篇文章" "假设一个外行读者会怎么看这段""这篇文章对专业读者来说会不会太浅",需要的 是"读起来是什么感觉"而不是"哪里有技术性问题"。技术性的结构/论证问题诊断用 structural-diagnosis,逐段文字打磨用…

  • 用户说站在读者角度看看这篇文章 假设一个外行读者会怎么看这段这篇文章对专业读者来说会不会太浅,需要的 是读起来是什么感觉而不是哪里有技术性问题。技术性的结构/论证问题诊断用 structural-diagnosis,逐段文字打磨用 line-polish
  • SKILL.md covers 前置:明确读者画像, 方法 and 边界
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Reader Simulation is an agent skill from open-octo/octo-agent. 扮演一个指定的读者画像,第一次读这篇稿子,报告真实的阅读体验——哪里读进去了、 哪里走神、哪里犯困、哪里读不懂。Use when 用户说"站在读者角度看看这篇文章" "假设一个外行读者会怎么看这段""这篇文章对专业读者来说会不会太浅",需要的 是"读起来是什么感觉"而不是"哪里有技术性问题"。技术性的结构/论证问题诊断用 structural-diagnosis,逐段文字打磨用 line-polish。

Its SKILL.md is about 510 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `PROVENANCE.md`).

The repository describes itself as: Open-source, single-binary, self-hosted AI agent — your models and data stay on your machine. A coding agent on par with Claude Code and a personal assistant lighter than… The licence is Apache-2.0.

When your agent uses it

  • 用户说站在读者角度看看这篇文章 假设一个外行读者会怎么看这段这篇文章对专业读者来说会不会太浅,需要的 是读起来是什么感觉而不是哪里有技术性问题。技术性的结构/论证问题诊断用 structural-diagnosis,逐段文字打磨用 line-polish

Example prompts

  • “站在读者角度看看这篇文章”
  • “假设一个外行读者会怎么看这段”
  • “这篇文章对专业读者来说会不会太浅”
  • “/reader-simulation”

What it can do on your machine

Read from SKILL.md and the folder at commit bffd192. 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

Reader Simulation loads about 514 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 53 words of instructions outside code blocks.

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

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 open-octo/octo-agent at commit bffd192, republished under its Apache-2.0 licence (© open-octo). 53 words, ~514 tokens.

Download SKILL.mdSave it as .claude/skills/reader-simulation/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
reader-simulation
description
扮演一个指定的读者画像,第一次读这篇稿子,报告真实的阅读体验——哪里读进去了、 哪里走神、哪里犯困、哪里读不懂。Use when 用户说"站在读者角度看看这篇文章" "假设一个外行读者会怎么看这段""这篇文章对专业读者来说会不会太浅",需要的 是"读起来是什么感觉"而不是"哪里有技术性问题"。技术性的结构/论证问题诊断用 `structural-diagnosis`,逐段文字打磨用 `line-polish`。
license
Apache-2.0 (adapted from haowjy/creative-writing-skills, skills/reader-sim/SKILL.md; complete terms in LICENSE.txt)
metadata.origin
"扮演指定读者画像、报告阅读体验而非技术批评、逐段锚定证据、 不擅自代表"通用读者""这套读者模拟机制,改编自 haowjy/creative-writing-skills 的 skills/reader-sim/SKILL.md (Apache-2.0);原文的5个"读者奖励通道"(沉浸感/文字美感/角色共情/…

Skill: reader-simulation

扮演用户指定的读者画像,像这个读者第一次读到这篇稿子那样去读,报告真实的 阅读体验。这不是技术性的批评,是"读起来是什么感觉"——哪里被吸引住了、 哪里开始走神、哪里犯糊涂、什么问题一直悬在脑子里没解决。

前置:明确读者画像

用户应该给出:读者对这个主题的熟悉程度、读者的阅读习惯/耐心、读者的年龄 或受众群体(如果相关)、读者对模糊/未解释术语的容忍度、这个读者已经知道 什么/不应该知道什么。

如果用户没给读者画像,先说清楚自己假设的是什么样的读者,再开始读。 不要用一个"通用读者"的反应来代表所有读者——不同的读者画像会读出完全不同 的体验。

方法

从头读到尾。通过下面几个"读者获得感"的通道追踪阅读体验:

  • 可信度与说服力:论证有没有让人信服,还是读到某处开始怀疑作者的 依据?留意哪里让你点头认同、哪里让你想问"这个结论是怎么来的"、哪里 一个不成立的例子让你对前面的内容也开始怀疑。
  • 理解摩擦点:哪里需要回读才能跟上、哪里一个术语没解释就用上了、 哪里代词指代不清、哪里逻辑跳跃让人跟不上。留意"我需要停下来想一下" 发生的具体位置。
  • 情感共鸣:(如果这篇文章带叙事/个人经历成分)哪里让你感同身受、 哪里的描述让你觉得隔靴搔痒、哪里的情绪表达和内容本身对不上。
  • 好奇心与追随欲:想不想知道接下来会讲什么、一个悬念/问题有没有 被解答、解答得太早还是太晚、什么时候开始不关心接下来讲什么了。
  • 阅读心流:读起来是不是顺畅、想不想继续读下去、哪里需要强迫自己 才能读下去、哪里难度突然变化(太密集、太简单、或者表达不清导致 节奏被打断)。

不是每个通道都需要平均着墨——哪里体验明显就多写哪里。长文章尤其要注意 中段——这是注意力最容易变薄的地方。

按阅读顺序报告体验:哪里被吸引住了、哪里走神了、心里悬着什么问题、 这些问题什么时候变化了。停留在"正在阅读"的状态里,不要变成技术批评家 ——读者模拟的价值就是这种真实的阅读感受,而不是"技术上哪里有问题"。

把每个判断锚定到文本:具体段落位置、简短引用,说明是哪句话产生了这种 体验。

开头先说整体读下来是什么感觉、哪几个通道信号最明显。结尾补充这几个通道 之外、作者应该听到的其他反馈。

边界

  • 不越界变成结构诊断或逐句批评。 报告的是"读起来是什么感觉",不是 "哪里有技术性问题"——技术性诊断用 structural-diagnosis,逐段文字 打磨用 line-polish。如果读的过程中发现了结构性问题,可以提一句 "这可能是个结构问题,建议跑一下 structural-diagnosis",但不要在这个 技能里展开分析。
  • 不代表"所有读者"。 报告的是指定画像这一个读者的体验,不是普适 结论。如果用户想知道不同读者群体的反应差异,分别跑几次、换不同画像。
  • 不用来证明作者对或错。 一个读者觉得某处读不懂,这是真实的信号, 但不代表这处一定要改成这个读者能懂的样子——作者可能就是在写给另一类 读者。报告体验,判断权在作者。

© open-octo, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in internal/skills/experts/reader-simulation of open-octo/octo-agent.

  • SKILL.md
  • LICENSE.txt
  • PROVENANCE.md

Open the folder on GitHubat commit bffd192

Compare with similar skills

Reader Simulation 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.

Reader Simulation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reader Simulation this skillopen-octo/octo-agent125—~514Automated safety check: PassApache-2.0
Eas Simulatorsickn33/agentic-awesome-skills47k1 repos~6kAutomated safety check: NotesMIT
Bilingual Paper ReaderYuan1z0825/nature-skills46k—~961Automated safety check: PassApache-2.0
Web Page ReaderHKUDS/Vibe-Trading35k—~627Automated safety check: PassMIT
Screen Reader Testingwshobson/agents40k8 repos~3kAutomated safety check: PassMIT
Simulateindranilbanerjee/digital-marketing-pro8541 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • Eas Simulator

    sickn33/agentic-awesome-skills

    Curated upstream guidance for Eas Simulator; use when the workflow matches the user goal.

    47k GitHub starsUsed in 1 repo~6k tokens
    MobileAuto-check: notes
  • Bilingual Paper Reader

    Yuan1z0825/nature-skills

    Creates a source-grounded Chinese-English reader for a research paper, with aligned text, figures, tables and equations, or answers questions about a given passage.

    46k GitHub stars~961 tokensUpdated today
    Research & ScienceAuto-check passed
  • Web Page Reader

    HKUDS/Vibe-Trading

    Converts web pages, articles and documentation links into clean Markdown through the read_url tool, which sends the full URL to the third-party Jina Reader service.

    35k GitHub stars~627 tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Screen Reader Testing

    wshobson/agents

    Test web applications with screen readers including VoiceOver, NVDA, and JAWS.

    40k GitHub starsUsed in 8 repos~3k tokens
    Frontend & DesignAuto-check passed
  • Simulate

    indranilbanerjee/digital-marketing-pro

    Run Monte Carlo simulations (default 10,000 iterations via revenue-simulator.py) of marketing scenarios — channel-mix shifts, budget reallocations, new-channel launches — reporting…

    854 GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Flux Balance Analysis Simulator

    aiming-lab/AutoResearchClaw

    Runs flux balance analysis and related constraint-based simulations on a COBRApy metabolic model, from standard FBA to gene knockouts and carbon source swaps.

    15k GitHub stars~2.1k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed

More from open-octo/octo-agent

All 43 skills in this repo
  • Image Gen

    open-octo/octo-agent

    Acquire images as files — generate them with an AI image model (14 providers: OpenAI/gpt-image, Gemini, Qwen, Zhipu, Volcengine, Stability, FLUX, Ideogram, MiniMax, and more), search openly-licensed…

    125 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check: notes
  • Office XLSX

    open-octo/octo-agent

    Create, read, and edit Excel (.xlsx) spreadsheets programmatically with openpyxl — cell values, formulas, styling (fonts/fills/borders/alignment/number formats), merged cells, multiple sheets…

    125 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check: notes
  • Artifact Design

    open-octo/octo-agent

    Design guidance for any HTML/Markdown file shown in octo's Artifacts panel — reports, dashboards, architecture/system diagrams, generated UIs, slide-style pages, 3D scenes.

    125 GitHub stars~2.7k tokensUpdated 2 days ago
    Auto-check passed
  • Code Review

    open-octo/octo-agent

    Review local code changes. An agent skill from open-octo/octo-agent.

    125 GitHub stars~942 tokensUpdated 2 days ago
    Auto-check passed
  • Ppt Master

    open-octo/octo-agent

    AI-driven multi-format SVG content generation system. An agent skill from open-octo/octo-agent.

    125 GitHub stars~23k tokensUpdated 2 days ago
    Auto-check: warnings
  • Config Setup

    open-octo/octo-agent

    Configure octo's global settings through guided conversation — set up AI model endpoints (providers, API keys, models), adjust agent defaults (reasoning effort, permission mode, coauthor, workspace…

    125 GitHub stars~3.3k tokensUpdated 2 days ago
    Auto-check passed

Questions about Reader Simulation

What does Reader Simulation do?

扮演一个指定的读者画像,第一次读这篇稿子,报告真实的阅读体验——哪里读进去了、 哪里走神、哪里犯困、哪里读不懂。Use when 用户说"站在读者角度看看这篇文章" "假设一个外行读者会怎么看这段""这篇文章对专业读者来说会不会太浅",需要的 是"读起来是什么感觉"而不是"哪里有技术性问题"。技术性的结构/论证问题诊断用 structural-diagnosis,逐段文字打磨用…. Reader Simulation is an agent skill from open-octo/octo-agent.

When should I use Reader Simulation?

Reader Simulation fits situations like: 用户说站在读者角度看看这篇文章 假设一个外行读者会怎么看这段这篇文章对专业读者来说会不会太浅,需要的 是读起来是什么感觉而不是哪里有技术性问题。技术性的结构/论证问题诊断用 structural-diagnosis,逐段文字打磨用 line-polish.

How do I install Reader Simulation in Claude Code?

Run `npx skills add open-octo/octo-agent --skill reader-simulation -a claude-code`. Or copy the skill folder (internal/skills/experts/reader-simulation in open-octo/octo-agent) into .claude/skills/reader-simulation in your project. Claude Code loads it when a task matches its description.

How do I install Reader Simulation in Codex?

Run `npx skills add open-octo/octo-agent --skill reader-simulation -a codex`. Or copy the skill folder (internal/skills/experts/reader-simulation in open-octo/octo-agent) into .agents/skills/reader-simulation in your project. Codex loads it when a task matches its description.

Can I use Reader Simulation 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 open-octo/octo-agent --skill reader-simulation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reader-simulation, .gemini/skills/reader-simulation, .github/skills/reader-simulation and .opencode/skills/reader-simulation in your project.

What does Reader Simulation need to run?

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

Does Reader Simulation 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 Reader Simulation 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 Reader Simulation use?

Reader Simulation is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reader Simulation use?

About 514 tokens (SKILL.md is roughly 2.1k 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 Reader Simulation?

Skills that share tags, products or a category with Reader Simulation: Eas Simulator (sickn33/agentic-awesome-skills, 47k stars), Bilingual Paper Reader (Yuan1z0825/nature-skills, 46k stars), Web Page Reader (HKUDS/Vibe-Trading, 35k stars) and Screen Reader Testing (wshobson/agents, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reader Simulation?

open-octo (a GitHub organization) maintains it in open-octo/octo-agent, which has 125 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on October 5, 2026.

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