reversa-docs-storyteller

reversa-docs-storyteller is a skill for Claude Code, Codex from sandeco/reversa. It costs 56 tokens per session (2,272 once invoked), scanned A, original, MIT.

A documentation storyteller for Reversa Docs that turns project specifications into an interactive glossary, a navigable slide deck, and feature pages. It is designed to help new team members understand a project quickly.

In plain words
What is it for?
Use it to generate or update the Reversa Docs glossary, slide deck, feature pages, project soul data, and feature index.
Why use it?
It turns scattered technical material into browsable explanations. It can work with existing feature pages or start from a project description when documentation is sparse.

Skill for Claude CodeCodex

Written for Claude Code and Codex: disable-model-invocation in frontmatter, but also agents/openai.yaml present. Also seen: mentions Claude Code; mentions Codex; mentions Gemini CLI.

Good fit Use it to generate or update the Reversa Docs glossary, slide deck, feature pages, project soul data, and feature index.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/sandeco/reversa/reversa-docs-storyteller
About the project

Reversa is a reverse-engineering framework that analyzes legacy software and turns its hidden business rules, code flows, and architectural decisions into executable specifications for AI coding agents. Teams use it to help agents safely understand and change systems that lack reliable documentation. The catalogue skills provide the specialized agent workflows used to perform this analysis.

sandeco/reversa · 1,571 stars · on GitHub

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.

Any agent
npx skills add sandeco/reversa --skill reversa-docs-storyteller
Clone the repo
git clone --depth 1 https://github.com/sandeco/reversa

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for reversa-docs-storyteller

README.md
[![agentmods](https://agentmods.dev/badge/skills/sandeco/reversa/reversa-docs-storyteller/github.svg)](https://agentmods.dev/skills/sandeco/reversa/reversa-docs-storyteller)
Your own site
<a href="https://agentmods.dev/skills/sandeco/reversa/reversa-docs-storyteller"><img src="https://agentmods.dev/badge/skills/sandeco/reversa/reversa-docs-storyteller/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for reversa-docs-storyteller

Your own site · 80×15
<a href="https://agentmods.dev/skills/sandeco/reversa/reversa-docs-storyteller"><img src="https://agentmods.dev/badge/skills/sandeco/reversa/reversa-docs-storyteller.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 56 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,272 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.1 $0.00056 $0.02272
Opus 5 $0.00028 $0.01136
Sonnet 5 $0.00011 $0.00454
Haiku 4.5 $0.00006 $0.00227

Measured 10d ago against content hash be657705d5cd, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

reversa-docs-storyteller 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 10d 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.

agents/reversa-docs-storyteller/SKILL.md · 190 lines

How it starts

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

Você é o Storyteller do Time Reversa Docs. Transforma specs, conceitos e histórias do sistema em narrativa visual. Foca em onboarding humano: alguém entrando no projeto deve sair sabendo do que se trata em poucos minutos de navegação.

Posicionamento

Terceiro agente do pipeline /reversa-docs. Não exige Analyst nem Cartographer como pré-requisito hard: o deck adapta-se às páginas existentes. Em greenfield com apenas soul.md, ainda produz glossário + deck mínimo de 4 slides.

Inputs

  • _reversa_sdd/ (specs por feature)
  • .reversa/soul.md (alma do projeto)
  • _reversa_docs/.config.json
  • _reversa_docs/assets/data/features-index.json (gerado pelo próprio Storyteller)
  • Skill reversa-image-prompt-json (opcional, capas em estilo premium)

Outputs

  • _reversa_docs/glossario.html
  • _reversa_docs/deck.html
  • _reversa_docs/features/<nome-kebab>.html (uma por spec selecionada)
  • _reversa_docs/assets/data/soul.json
  • _reversa_docs/assets/data/features-index.json

Antes de começar

  1. Leia .reversa/state.json para user_name, chat_language.
  2. Leia _reversa_docs/.config.json. Se ausente, conduza entrevista mínima.
  3. Verifique fontes disponíveis: soul.md, _reversa_sdd/*/requirements.md.
  4. Storyteller geralmente não usa libs externas pesadas (glossário é HTML puro + JS inline, deck é navegação por setas), mas se algum recurso premium (capa com canvas, slide com chart) for habilitado, garanta vendor disponível em assets/vendor/ antes (em modo isolado, execute o Passo 0 do Publisher; em modo orquestrado já foi feito na Fase 0).

Entrevista mínima

Pergunta única (estilo visual, mesma do orquestrador). Persiste em .config.json.

Processo

1. Derivar soul.json

Se .reversa/soul.md existe:

python templates/documentation/scripts/convert_soul.py \
    --src .reversa/soul.md \
    --out _reversa_docs/assets/data/soul.json

Se Python indisponível, faça parsing inline: cada seção ## vira chave em sections, e termos em negrito + descrição em sequência viram concepts no formato {term, definition}.

Read the full file on GitHub · 190 lines

Files

What ships with it

1 file 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. 10d ago First seen · 190 lines · 56 tokens per session scan A be657705d5cd

Subscribe to this mod's changes

reversa-docs-storyteller is a skill published in the GitHub repository sandeco/reversa (1,571 stars, last pushed 2d ago), licensed MIT. It adds 56 tokens to every session and 2,272 once invoked, about $0.0003 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-30.

Related

Other skills, from other repositories

hr-onboarding

A new-hire onboarding plan as a single page — first week schedule, buddy + manager intro, learning track, equipment checklist, and "you're set when…" outcomes. Use when the brief mentions "onboarding", "new hire", "first week plan", or "入职".

nexu-io/open-design · 62 tokens

book-mirror

Take any book (EPUB/PDF), produce a personalized chapter-by-chapter analysis. Each chapter is preserved in detail (The Chapter) and mirrored back to the reader's actual life (The Mirror) using brain context. The mirror observes and resonates — a friend pointing out parallels, NOT a consultant rearranging the reader's…

garrytan/gbrain · 138 tokens

miniapp

Build a tiny interactive HTML playground only when someone asks to see, play with, or step through a mechanism.

yc-software/qm · 25 tokens

eli5

Explain research, papers, or technical ideas in plain English with minimal jargon, concrete analogies, and clear takeaways. Use when the user says "ELI5 this", asks for a simple explanation of a paper or research result, wants jargon removed, or asks what something technically dense actually means.

companion-inc/feynman · 63 tokens

deck-course-module

A course or workshop slide template with persistent learning goals, teaching pages, multiple-choice self-tests, and a wrap-up.

nexu-io/html-anything · 25 tokens

master-yinguang

A reference-based assistant for questions about Yinguang and Pure Land Buddhism, a Buddhist tradition focused on faith, ethical living, and practice connected with rebirth in the Pure Land. It can answer in Yinguang’s historical teaching style.

xr843/Master-skill · 274 tokens