slides-grab AGENTS.md

slides-grab AGENTS.md is an instructions file for Codex, OpenCode from NomaDamas/slides-grab. It costs 1,543 tokens per session, scanned A, original, MIT.

A set of instructions for contributing to slides-grab, a framework where AI agents create presentation slides as HTML and convert them to other formats. It describes the project structure, workflow, and slide requirements.

In plain words
What is it for?
Creating or modifying HTML-based slides, running the project's validation and conversion steps, and preparing pull requests for the main branch.
Why use it?
It helps contributors work on the correct branch, follow the required review process, and understand how the slide pipeline is organized.

Instructions file for CodexOpenCode

About the project

slides-grab is a tool for creating and editing presentations as HTML and CSS files, with an editor that lets coding agents work on selected parts of a slide and export decks to PDF or experimental PPTX files. It is for people generating presentations with Claude Code, Codex, and related agents. The catalogue entries provide skills, agents, and instructions for its presentation workflow.

NomaDamas/slides-grab · 1,204 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.

agentmods
npx agentmods add instructions/nomadamas/slides-grab/agents-md
Clone the repo
git clone --depth 1 https://github.com/NomaDamas/slides-grab

Made for: Codex, OpenCode.

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 slides-grab AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/nomadamas/slides-grab/agents-md.svg)](https://agentmods.dev/instructions/nomadamas/slides-grab/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/nomadamas/slides-grab/agents-md"><img src="https://agentmods.dev/badge/instructions/nomadamas/slides-grab/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,543 This file is loaded in full into every session.
When invoked 1,543 The same file — it is already loaded in full.
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.01543 $0.01543
Opus 5 $0.00772 $0.00772
Sonnet 5 $0.00309 $0.00309
Haiku 4.5 $0.00154 $0.00154

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

Security

Grade A, and why

slides-grab 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 5d 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.md · 93 lines

How it starts

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

AGENTS.md

Contribution Workflow

  • main is the only integration branch. Do not create, target, or depend on a dev branch.
  • Create feature or fix branches from the latest origin/main.
  • Open pull requests from those branches directly against main.
  • Before opening or updating a pull request, rebase or merge the latest origin/main into the working branch and resolve conflicts locally.
  • Run the relevant tests and report their results before requesting review.
  • Do not merge directly to main unless the repository owner explicitly requests it; use a pull request and its required checks/reviews.

Project Overview

slides-grab is an agent-first PPT framework. AI agents write HTML slides directly, and a 3-stage pipeline (Planning → Design → Conversion) produces high-quality HTML/PDF output plus experimental / unstable PPTX and Figma export.

Core philosophy: HTML is the design language. Agents write HTML/CSS directly. The framework provides templates, validation, and conversion tools — not abstractions over HTML.

Key Paths

Path Purpose
skills/slides-grab/SKILL.md Router skill — picks HTML or image-native pipeline
skills/slides-grab-html/SKILL.md HTML-mode pipeline (semantic slides + bespoke hero imagery)
skills/slides-grab-image/SKILL.md Image-native pipeline (whole-slide rasters via slides-grab image)
skills/slides-grab-plan/SKILL.md Stage 1 plan skill (outline workflow)
skills/slides-grab-design/SKILL.md Codex design skill (HTML slides + viewer loop)
skills/slides-grab-export/SKILL.md Codex conversion skill (PDF + experimental / unstable HTML→PPTX/Figma)
skills/slides-grab-design/references/design-gate.md Design gate spec — severity rubric, seven checks (incl. 6b Korean word-break and Review Litmus), dialectical dual-oracle Visual QA loop (render evidence → Pass A System Contract / Constraint Integrity + Pass B Audience Impact / Expressive Readability → synthesized verdict → fix/re-render/re-review until Proceed or Rethink), rule→side-effect→compensation matrix (12 rows), evidence-before-shipping, design-debt log, gate report/verdict (runs after validate, before export)
runtimes/claude-code/agents/design-critic-agent.md Claude Code adapter that points to the canonical design gate and records slides-grab design-gate evidence
runtimes/codex/agents/slides-grab-design-critic.md Codex adapter that points to the canonical design gate and records slides-grab design-gate evidence
skills/*/references/ Published reference docs bundled with installable skills
scripts/build-viewer.js Builds viewer.html from slide-*.html files in selected --slides-dir
src/html2pptx.cjs Packaged HTML→PPTX conversion runtime
src/pptx-raster-export.cjs Packaged raster PPTX export runtime behind convert.cjs
slides/ (default) or custom --slides-dir path Generated HTML slide workspace
slide-outline.md Presentation outline generated during Stage 1
package.json Node.js dependencies (playwright, sharp, pptxgenjs)
convert.cjs Legacy experimental / unstable HTML→PPTX converter

Read the full file on GitHub · 93 lines

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. 5d ago First seen · 93 lines · 1,543 tokens per session scan A 8a8e508cedb9

Subscribe to this mod's changes

slides-grab AGENTS.md is an instructions file published in the GitHub repository NomaDamas/slides-grab (1,204 stars, last pushed 10d ago), licensed MIT. It adds 1,543 tokens to every session, about $0.0077 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 instructions, from other repositories

ppt-master AGENTS.md

AGENTS.md instructions for hugohe3/ppt-master, covering agents.md, project overview, execution requirements, required conventions and compatibility boundary.

hugohe3/ppt-master · 2,560 tokens

ppt-master CLAUDE.md

Claude Code instructions for hugohe3/ppt-master: Claude Code entry point. To avoid maintaining two copies, all project instructions live in a single source of truth — AGENTS.md — imported below (Claude Code inlines @-referenced files into context). Always edit AGENTS.md; never duplicate its content here.

hugohe3/ppt-master · 74 tokens

open-slide AGENTS.md

AGENTS.md instructions for 1weiho/open-slide, covering open-slide — framework repo guide, layout, workflow, hard rules and releasing (reference).

1weiho/open-slide · 789 tokens

colloquium CLAUDE.md

Claude Code instructions for natolambert/colloquium, covering colloquium — agent instructions, what this is, commands, changelog and architecture patterns.

natolambert/colloquium · 953 tokens

document CLAUDE.md

Claude Code instructions for ranuts/document, covering claude.md — document 项目指南, 项目概述, 提交流程(2026-08-16 起:pr 制,main 受保护), 开发命令 and 目录结构.

ranuts/document · 23,895 tokens

xiaobei-skill AGENTS.md

Instructions for xiao24bei/xiaobei-skill: This repository is a collection of independently installable Codex skills. The repository root is intentionally not an installable skill and must not contain SKILL.md.

xiao24bei/xiaobei-skill · 190 tokens