Evals / documents / Read a document

Deck to an outline

Make a Markdown outline of show.pptx called show.md.

normalsingledeft slides to-md

The task

The reference answer shows the job can be done with deft. It is not an agent run.

deft slides to-md show.pptx -o show.md

Input

show.pptx 38.2 KB
Rendered by macOS Quick Look, first page

Rendered by macOS Quick Look, first page

Text inside
[ppt/slides/slide1.xml] Title of the first slide Subtitle of the first slide This bit is in italic green
[ppt/slides/slide2.xml] This is the second slide It has bullet points on it They’re fun, aren’t they? Especially in a different font like Arial Black at 16 point!

Reference output

show.md 266 B
## Title of the first slide

- Subtitle of the first slide
- *This bit is in italic green*

<!-- page break -->

## This is the second slide

- It has bullet points on it
- They’re fun, aren’t they?
- Especially in a different font like Arial Black at 16 point!
How a result is judged (1 check)
  • text: file = "show.md", contains = ["This is the second slide"]

Runs

CodexWithout deftPassed2026-11-07

Time
21s
New tokens
6.1k
Total input
85.4k
Output tokens
0.7k
Commands
4
Failed
0

Trace

  1. I’ll inspect the presentation and create a concise slide-by-slide Markdown outline in `show.md`.

  2. ls -la && rg --files -g 'show.pptx' -g 'AGENTS.md' -g '*.pptx'
    output
    total 80
    drwxr-xr-x@    3 user  staff     96 Nov  6 17:27 .
    drwx------@ 1750 user  staff  56000 Nov  6 17:27 ..
    -rw-r--r--@    1 user  staff  39083 Nov  5 21:11 show.pptx
    show.pptx
  3. python - <<'PY' import importlib.util print('pptx', importlib.util.find_spec('pptx')) PY
    output
    pptx None
  4. unzip -p show.pptx ppt/presentation.xml | sed 's/></>\\n</g' | head -30; unzip -l show.pptx | head -30
    output
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <p:presentation xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" saveSubsetFonts="1">
    <p:sldMasterIdLst>
    <p:sldMasterId id="2147483648" r:id="rId1"/>
    </p:sldMasterIdLst>
    <p:notesMasterIdLst>
    <p:notesMasterId r:id="rId4"/>
    </p:notesMasterIdLst>
    <p:sldIdLst>
    <p:sldId id="256" r:id="rId2"/>
    <p:sldId id="257" r:id="rId3"/>
    </p:sldIdLst>
    <p:sldSz cx="9144000" cy="6858000" type="screen4x3"/>
    <p:notesSz cx="6858000" cy="9144000"/>
    <p:defaultTextStyle>
    <a:defPPr>
    <a:defRPr lang="en-US"/>
    </a:defPPr>
    <a:lvl1pPr marL="0" algn="l" defTabSz="914400" rtl="0" eaLnBrk="1" latinLnBrk="0" hangingPunct="1">
    <a:defRPr sz="1800" kern="1200">
    <a:solidFill>
    <a:schemeClr val="tx1"/>
    </a:solidFill>
    <a:latin typeface="+mn-lt"/>
    <a:ea typeface="+mn-ea"/>
    <a:cs typeface="+mn-cs"/>
    </a:defRPr>
    </a:lvl1pPr>
    <a:lvl2pPr marL="457200" algn="l" defTabSz="914400" rtl="0" eaLnBrk="1" latinLnBrk="0" hangingPunct="1">
    <a:defRPr sz="1800" kern="1200">
    Archive:  show.pptx
      Length      Date    Time    Name
    ---------  ---------- -----   ----
         1355  01-01-1980 00:00   docProps/app.xml
          846  01-01-1980 00:00   docProps/core.xml
         4794  01-01-1980 00:00   docProps/thumbnail.jpeg
         7378  01-01-1980 00:00   ppt/notesMasters/notesMaster1.xml
          292  01-01-1980 00:00   ppt/notesMasters/_re
    … 1476 more characters
  5. python - <<'PY' import zipfile, xml.etree.ElementTree as ET z=zipfile.ZipFile('show.pptx') ns={'a':'http://schemas.openxmlformats.org/drawingml/2006/main','p':'http://schemas.openxmlformats.org/presentationml/2006/main'} for i in range(1,3): root=ET.fromstring(z.read(f'ppt/slides/slide{i}.xml')) print('\\nSLIDE',i) for sp in root.findall('.//p:sp',ns): paras=[] for p in sp.findall('./p:txBody/a:p',ns): t=''.join(x.text or '' for x in p.findall('.//a:t',ns)) if t.strip(): paras.append(t) if paras: print(' | '.join(paras)) PY
    output
    SLIDE 1
    Title of the first slide
    Subtitle of the first slide | This bit is in italic green
    
    SLIDE 2
    This is the second slide
    It has bullet points on it | They’re fun, aren’t they? | Especially in a different font like Arial Black at 16 point!
  6. The deck has two slides. I’m capturing the titles and the visible supporting text, including the second slide’s bullet content.

  7. Edited show.md

  8. Created [show.md](show.md) with a two-slide outline.

Output

show.md 308 B
# Show — outline

1. **Title of the first slide**
   - Subtitle of the first slide
   - Italic green text: “This bit is in italic green”
2. **This is the second slide**
   - It has bullet points on it
   - They’re fun, aren’t they?
   - Especially in a different font like Arial Black at 16 point!

CodexWith deft, skill installedPassedRead the skillUsed deft2026-11-07

Time
14s
New tokens
5.9k
Total input
74.5k
Output tokens
0.4k
Commands
4
Failed
0

Trace

  1. I’ll inspect the presentation and use the available document conversion workflow to create `show.md` in the current directory.

  2. cat .agents/skills/deft/SKILL.md
    output
    ---
    name: deft
    description: "Use deft instead of writing a script for file jobs: PDF merge/split/compress/watermark, image resize/convert/compress, video and audio trim/convert/compress, spreadsheets, Markdown to PDF/HTML, and YouTube downloads and subtitles."
    ---
    
    # deft
    
    One local command for file jobs. Prefer it over writing Python or shell scripts.
    
    Syntax: `deft <group> <command> [inputs] [-o output] [--options]`
    
    Groups:
    - `pdf`: Merge, split, compress, encrypt, forms, OCR, compare, convert
    - `image`: Resize, crop, convert, compress, filters, montage, OCR
    - `video`: Trim, crop, speed, convert, compress, GIF, frames (ffmpeg)
    - `audio`: Convert, trim, merge, fade, speed, tag, normalize (ffmpeg)
    - `doc`: Word/ODT/RTF: to text, Markdown, HTML, PDF; find and replace
    - `slides`: PowerPoint: extract text, Markdown outline, PDF handout
    - `data`: JSON/YAML/TOML/XML: convert, query with jq syntax, merge, diff
    - `sheet`: Excel/CSV/ODS tables: filter, sort, join, pivot, convert
    - `md`: Markdown to PDF, HTML, Word, EPUB; table of contents
    - `html`: HTML to Markdown, text, Word, PDF; screenshots
    - `epub`: E-books: info, to text, Markdown and PDF
    - `email`: EML files: headers, text, attachments
    - `contact`: VCF address books: to and from CSV
    - `calendar`: ICS calendars: to and from CSV
    - `gps`: GPX and KML tracks: convert, distance and time
    - `youtube`: Info, download, audio, subtitles, thumbnail (yt-dlp)
    - `file`: Any file: hash, duplicates, batch rename, base64, encoding
    - `qr`: Cre
    … 728 more characters
  3. rg --files -g 'show.pptx' -g 'AGENTS.md' -g 'show.md'
    output
    show.pptx
  4. I’m using the `deft` slide workflow for the PowerPoint-to-Markdown outline. The file is present in the current directory.

  5. deft slides
    output
    deft slides - commands (input -> output)
      info     pptx -> report  Slide count, titles, images, notes
      from-md  md -> pptx      Make a deck: each heading or --- starts a slide [beta]
      to-md    pptx -> md      Outline in Markdown: a heading per slide, bullets, images
      to-pdf   pptx -> pdf     Handout PDF of slide content [beta]
      to-text  pptx -> txt     Extract the text of every slide, form feed between slides
    More: deft slides <command> --help
  6. deft slides to-md show.pptx -o show.md
    output
    ok slides.to-md show.pptx -> show.md  2 slides  0.00s
  7. Created [show.md](show.md) as a Markdown outline of the 2-slide presentation.

Output

show.md 266 B
## Title of the first slide

- Subtitle of the first slide
- *This bit is in italic green*

<!-- page break -->

## This is the second slide

- It has bullet points on it
- They’re fun, aren’t they?
- Especially in a different font like Arial Black at 16 point!

Claude Opus 5.5Without deftPassed2026-11-07

Time
26s
New tokens
11.2k
Total input
58.6k
Output tokens
1.6k
Commands
0
Failed
0

Trace

    Output

    show.md 426 B
    # Outline: show.pptx
    
    ## Slide 1: Title of the first slide
    
    - Subtitle of the first slide
    - *This bit is in italic green*
    
    > **Speaker notes:** I am the notes of the first slide
    
    ## Slide 2: This is the second slide
    
    - It has bullet points on it
    - They’re fun, aren’t they?
    - Especially in a different font like Arial Black at 16 point!
    
    > **Speaker notes:** These are the notes of the 2nd slide
    >
    > **THIS LINE IS BOLD**
    

    Claude Opus 5.5With deft, skill installedPassedRead the skillUsed deft2026-11-07

    Time
    20s
    New tokens
    10.0k
    Total input
    74.3k
    Output tokens
    0.6k
    Commands
    0
    Failed
    0

    Trace

      Output

      ---
      name: deft
      description: "Use deft first for any simple, direct operation on local files, whatever the type: convert, read, extract, edit, compress, merge, split, compare or inspect. Try it before writing a script or one-liner. If unsure, run deft find; if it says no command does this, use another tool. Not for programming work: to read, write or change source code, skip it."
      ---
      
      # deft
      
      One local command for file jobs. Prefer it over writing Python or shell scripts.
      
      Syntax: `deft <group> <command> [inputs] [-o output] [--options]`
      
      Groups:
      - `pdf`: Merge, split, compress, encrypt, forms, OCR, compare, convert
      - `image`: Resize, crop, convert, compress, adjust, montage, OCR
      - `video`: Trim, merge, convert, compress, subtitles, GIF, frames (ffmpeg)
      - `audio`: Convert, trim, normalize, denoise, cut silence (ffmpeg)
      - `doc`: Word/ODT/RTF: to text, Markdown, HTML, PDF; find and replace
      - `slides`: PowerPoint: extract text, Markdown outline
      - `sheet`: Excel/CSV/ODS tables: SQL query, pivot, merge, split, convert
      - `json`: JSON: convert, format, merge, diff, validate
      - `toml`: TOML: convert, format, merge, diff, validate
      - `xml`: XML: convert, format, merge, diff, validate
      - `yaml`: YAML: convert, format, merge, diff, validate
      - `md`: Markdown to PDF, HTML, Word, EPUB; table of contents
      - `html`: HTML to Markdown, text, Word and PDF
      - `epub`: E-books: info, to text, Markdown and PDF
      - `gps`: GPX and KML tracks: convert, distance and time
      - `qr`: Create QR codes and barcodes; read QR codes
      
      How to use it:
      1. Run `deft <group>` to list commands, or `deft find "<what you want>"` to search. If it says `no command does this`, use another tool.
      2. Run `deft <group> <command> --help` for options and examples.
      3. `deft convert <in> -o <out.ext>` converts between formats by extension.
      4. Results are one line starting with `ok`, `partial` or `error`; add `--json` to parse them. Errors include a `hint:` with the fix.
      
      Inputs are never overwritten; pass `--force` or `--in-place` to allow it. Globs and directories work as inputs; several inputs run in parallel.
      
      If `deft` is not installed, ask the user, then follow https://github.com/firstprayer/deft/blob/main/docs/INSTALL.md
      
      show.md 266 B
      ## Title of the first slide
      
      - Subtitle of the first slide
      - *This bit is in italic green*
      
      <!-- page break -->
      
      ## This is the second slide
      
      - It has bullet points on it
      - They’re fun, aren’t they?
      - Especially in a different font like Arial Black at 16 point!
      

      Claude CodeWithout deftNot run yet

      Claude CodeWith deftNot run yet