# Presentation

Turn a tech-spec directory into an interactive, marketing-grade web presentation, ...

- Repository: https://github.com/iii-hq/iii (18876 stars)
- Category: Design
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add iii-hq/iii --skill presentation -g -a claude-code -y`
Codex: `npx skills add iii-hq/iii --skill presentation -g -a codex -y`
Cursor: `npx skills add iii-hq/iii --skill presentation -g -a cursor -y`
Gemini CLI: `npx skills add iii-hq/iii --skill presentation -g -a gemini-cli -y`

## Description

Turn a tech-spec directory into an interactive, marketing-grade web presentation, built so engineers understand the design, the reader is convinced of the why, and the result is shareable in public. Use when someone wants a spec turned into a deck.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Presentation

Turn a technical specification into an interactive, persuasive web deck, the kind at iii.dev/roadmap/. The output is a **content layer** inside the
repo's roadmap base (the shared component library, gallery, and markdown
spec viewer that build every deck into one static site, Astro routes of the
site package in iii, a standalone Vite project in other repos):

1. helps engineers **understand** the spec, the architecture is a navigable
   map, not prose;
2. is **interactive**, steppable diagrams, a selectable system map, live
   toggles; interactivity is what makes it stick;
3. reads like **marketing**, it argues the *why*. if no one is convinced the
   work should happen, the spec has not done its job;
4. is **build-in-public ready**, each deck ships as a static page at
   `/roadmap/<slug>/`, safe to share.

## Comparable to

A product launch microsite generated from an RFC. Stripe-doc clarity meets a
keynote narrative, in a monospace drafting-sheet style.

## Activation

### Use For

- generating an interactive deck from a tech-spec directory
- refreshing or extending a presentation already generated by this skill

### Do Not Use For

- writing the spec itself, use `/tech-spec`
- static slide exports (pdf / keynote), use a slide tool
- general UI work unrelated to a spec, use `/design`

## Load First

Read these before building (they are the law, do not re-derive them):

The rest: https://github.com/iii-hq/iii/blob/HEAD/skills/presentation/SKILL.md