# Inspect Repair

> Run a free deterministic quality report on ANY PowerPoint file (yours or generated elsewhere) and optionally auto-repair it. Use when the user asks to check/lint/QA/review a pptx, find broken slides, fix overflowing or hidden text, clean up a deck before sending, or verify a generated deck. Uses the SlideForge REST API (works without the MCP server); repair never alters words.

- **Type:** Skill
- **Install:** `agentstack add skill-smartdatabrokers-slideforge-mcp-inspect-repair`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [smartdatabrokers](https://agentstack.voostack.com/s/smartdatabrokers)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [smartdatabrokers](https://github.com/smartdatabrokers)
- **Source:** https://github.com/smartdatabrokers/slideforge-mcp/tree/main/skills/inspect-repair
- **Website:** https://slideforge.dev

## Install

```sh
agentstack add skill-smartdatabrokers-slideforge-mcp-inspect-repair
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Inspect & repair any deck (Deck Doctor)

`POST /v1/inspect` returns a Deck Quality Report for **any** .pptx — decks SlideForge never
rendered included. Free, deterministic, no LLM: the file is analyzed with real font metrics
and geometry, never sent to a model. Repair is $0.02 per repaired slide, and its `dry_run`
returns the exact fix plan (and therefore the exact price) free.

## Inspect

```bash
curl -X POST https://api.slideforge.dev/v1/inspect \
  -H "Authorization: Bearer sf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pptx_base64": "'"$(base64 -w0 deck.pptx)"'"}'
```

Sources (exactly one): `pptx_base64` (≤25 MB), `pptx_url` (https), or `job_id` (a SlideForge
render). First 50 slides; 30 requests/hour.

**What it finds** — each with a machine `code`, severity, message, remedy, and the offending
`shape_id`: text overflow / clipping (measured with real font metrics, autofit-aware), content
hidden behind opaque shapes (z-order), off-canvas leftovers (parked notes leak content!),
WCAG contrast, sub-9pt fonts, image-only slides, empty slides, hidden slides (marked; they
never fail the deck), density.

**Read it honestly:** `status` is clean | review | failed. `summary.font_size_coverage` /
`contrast_coverage` state how much of the deck the checks could actually resolve — inherited
theme values it can't resolve are skipped, never guessed. Report findings to the user by
slide number with the remedy; don't paraphrase severities up or down.

## Repair (deterministic, never your words)

```bash
# free exact quote first
curl -X POST https://api.slideforge.dev/v1/repair -H "Authorization: Bearer sf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pptx_url": "https://…/deck.pptx", "dry_run": true}'
# then apply
curl -X POST https://api.slideforge.dev/v1/repair -H "Authorization: Bearer sf_live_YOUR_KEY" \
  -H "Content-Type: application/json" -d '{"pptx_url": "https://…/deck.pptx"}'
```

Actions (subset via `actions[]`, default all): `shrink_to_fit` (measured, floor 9pt),
`raise_min_font` (only when it still fits), `remove_off_canvas` (fully-invisible junk only),
`fix_contrast` (WCAG AA, hue-preserving). **No characters are ever altered** — the response
carries a computed `visible_text_untouched` proof, a before/after report diff, and
`flagged_not_fixed[]` for anything ambiguous (with remedies). A run that fixes nothing bills
nothing; the repaired deck persists as a job — download it with your API key via `GET /v1/jobs/{id}/pptx`.

## Workflow patterns

- **Pre-send QA:** inspect → show the user errors/warnings by slide → offer repair dry-run
  quote → apply on confirmation → return the repaired file + the before/after diff.
- **Verify generated decks:** after any tool (SlideForge or otherwise) produces a pptx,
  inspect it before delivering — it's free and takes ~1s per 30 slides.
- **Hygiene sweep:** off-canvas findings often reveal parked working notes (names, comments)
  that ship inside the file — flag these as a content-leak risk, not just a visual issue.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [smartdatabrokers](https://github.com/smartdatabrokers)
- **Source:** [smartdatabrokers/slideforge-mcp](https://github.com/smartdatabrokers/slideforge-mcp)
- **License:** MIT
- **Homepage:** https://slideforge.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-smartdatabrokers-slideforge-mcp-inspect-repair
- Seller: https://agentstack.voostack.com/s/smartdatabrokers
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.