tour

A short conversational introduction to Scriptorium, a toolkit for working with manuscripts, grants, and reviews. It asks about the user's work, explains the relevant tools, and suggests a first step.

In plain words
What is it for?
Use it when starting with Scriptorium to discuss your project, see an example MANUSCRIPT_STATE.yaml file, and decide whether to initialize a manuscript workspace.
Why use it?
It helps new users get oriented without requiring them to understand the whole toolkit at once.

Skill for Claude CodeCodex

Part of the scriptorium plugin — 16 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/seandavi/scriptorium/tour
Any agent
npx skills add seandavi/scriptorium --skill tour
Clone the repo
git clone --depth 1 https://github.com/seandavi/scriptorium

Made for: Claude Code, Codex.

Or install scriptorium, the plugin that ships this one along with the rest of its 16 skills.

Per session 138 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,761 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00138 $0.02761
Opus 5 $0.00069 $0.01380
Sonnet 5 $0.00028 $0.00552
Haiku 4.5 $0.00014 $0.00276

Measured 3d ago against content hash 16d9f72c0461, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

tour scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/tour/SKILL.md · 263 lines

How it starts

The opening of the file, as written. The whole thing — 263 lines — stays where its author put it; the contents beside it link to each section on GitHub.

tour: conversational onboarding for new users

You are running scriptorium's tour skill. Your job is to orient a new user to scriptorium through a short, friendly dialog — not a document dump — and end with a concrete first move.

You write nothing to disk. You invoke no other skill. You may read MANUSCRIPT_STATE.yaml if it exists in the current directory, but only to detect whether the user has used scriptorium here before.

Invocation discipline

Invoke this skill when:

  • The user types /scriptorium:tour.
  • The user asks "what is scriptorium?" or "how do I get started?" and no skill is currently running.
  • A maintainer or another user has pointed them at this skill as their first step.

Do not invoke tour as a follow-up to another skill, and do not chain into a follow-up skill at the end. The tour ends with a suggestion of a next move; the user invokes it themselves.

What "tour" is and is not

Tour is Tour is not
A 3-4 turn conversation A one-shot wall of text
Tailored to the user's stated context A generic system overview
Ends with one concrete next command A menu of every skill, equally weighted
Strictly read-only of the user's project Anything that touches MANUSCRIPT_STATE
The thing a maintainer can point at A replacement for INSTALL.md

tour is the friendlier counterpart to scriptorium:explain: explain produces a static synthesis (one shot, reference-shaped); tour is a conversation that adapts to the user. They overlap on the Venn diagram of "tell me about scriptorium", but their shapes are different. tour suggests explain at the end for users who want to drill in.

Conversational style

tour always runs at the full level regardless of any saved meta.guidance_level. This skill IS orientation; truncating it defeats the point. If a returning user invokes tour and clearly already knows scriptorium, detect that (see the next section) and skip to the relevant subset rather than truncating prose.

Read the full file on GitHub · 263 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 263 lines · 138 tokens per session scan A 16d9f72c0461

Subscribe to this mod's changes

tour is a skill published in the GitHub repository seandavi/scriptorium (3 stars, last pushed 1mo ago), licensed MIT. It adds 138 tokens to every session and 2,761 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

agent-challenges

Agent skill for challenges - invoke with $agent-challenges.

ruvnet/ruflo · 15 tokens

cangjie-skill

Distill a book, long-video transcript, podcast, course, or interview into a coherent set of executable skills. Use when the user asks to "拆书" / "蒸馏一本书" / "把 XX 书做成 skill" / "把这个视频/播客/课程蒸馏成 skill" / "turn a book or video into skills" — i.e. wants the frameworks, principles, and methodologies in long-form content…

kangarooking/cangjie-skill · 143 tokens

naval-almanack

当用户询问《纳瓦尔宝典》这本书本身(书名/作者/章节/整书概览/术语),或涉及本书未独立成 Skill 的主题时调用: 幸福训练/欲望管理、接受与内耗、冥想与心猴、地位游戏与攀比、选朋友与圈子、打工vs创业(委托代理)、 诚实沟通、身份与自我形象、期望与愤怒、生命意义、该不该信玄学(理性验证)、长期复利与声誉、判断力训练。 以下意图优先使用同包独立 Skill: wealth-structure(致富/股权期权)、productize-yourself(职业定位/副业方向)、…

kangarooking/cangjie-skill · 255 tokens

reading-metaskill

当用户想养成阅读习惯、问「读什么书/怎么读」「如何学习新领域/怎么入门某学科」时调用。 核心理念: 阅读是终极元技能; 读你所爱直到爱上阅读, 没有读完义务; 读原著与经典优先; 以教促学; 每天1-2小时即可进入极少数人行列。 不适用于: 具体某本书的书评、考试备考资料选择。 Triggers: 阅读/读书/怎么学习/入门/原著/书单/reading/how to learn.

kangarooking/cangjie-skill · 139 tokens

principal-agent

当用户选择职业/组织/合作方式、困惑「为什么大公司磨洋工/小公司拼命」「该不该自己干」时调用。 核心理念: 委托人(主人)会把事做好, 代理人会为自己利益优化; 收益与创造价值绑得越紧, 越像委托人; 别让媒体洗脑你需要代理人。 不适用于: 具体薪酬谈判数字、组织架构设计细节。 Triggers: 激励/代理/主人/打工 vs 创业/利益绑定/principal/agent/incentive.

kangarooking/cangjie-skill · 134 tokens

rational-buddhism

当用户问某主张/玄学/灵修该不该信、想建立自己的验证标准、或寻找科学与精神的结合点时调用。 核心理念: 尝试一切, 亲自测试, 保持怀疑, 保留有用的, 舍弃没用的; 不可证伪的主张不进入基本真理; 冥想/接纳等内在技术可保留。 不适用于: 需要信仰安慰的临终/哀伤场景(尊重个体选择)。 Triggers: 该不该信/玄学/灵修/冥想/可证伪/验证/理性/rational buddhism/verify/belief.

kangarooking/cangjie-skill · 166 tokens