Borrowing it
Nothing to install: this file belongs to liustack/pptwise. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/liustack/pptwise/main/AGENTS.mdgit clone --depth 1 https://github.com/liustack/pptwiseWrote 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.
[](https://agentmods.dev/instructions/liustack/pptwise/agents-md)<a href="https://agentmods.dev/instructions/liustack/pptwise/agents-md"><img src="https://agentmods.dev/badge/instructions/liustack/pptwise/agents-md/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.
<a href="https://agentmods.dev/instructions/liustack/pptwise/agents-md"><img src="https://agentmods.dev/badge/instructions/liustack/pptwise/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.01384 | $0.01384 |
| Opus 5.5 | $0.00554 | $0.00554 |
| Sonnet 5.5 | $0.00277 | $0.00277 |
| Haiku 4.5 | $0.00138 | $0.00138 |
Grade A, and why
pptwise AGENTS.md 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 13d 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.
How it starts
The opening of the file, as written. The whole thing — 61 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Project Overview for AI Agents
Goal
pptwise turns semantic IR into native editable PPTX. It ships as a skill folder under skills/pptwise/ and as a DSH plugin through dsh/index.js plus cordis.patch.yml. The stable public surface is the CLI, IR schema, theme schema, deck project format, skill, and DSH plugin. JavaScript internals carry no semver promise. See docs/internal-api.md.
Authoring model
The causal chain is:
intent -> narrative -> theme -> spec -> fill -> render
The four public nouns are:
- theme: one complete self-contained v2 file with style, optional brand configuration, occasion metadata, identity strength, and a menu. The 24 built-ins are factory presets for copying.
- spec: a version 1 semantic contract that binds one theme and locks narrative, page order, id, type, heading, and content kind.
- component: one of 63 typed units that fill a page.
- kind: one of 11 content-page moves. The vocabulary is
points,list,comparison,process,data,photo,statement,quote,fact,evidence, andhierarchy.
Boundary pages are cover, chapter, and ending. Content pages require kind. The bound theme menu maps each boundary type and each offered content kind to exactly one internal face. A kind the menu lacks lands on its nearest offered stand-in from the one table in src/render/kind-landing.ts, so a theme change is a name change. Authors never write face ids. IR v5 has no seed, layout, beat, or arrangement.
See docs/concepts.md, docs/menu-lookup.md, docs/themes.md, docs/ir.md, and docs/deck-projects.md.
Architecture
IR and project content flow through one shared theme-menu route into the React SVG page system under src/layouts, src/components, src/motifs, and src/render. Checks live under src/audit. Static SVG markup goes through src/pptx, svg2pptx, PptxGenJS, and JSZip patches before producing .pptx.
Validation, capacity, asset briefs, and rendering consume the same resolved menu route. Pacing supplies the editorial budget and body baseline. The chosen face supplies physical capacity. Pacing never chooses a face.
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.
- 13d ago Changed · +35 tokens per session 2ecaeefd44f6
- 16d ago Changed · +134 tokens per session 9c43b2a15344
- 18d ago Changed acf8698ddfad
- 19d ago Changed fc5b2d10cd65
- 28d ago Changed · +2 lines · +96 tokens per session a441b4167950
- 1mo ago Changed ab7c8c8e0fd2
- 1mo ago Changed · +1 lines · +111 tokens per session 7e54c73096bf
- 1mo ago Changed · +1 lines · +111 tokens per session de565ff5fa98
- 1mo ago First seen · 57 lines · 897 tokens per session scan A dfd1994be3e4
pptwise AGENTS.md is an instructions file published in the GitHub repository liustack/pptwise (24 stars, last pushed 2d ago), licensed MIT. It adds 1,384 tokens to every session, about $0.0055 per session on Opus 5.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.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).
deepseek-harness AGENTS.md
AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.