slideops

Featured

Use when the user asks for slides, a slide deck, or a presentation about a code repository, one of its subsystems, a feature, an architecture area, or its recent changes. Triggers include "make slides", "build a slide deck", "create a presentation", "HTML slides for this repo", "overview deck", "team update slides", "slides for our latest changes", or naming a topic and asking for a deck about it. Also use when the user asks whether an existing deck still matches the code, or wants one rechecked, refreshed, or kept in sync automatically: "is this deck still accurate", "check the slides against the code", "did anything we documented change", "refresh the architecture deck", "these docs are stale", "fail the build when the deck stops matching the code", or asks to wire that check into CI, a pull request, or an agent hook. Also use for Markdown documentation instead of slides ("write markdown docs", "a design doc with citations", "docs that know when they go stale"), including PDF export of a doc.

Code & Development 53 stars 3 forks Updated 3 weeks ago MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
58
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# SlideOps: generate a deck from a repository, and keep it true This skill has two jobs, and the second one is the point. **Build**: turn a repository into a deck whose every claim came from the code, not from a model's impression of the code. **Keep in sync**: make that deck able to prove, months later, whether it still matches the repository, cheaply enough that nobody has to remember to care. The mechanism joining them is a citation. Every quoted snippet records the file, the line range, and a hash of those source lines at build time, and the deck records the commit it was built from. That turns "is this deck still accurate?" from a question somebody has to answer by reading into a command that answers itself: ```bash python3 scripts/check.py docs/slides/ --repo . ``` Standard library only. No model, no network, no tokens, milliseconds to run. Two scripts ship with this skill and do all of it: [`scripts/cite.py`](scripts/cite.py) writes the citations while you build, and [`scripts/check.py`](scripts/check.py) reads them back afterwards. Writing the citations as you go (Step 3) is therefore not optional decoration: it is the entire reason the deck can be maintained instead of rewritten. See [`references/freshness.md`](references/freshness.md) for the mechanism and [`references/automation.md`](references/automation.md) for wiring it into pull requests, scheduled refreshes, and agent hooks. ## Which job is this? - The user wants a **new deck**: start at Step 0 below. -...

Details

Author
glukicov
Repository
glukicov/slideops
Created
4 weeks ago
Last Updated
3 weeks ago
Language
HTML
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category