skilldrop-cli 1.1.3 → 1.2.0

package/packs/converters/skills/file-to-markdown/scripts/to_markdown.py

@@ -4,9 +4,10 @@
 Stdlib only, Python 3.9+. Handles .docx, .pptx, .xlsx, .html/.htm, .csv/.tsv,
 .json, .txt/.md, .eml and Outlook .msg email, and .pdf (through `pdftotext` when it is installed). A PDF page with no
 text layer (a scan) is read by OCR when `tesseract` and `pdftoppm` are installed.
-Everything the conversion could not carry (images, charts, comments, formulas,
-tracked changes) is counted and reported on stderr, so nobody mistakes the
-Markdown for the whole document.
+Embedded .docx and .pptx images are saved beside the output and linked, and tracked
+changes come through as pending ({++added++}, {--removed--}). Everything else the
+conversion could not carry (charts, comments, formulas) is counted and reported on
+stderr, so nobody mistakes the Markdown for the whole document.
 
 Usage:
     python3 to_markdown.py report.docx -o report.md
@@ -20,6 +21,7 @@ import argparse
 import csv
 import io
 import json
+import os
 import re
 import shutil
 import subprocess
@@ -31,6 +33,7 @@ from collections import OrderedDict
 from datetime import datetime, timedelta
 from html.parser import HTMLParser
 from pathlib import Path
+from urllib.parse import quote
 from xml.etree import ElementTree as ET
 
 W = "{http://schemas.openxmlformats.org/wordprocessingml/2006/main}"
@@ -103,16 +106,52 @@ def wrap(text, bold, italic):
     return lead + core + trail
 
 
+class Raw(str):
+    """Markdown written as is: an image link, or a tracked-change marker. Never escaped, never
+    merged with the text around it."""
+
+
+# Where embedded images are saved: a folder beside the output file, set by main(). None when
+# the Markdown goes to stdout, and then images are counted as dropped, as before.
+MEDIA = {"dir": None, "link": None, "names": {}}
+
+
+def save_media(z, member, alt, rep):
+    """Copy one image out of an Office package beside the Markdown, and return the Markdown that
+    links it, or None when there is nowhere to save it or the part is missing."""
+    if not MEDIA["dir"] or member not in z.namelist():
+        rep.drop("images")
+        return None
+    name = MEDIA["names"].get(member)
+    if name is None:
+        base = re.sub(r"[^A-Za-z0-9._-]+", "-", member.rsplit("/", 1)[-1]) or "image"
+        name, k = base, 1
+        while name in MEDIA["names"].values():
+            stem, dot, ext = base.rpartition(".")
+            name = "%s-%d.%s" % (stem, k, ext) if dot else "%s-%d" % (base, k)
+            k += 1
+        os.makedirs(MEDIA["dir"], exist_ok=True)
+        with open(os.path.join(MEDIA["dir"], name), "wb") as fh:
+            fh.write(z.read(member))
+        MEDIA["names"][member] = name
+    rep.keep("images saved")
+    alt = re.sub(r"[\[\]\n]+", " ", alt or "").strip() or "image"
+    return Raw("![%s](%s/%s)" % (alt, MEDIA["link"], name))
+
+
 def render_segments(segs):
     """segs: list of (text, bold, italic, href). Merge neighbours with equal formatting."""
     merged = []
     for t, b, i, h in segs:
-        if merged and merged[-1][1:] == (b, i, h):
+        if merged and merged[-1][1:] == (b, i, h) and not isinstance(t, Raw) and not isinstance(merged[-1][0], Raw):
             merged[-1] = (merged[-1][0] + t, b, i, h)
         else:
             merged.append((t, b, i, h))
     out = []
     for t, b, i, h in merged:
+        if isinstance(t, Raw):
+            out.append(str(t))
+            continue
         piece = wrap(md_escape(t), b, i)
         if h:
             piece = "[%s](%s)" % (piece.strip(), h.replace(" ", "%20").replace(")", "%29"))
@@ -156,9 +195,21 @@ def span_of(value, cap):
     return min(int(v), cap) if v.isascii() and v.isdigit() and int(v) > 0 else 1
 
 
+# Every package opened during a conversion, closed by main() when it ends: a nested function
+# that keeps the ZipFile alive would otherwise hold the file open on Windows until garbage
+# collection, so it couldn't be deleted or overwritten.
+OPEN_ZIPS = []
+
+
+def close_zips():
+    while OPEN_ZIPS:
+        OPEN_ZIPS.pop().close()
+
+
 def open_zip(path, kind):
     try:
         z = zipfile.ZipFile(str(path))
+        OPEN_ZIPS.append(z)
     except zipfile.BadZipFile:
         with open(str(path), "rb") as fh:
             if fh.read(8) == b"\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1":
@@ -256,7 +307,7 @@ def docx_to_md(path, rep):
                     field["instr"] += ch.text or ""
                 elif field["state"] == "instr":
                     continue
-                elif tag == W + "t":
+                elif tag in (W + "t", W + "delText"):
                     segs.append((ch.text or "", b, i, href or field["href"]))
                 elif tag == W + "tab":
                     segs.append((" ", False, False, None))
@@ -266,8 +317,16 @@ def docx_to_md(path, rep):
                     rep.drop("images")
                 elif tag == W + "drawing":
                     uris = [g.get("uri") or "" for g in ch.iter(A + "graphicData")]
-                    if any(True for _ in ch.iter(A + "blip")):
-                        rep.drop("images")
+                    blips = list(ch.iter(A + "blip"))
+                    if blips:
+                        rid = blips[0].get(R + "embed")
+                        target = rels.get(rid, (None, "", ""))
+                        alt = next((d.get("descr") or d.get("name") for d in ch.iter() if d.tag.endswith("}docPr")), "")
+                        link = save_media(z, resolve("word", target[0]), alt, rep) if target[0] and target[2] != "External" else None
+                        if link is None and not target[0]:
+                            rep.drop("images")
+                        elif link:
+                            segs.append((link, False, False, None))
                     elif not any("chart" in u for u in uris):  # charts are counted from word/charts
                         rep.drop("shapes/text boxes")
 
@@ -280,10 +339,17 @@ def docx_to_md(path, rep):
                     target = rels.get(rid, (None,))[0] if rid else None
                     walk(ch, target)
                 elif ch.tag == W + "ins":
-                    rep.drop("tracked insertions (kept as text)")
+                    # Pending, not accepted: shown in CriticMarkup so a reader sees it is a
+                    # proposal, and nothing is silently settled.
+                    rep.keep("tracked insertions shown as {++ ++}")
+                    segs.append((Raw("{++"), False, False, None))
                     walk(ch, href)
+                    segs.append((Raw("++}"), False, False, None))
                 elif ch.tag == W + "del":
-                    rep.drop("tracked deletions (left out)")
+                    rep.keep("tracked deletions shown as {-- --}")
+                    segs.append((Raw("{--"), False, False, None))
+                    walk(ch, href)
+                    segs.append((Raw("--}"), False, False, None))
                 elif ch.tag in (W + "smartTag", W + "sdt", W + "sdtContent", W + "fldSimple"):
                     walk(ch, href)
         walk(p, None)
@@ -571,7 +637,17 @@ def pptx_to_md(path, rep):
                         lines.append("")
                     lines.extend(got)
             elif tag == P + "pic":
-                rep.drop("images")
+                blip = next(iter(sp.iter(A + "blip")), None)
+                target = rels.get(blip.get(R + "embed"), (None, "", "")) if blip is not None else (None, "", "")
+                cnv = next((d for d in sp.iter() if d.tag.endswith("}cNvPr")), None)
+                alt = (cnv.get("descr") or cnv.get("name")) if cnv is not None else ""
+                link = save_media(z, resolve(base, target[0]), alt, rep) if target[0] and target[2] != "External" else None
+                if link:
+                    if lines:
+                        lines.append("")
+                    lines.append(str(link))
+                elif not target[0]:
+                    rep.drop("images")
             elif tag == P + "graphicFrame":
                 tbl = sp.find(".//" + A + "tbl")
                 if tbl is not None:
@@ -1755,6 +1831,13 @@ LEGACY = {".doc": ".docx", ".ppt": ".pptx", ".xls": ".xlsx", ".rtf": ".docx", ".
 
 
 def main(argv=None):
+    try:
+        return _main(argv)
+    finally:
+        close_zips()  # on success, on an error exit, and on a damaged file alike
+
+
+def _main(argv=None):
     ap = argparse.ArgumentParser(description="Convert a document to Markdown for another skill to read.")
     ap.add_argument("input", help=".docx .pptx .xlsx .html .csv .tsv .json .txt .md .eml .msg .pdf")
     ap.add_argument("-o", "--output", required=True, help="Markdown file to write, or - for stdout")
@@ -1772,6 +1855,13 @@ def main(argv=None):
         sys.exit("error: input not found: %s" % a.input)
     ext = path.suffix.lower()
     rep = Report()
+    # Embedded images go beside the Markdown, in <name>-images/; to stdout there is nowhere to
+    # put them, so they are counted as dropped.
+    if a.output != "-":
+        stem = Path(a.output).stem
+        MEDIA.update(dir=str(Path(a.output).parent / (stem + "-images")), link=quote(stem + "-images"), names={})
+    else:
+        MEDIA.update(dir=None, link=None, names={})
     if ext in LEGACY:
         sys.exit("error: %s files are not supported. Save or export it as %s and rerun%s."
                  % (ext, LEGACY[ext], " (on macOS: textutil -convert docx <file>)"
@@ -1797,6 +1887,9 @@ def main(argv=None):
 
     if not md.strip():
         rep.notes.append("the conversion produced no text")
+    if any(k.startswith("tracked") for k in rep.kept):
+        rep.notes.append("tracked changes are pending, not accepted: {++added++} and {--removed--} mark them. "
+                         "Accept or reject them in Word to settle the text")
     if a.output == "-":
         sys.stdout.write(md)
     else:

package/packs/converters/skills/md-to-confluence/SKILL.md

@@ -37,7 +37,8 @@ sure nobody overwrites the wrong page. Runbooks often come from `runbook-generat
    - **Two images with the same file name** (`before/screen.png`, `after/screen.png`) become one
      attachment, so both show the same picture. Rename one (`screen-before.png`).
    - **Footnotes are dropped.** Move the text into the sentence or a "Notes" section.
-   - **Mermaid shows as source.** Render it to PNG with `mermaid-render` and embed the PNG.
+   - **Mermaid shows as source.** Render it to PNG with the Mermaid CLI
+     (`npx -y @mermaid-js/mermaid-cli`) and embed the PNG.
    - **A front-matter `title:` wins over the `#` heading** for a new page. An update keeps the
      page's current title, so when the Markdown's title differs (`Deploy checklist v2 (draft)`),
      say so and rename only if asked.
@@ -124,7 +125,6 @@ Markdown file to convert` and write nothing.
 ## When NOT to use this skill
 
 - ❌ A Word file to edit with tracked changes; use `md-to-docx`
-- ❌ A standalone web page or an HTML attachment for email; use `md-to-html`
 - ❌ Jira epics and issues from a PRD; use `tracker-brief-sync`
 - ❌ Writing the runbook itself; use `runbook-generator`, then convert
 

package/packs/converters/skills/md-to-confluence/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "md-to-confluence",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Turn a Markdown runbook, design note or guide into a Confluence page: storage-format XHTML with real code blocks, tables, tasks, info and warning panels, images as attachments and an optional contents macro, a warning for everything dropped, and an optional publish that first shows which page it will create or overwrite and at what version, refuses stale or wrong-space overwrites, and takes credentials only from the environment. Use when the user says \"put this in Confluence\", \"publish this markdown to the wiki\", \"update the Confluence page with this\", \"convert to Confluence storage format\", or names a Confluence space for a Markdown file.",
   "entrypoint": "SKILL.md",
   "deps": {
@@ -17,18 +17,11 @@
   },
   "related": [
     "md-to-docx",
-    "md-to-html",
-    "mermaid-render",
     "runbook-generator",
     "tracker-brief-sync"
   ],
   "handoff": [
-    {
-      "to": "mermaid-render",
-      "when": "the Markdown has Mermaid diagrams",
-      "purpose": "Render each diagram to PNG so it can go on the page as an attachment instead of showing as source code.",
-      "fallback": "If mermaid-render is absent, leave the diagram as a code block and tell the user it shows as text until someone adds an image or a diagram app."
-    }
+    
   ],
   "tags": [
     "confluence",

package/packs/converters/skills/md-to-docx/SKILL.md

@@ -31,8 +31,8 @@ from `guide-builder` or
      Word's navigation pane.
    - Raw HTML, footnotes and Mermaid blocks don't convert. Rewrite an HTML table as a pipe table,
      move a footnote's text into the sentence or a "Notes" section, and render each diagram to PNG
-     with `mermaid-render` (PNG output needs mermaid-cli installed), then embed the PNG as a
-     Markdown image with alt text.
+     with the Mermaid CLI (`npx -y @mermaid-js/mermaid-cli -i diagram.mmd -o diagram.png`; it needs Node.js), then embed the PNG as a Markdown image with
+     alt text.
    - Lists nested deeper than two levels are flattened. Restructure them into a sub-heading
      and a list.
    - Image paths must be relative to the Markdown file and point at PNG or JPEG files.
@@ -106,8 +106,7 @@ or page size uses the defaults, with an `[assumption]` line at the top of your r
 
 ## When NOT to use this skill
 
-- ❌ Slides; use `deck-builder`
-- ❌ A web page or a file to open in a browser; use `md-to-html`
+- ❌ Slides; use `md-to-pptx`
 - ❌ The other direction, a Word file or PDF back to Markdown; use `file-to-markdown`
 - ❌ Tables that need to be sorted, filtered or summed; use `md-to-xlsx`
 - ❌ Writing the document itself; draft it first with `guide-builder` or the skill for that document, then convert

package/packs/converters/skills/md-to-docx/evals/evals.json

@@ -6,7 +6,7 @@
       "prompt": "Northwind Legal wants our vendor onboarding policy as a Word doc so they can track changes. It's in docs/vendor-onboarding.md: a # title, ## sections, a numbered approval process with sub-steps, a pipe table of approval limits ($5,000 / $50,000 / unlimited), a footnote citing the finance policy, and a Mermaid flowchart of the approval path. Use ./brand/brand.json and A4 paper.",
       "assertions": [
         "Runs md_to_docx.py with --brand ./brand/brand.json and --page a4, writing a .docx",
-        "Deals with the Mermaid flowchart before converting: renders it to PNG with mermaid-render and embeds it, or says plainly that it stays as code",
+        "Deals with the Mermaid flowchart before converting: renders it to PNG with the Mermaid CLI and embeds it, or says plainly that it stays as code",
         "Moves the footnote's text into the body or a Notes section instead of letting it drop silently",
         "Reports every WARN line the script printed, each with what was done about it",
         "Keeps the approval limits ($5,000 / $50,000 / unlimited) and every other fact exactly as in the source",

package/packs/converters/skills/md-to-docx/evals/files/1/brand/brand.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "brand-kit output. deck-builder and marketing-flyer read this file; any field left out is asked for or defaulted by them. Paths are relative to this file. Every value carries where it came from in `sources`.",
+  "$comment": "brand-kit output. md-to-docx and md-to-pptx read this file; any field left out is asked for or defaulted by them. Paths are relative to this file. Every value carries where it came from in `sources`.",
   "name": "Northwind Health",
   "tagline": "Care that comes to you",
   "logo": {

package/packs/converters/skills/md-to-docx/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "md-to-docx",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Turn a Markdown draft into a Word document (.docx) that someone outside engineering can open, edit and track changes in, with real Heading styles so the navigation pane and table of contents work, live hyperlinks, numbered and bulleted lists, tables, code blocks, embedded images and optional brand fonts and colours, and a warning for everything that could not be carried over. Use when the user wants a Markdown file as a Word doc, says \"send this as a .docx\", \"convert to Word\", \"legal needs it in Word\", or \"make this editable for the client\".",
   "entrypoint": "SKILL.md",
   "deps": {
@@ -13,22 +13,15 @@
   },
   "related": [
     "brand-kit",
-    "deck-builder",
     "file-to-markdown",
     "guide-builder",
-    "md-to-html",
     "md-to-xlsx",
-    "mermaid-render",
     "output-hygiene",
-    "release-notes"
+    "release-notes",
+    "md-to-pptx"
   ],
   "handoff": [
-    {
-      "to": "mermaid-render",
-      "when": "the Markdown contains Mermaid diagram blocks",
-      "purpose": "Render each diagram to PNG so it can be embedded in the Word file instead of appearing as code.",
-      "fallback": "If mermaid-render is absent, leave the block as code, tell the user the diagram did not convert, and suggest exporting it to PNG from mermaid.live."
-    },
+    
     {
       "to": "output-hygiene",
       "when": "the Markdown was written by an agent and is going to someone outside the team",

package/packs/converters/skills/md-to-docx/reference.md

@@ -79,7 +79,7 @@ embedded: a reader without the font sees Word's substitute. Brand fonts that are
 | Raw HTML blocks | No dependable mapping from arbitrary HTML to Word | Rewrite as Markdown; HTML tables as pipe tables |
 | Inline HTML tags | Same | The text is kept; `<br>` becomes a line break |
 | Footnotes `[^1]` | Word footnotes need a separate part and are rarely worth it in a converted draft | Fold the note into the sentence, or a "Notes" section |
-| Mermaid blocks | Rendering needs a browser engine | Render to PNG with mermaid-render, then embed the image |
+| Mermaid blocks | Rendering needs a browser engine | Render to PNG with the Mermaid CLI (`npx -y @mermaid-js/mermaid-cli`), then embed the image |
 | Nesting past 2 levels | Flattened to keep the document readable | Split with a sub-heading |
 | YAML front matter | Not content | Its `title:` is used as the document title |
 

package/packs/converters/skills/md-to-docx/scripts/md_to_docx.py

@@ -210,7 +210,7 @@ def parse_blocks(lines, base_line, refs):
             start = ln
             while i < n:
                 l2 = expand_tabs(lines[i])
-                s2 = l2.lstrip(" ")
+                s2 = l2.lstrip()  # the same whitespace the test above strips, or a line led by \v never advances
                 if s2.startswith(">"):
                     s2 = s2[1:]
                     if s2.startswith(" "):

package/packs/converters/skills/md-to-pptx/SKILL.md

@@ -9,7 +9,7 @@ This skill turns a Markdown document into a `.pptx` mechanically: the headings d
 slides and the words stay the user's own. A stdlib Python script writes the PowerPoint file,
 checks it, and prints an outline of the slides. The agent's job is the part around it: get the
 Markdown into a shape that converts well, run the script, read what it reports, and tell the
-user what changed. Designing a persuasive deck is `deck-builder`; planning what slides should
+user what changed. Planning what slides should
 say is `slide-outliner`.
 
 ## How to respond
@@ -35,8 +35,8 @@ say is `slide-outliner`.
      `Notes:` paragraph stays on the slide as text. Convert those paragraphs into comments only
      when the user said they are speaker notes ("the Notes: bits are what I'll say").
    - **What doesn't convert:** rewrite an HTML table as a pipe table, fold a footnote's text into
-     its sentence, and render a Mermaid block to PNG with `mermaid-render` (PNG output needs
-     mermaid-cli), then embed it as an image. Remote images are not fetched. Ask for a local copy,
+     its sentence, and render a Mermaid block to PNG with the Mermaid CLI
+     (`npx -y @mermaid-js/mermaid-cli`; it needs Node.js), then embed it as an image. Remote images are not fetched. Ask for a local copy,
      or leave the alt text and say so.
    - **Facts are untouched.** Same numbers, names, dates and order. Don't renumber a list that
      skips a number. Report it (step 4).
@@ -127,10 +127,8 @@ treating `Notes:` paragraphs as slide text is an `[assumption]` stated at the to
 
 ## When NOT to use this skill
 
-- ❌ Designing a persuasive deck for an audience, with charts, layouts and a narrative; use `deck-builder`
 - ❌ Planning what each slide should say before any document exists; use `slide-outliner`
 - ❌ A Word document to edit and track changes in; use `md-to-docx`
-- ❌ A web page or a file to open in a browser; use `md-to-html`
 - ❌ A `.pptx` back to Markdown; use `file-to-markdown`
 
 ## Anti-patterns to avoid

package/packs/converters/skills/md-to-pptx/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "md-to-pptx",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Turn an existing Markdown document (a status report, runbook, review or notes) into a PowerPoint deck (.pptx) that opens without a repair prompt, with nothing to install. Each heading becomes a slide, lists keep their nesting, tables become real PowerPoint tables, images are embedded, and comments become speaker notes. A section too long for one slide is split onto \"continued\" slides instead of shrinking the text, and the reply names every split, everything dropped, and any speaker note that would go out with the file. Use when the user says \"turn this markdown into slides\", \"make this report a PowerPoint\", \"convert the .md to pptx\", \"I need this as a deck for Thursday\", or \"export these notes to PowerPoint\".",
   "entrypoint": "SKILL.md",
   "deps": {
@@ -13,26 +13,13 @@
   },
   "related": [
     "brand-kit",
-    "deck-builder",
     "file-to-markdown",
     "md-to-docx",
-    "md-to-html",
-    "mermaid-render",
     "slide-outliner"
   ],
   "handoff": [
-    {
-      "to": "mermaid-render",
-      "when": "the Markdown contains Mermaid diagram blocks",
-      "purpose": "Render each diagram to PNG so it is embedded on its slide instead of appearing as code.",
-      "fallback": "If mermaid-render is absent, leave the block as code, tell the user the diagram did not convert, and suggest exporting it to PNG from mermaid.live."
-    },
-    {
-      "to": "deck-builder",
-      "when": "the user wants the deck redesigned for an audience (charts, layouts, a narrative) rather than converted as written",
-      "purpose": "Design a persuasive deck from the content instead of mapping headings to slides.",
-      "fallback": "If deck-builder is absent, deliver the converted deck and say in one line that it follows the document's structure and has not been redesigned."
-    }
+    
+    
   ],
   "tags": [
     "powerpoint",

package/packs/converters/skills/md-to-pptx/scripts/md_to_pptx.py

@@ -249,7 +249,7 @@ def parse_blocks(lines, base_line, refs):
             start = ln
             while i < n:
                 l2 = expand_tabs(lines[i])
-                s2 = l2.lstrip(" ")
+                s2 = l2.lstrip()  # the same whitespace the test above strips, or a line led by \v never advances
                 if s2.startswith(">"):
                     s2 = s2[1:]
                     if s2.startswith(" "):

package/packs/converters/skills/md-to-xlsx/SKILL.md

@@ -107,7 +107,7 @@ JSON strings stay text except ISO dates, because whoever produced the JSON chose
 
 - ❌ A document with a few tables in it, to be read rather than calculated; use `md-to-docx`
 - ❌ An Excel file back to Markdown or CSV; use `file-to-markdown`
-- ❌ Charts or a slide of numbers for a meeting; use `deck-builder`
+- ❌ A slide of numbers for a meeting; put the table in the Markdown and use `md-to-pptx`
 - ❌ Building a financial model with formulas, scenarios and linked sheets. This converts data; it doesn't design models.
 
 ## Anti-patterns to avoid

package/packs/converters/skills/md-to-xlsx/manifest.json

@@ -12,9 +12,9 @@
     "optional": []
   },
   "related": [
-    "deck-builder",
     "file-to-markdown",
-    "md-to-docx"
+    "md-to-docx",
+    "md-to-pptx"
   ],
   "tags": [
     "excel",

package/packs/core/skills/brief-intake/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: brief-intake
-description: Turn raw mess — a Slack thread, meeting transcript, Jira ticket, half-written Notion page, email chain, or paragraph of free-form context — into a structured brief that the downstream skill (adr-generator, design-doc, runbook-generator, exec-summary, deck-builder) can consume without further intake. Use whenever the user has unstructured source material and is about to invoke another skilldrop skill, or when a draft is missing the load-bearing context the next step will need.
+description: Turn raw mess — a Slack thread, meeting transcript, Jira ticket, half-written Notion page, email chain, or paragraph of free-form context — into a structured brief that the downstream skill (adr-generator, design-doc, runbook-generator, exec-summary, slide-outliner) can consume without further intake. Use whenever the user has unstructured source material and is about to invoke another skilldrop skill, or when a draft is missing the load-bearing context the next step will need.
 ---
 
 # brief-intake
@@ -18,7 +18,7 @@ You help the user (or the next skill in the chain) absorb raw unstructured input
    | `runbook-generator` | "runbook", "on-call doc", "operational doc", "prod-readiness" |
    | _(tech comparison)_ | "compare X vs Y", "vendor selection", "tech selection" |
    | `exec-summary` | "exec summary", "1-pager for the VP", "board update" |
-   | `deck-builder` / `slide-outliner` | "deck", "slides", "presentation", "pitch", "review meeting" |
+   | `slide-outliner` | "deck", "slides", "presentation", "pitch", "review meeting" |
    | `decision-log` | "decisions and action items", "follow-ups from the meeting" |
    | _(generic)_ | None of the above — emit the generic brief and let the user pick later |
 

package/packs/core/skills/brief-intake/manifest.json

@@ -1,11 +1,11 @@
 {
   "name": "brief-intake",
   "version": "0.1.2",
-  "description": "Turn raw mess — a Slack thread, meeting transcript, Jira ticket, half-written Notion page, email chain, or paragraph of free-form context — into a structured brief that the downstream skill (adr-generator, design-doc, runbook-generator, exec-summary, deck-builder) can consume without further intake. Use whenever the user has unstructured source material and is about to invoke another skilldrop skill, or when a draft is missing the load-bearing context the next step will need.",
+  "description": "Turn raw mess — a Slack thread, meeting transcript, Jira ticket, half-written Notion page, email chain, or paragraph of free-form context — into a structured brief that the downstream skill (adr-generator, design-doc, runbook-generator, exec-summary, slide-outliner) can consume without further intake. Use whenever the user has unstructured source material and is about to invoke another skilldrop skill, or when a draft is missing the load-bearing context the next step will need.",
   "entrypoint": "SKILL.md",
   "deps": { "npm": [], "pip": [] },
   "env": { "required": [], "optional": [] },
-  "related": ["adr-generator", "decision-log", "deck-builder", "design-doc", "exec-summary", "runbook-generator", "slide-outliner"],
+  "related": ["adr-generator", "decision-log", "design-doc", "exec-summary", "runbook-generator", "slide-outliner"],
   "tags": ["intake", "brief", "extraction", "preprocessing", "pipeline"],
   "model": { "tier": "standard", "rationale": "Extraction + [explicit]/[implied]/[inferred] tagging. The tagging needs care — above haiku, below opus." }
 }

package/packs/core/skills/brief-intake/templates/brief-deck.md

@@ -1,6 +1,6 @@
 # Brief: Deck
 
-> Target downstream skills: `slide-outliner` → `deck-builder` (and `audience-profile` for the structural rules)
+> Target downstream skills: `slide-outliner` (and `audience-profile` for the structural rules)
 
 ## Topic / working title
 {One line} [explicit|implied|inferred|missing]
@@ -39,5 +39,5 @@
 ---
 
 ## 🚩 Missing for downstream
-- {e.g. "Audience not specified — deck-builder will refuse to start"}
-- {e.g. "No palette — deck-builder will ask before building"}
+- {e.g. "Audience not specified — the outline can't be sized"}
+- {e.g. "No brand or palette — the deck will use the default look"}

package/packs/core/skills/doc-critique/rubrics/deck.md

@@ -1,6 +1,6 @@
 # Rubric: Slide Deck / Outline
 
-Mirrors `slide-outliner` + `deck-builder` quality bars. Apply to either a finished deck (read titles + speaker notes) or an outline.
+Mirrors the `slide-outliner` quality bar. Apply to either a finished deck (read titles + speaker notes) or an outline.
 
 ## Blockers
 - **Audience is explicit or obvious from the deck.** Same content for execs vs engineers is a different deck — if you can't tell which one this is, that's the blocker.

package/packs/design/pack.json

@@ -1,7 +1,7 @@
 {
-  "description": "On-brand visual work: capture a brand once, then build real PowerPoint decks and print-ready marketing flyers in that brand, with logo, colours and fonts applied.",
+  "description": "On-brand visual work: capture a brand once as a brand.json the Word and PowerPoint converters apply, and plan a deck slide by slide for its audience.",
   "display_name": "Design",
-  "keywords": ["brand", "deck", "pptx", "flyer", "marketing", "logo"],
+  "keywords": ["brand", "deck", "outline", "presentation", "logo"],
   "links": {
     "documentation": "https://sananthanarayan.github.io/skilldrop/packs/design/"
   },
@@ -13,18 +13,18 @@
   "first-value": {
     "audience-posture": "non-technical",
     "prerequisites": ["Your logo as a PNG file, and your brand colours if you know them"],
-    "starter-task": "Capture your brand once, then make a flyer in it",
-    "starter-prompt": "Set up our brand kit from this logo (./brand/logo.png) and these colours: #0E5A46, #F2A541. Then make a Letter-size flyer for our community health fair on Saturday 14 November, 10am–2pm, at Riverside Park.",
-    "verification": "brand-kit writes brand.json and a one-page BRAND.md with contrast checked, and marketing-flyer writes flyer.html in your colours with your logo, one call to action, and only the facts you gave it.",
-    "recovery": "If the flyer comes out in default colours, check that marketing-flyer was given the brand.json path. If brand-kit does not activate, ask for it by name (\"use brand-kit\")."
+    "starter-task": "Capture your brand once, then outline a deck for it",
+    "starter-prompt": "Set up our brand kit from this logo (./brand/logo.png) and these colours: #0E5A46, #F2A541. Then outline a five-slide deck from ./notes/q3-update.md for Thursday's team meeting.",
+    "verification": "brand-kit writes brand.json and a one-page BRAND.md with contrast checked, and slide-outliner returns a slide-by-slide outline with takeaway titles and speaker notes, sized to the time.",
+    "recovery": "If brand-kit does not activate, ask for it by name (\"use brand-kit\"). To turn the outline into a .pptx in your brand, the converters pack's md-to-pptx takes the same brand.json with --brand."
   },
   "requires": ["core"],
   "journey": {
-    "when": "You need a deck or a flyer in your own branding and do not want to answer the brand questions every time.",
+    "when": "You need a deck or document in your own branding and do not want to answer the brand questions every time.",
     "you_bring": [
       "your logo as a PNG, and a white version if you have one",
       "brand colours, fonts or a PowerPoint template, if you know them",
-      "the content: the doc or points for the deck, and the event facts for a flyer",
+      "the content: the doc or points for the deck",
       "the audience and how long you have to present"
     ],
     "steps": [
@@ -38,23 +38,13 @@
         "you_do": "Give it the content, the audience and the time slot.",
         "you_get": "A slide-by-slide outline with takeaway titles, key points, speaker notes, backup slides for likely questions, and a slide-count check against the time."
       },
-      {
-        "skill": "deck-builder",
-        "you_do": "Hand it the outline, the audience and your brand.json.",
-        "you_get": "An editable .pptx in your brand, with charts, tables and images where the content calls for them."
-      },
       {
         "skill": "doc-critique",
-        "you_do": "Run it on the deck against the deck rubric, as deck-builder recommends.",
+        "you_do": "Run it on the outline against the deck rubric.",
         "you_get": "A verdict and severity-tagged findings with a fix for each.",
-        "decide": "Ship the deck, apply the changes, or rework the outline."
-      },
-      {
-        "skill": "marketing-flyer",
-        "you_do": "If you also need a flyer, give it the event facts and the same brand.json.",
-        "you_get": "A print-ready flyer.html with one call to action and only the facts you gave it, which you can save to PDF."
+        "decide": "Build the deck from the outline, apply the changes, or rework it."
       }
     ],
-    "you_end_with": "A reusable brand kit, a reviewed on-brand .pptx, and optionally a flyer built from the same brand."
+    "you_end_with": "A reusable brand kit and a reviewed outline, ready to become an on-brand .pptx with md-to-pptx from the converters pack."
   }
 }

package/packs/design/skills/brand-kit/SKILL.md

@@ -7,9 +7,8 @@ description: Capture a brand once as a reusable brand.json — logo files (and a
 
 You turn whatever the user has about their brand (logo files, a guidelines PDF, a website, a
 few hex codes, "we use green") into one `brand.json` that other skills build from:
-[`deck-builder`](../deck-builder/SKILL.md) for PowerPoint decks and
-[`marketing-flyer`](../marketing-flyer/SKILL.md) for flyers. Capturing the brand once means
-nobody answers the same questions for every deck, and the deck and the flyer match.
+the Word and PowerPoint converters, `md-to-docx` and `md-to-pptx`. Capturing the brand once means nobody answers the same questions for every deck,
+and every document matches.
 
 ## How to respond
 
@@ -58,11 +57,10 @@ nobody answers the same questions for every deck, and the deck and the flyer mat
    It fails on a malformed hex code, text-on-background contrast below 4.5:1, a missing logo
    file or template. It warns when white text on the primary is hard to read, when the accent
    is too light for text, when a logo is SVG or EPS, or when fonts aren't set. Fix the
-   failures. Report each warning with what it means for the deck or flyer.
+   failures. Report each warning with what it means for the deck or document.
 
-6. **Hand off.** Tell the user the path to `brand.json` and that `deck-builder` and
-   `marketing-flyer` will use it: `build_deck.py --brand brand.json`, or the flyer spec's
-   `brand` field.
+6. **Hand off.** Tell the user the path to `brand.json`, and that the Word and PowerPoint
+   converters apply it with `--brand brand.json`.
 
 **Non-interactive runs** (subagent, CI, headless): never invent a brand colour, font or logo.
 Use only what the input supplies, tag derived colours `[inferred]`, and list missing fields
@@ -93,7 +91,7 @@ brand name and either a logo file or one brand colour`.
 ## When NOT to use this skill
 
 - ❌ Designing a new brand from scratch: this captures a brand, it doesn't invent one
-- ❌ Building the deck or flyer itself; use `deck-builder` or `marketing-flyer`
+- ❌ Building the deck itself; convert its Markdown with `md-to-pptx`
 - ❌ A one-off document where the user only wants the default look
 
 ## Anti-patterns to avoid