AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
fix: gate strict-alpha haze, allow H,V --inset and width-only chart companions
hugohe399df48193d29
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex cb514f99..c399b0a9 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -293,7 +293,7 @@ Mechanical repetition comes from reusing one carrier and topology without a page| A primary image reduced to a minor frame | Restore its planned share || Unrelated page jobs collapsing into one neutral construction | Vary the construction by job |- **Absence needs a reason.** Each of these receipt facts needs one written line — what carries that job instead, and why that serves the reader better: a deck-wide `Presets: (none)`; `inline emphasis 0`, `gradients 0`, or `filters 0` on the `Effects:` line; fewer pages carrying a preset or connector than pages whose relationship line (Default: §IX `Relationships`; Quick: the transient relationship statement) names `order` / `link` / `parent` / `membership`; a `Presets:` line naming no carrier-and-field contour. Answer per family the presets serve, not for arrows alone:+ **Absence needs a reason.** Each of these receipt facts needs one written line — what carries that job instead, and why that serves the reader better: a deck-wide `Presets: (none)`; `inline emphasis 0`, `gradients 0`, or `filters 0` on the `Effects:` line; fewer pages carrying a preset or connector than pages whose relationship line (Default: §IX `Relationships`; Quick: the transient relationship statement) names `order` / `link` / `parent` / `membership`; a `Presets:` line naming no carrier-and-field contour; `icons: 0` while §VI (Quick: the prepared pool) registered an icon pool. Answer per family the presets serve, not for arrows alone:| Family | Members ||---|---|diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex 9790a7f2..ee1dd039 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -126,7 +126,7 @@ A sheet generates compatible transparent **illustration**, **illustrated-icon**,**Sheet prompt convention** — one `page_role: local` item with `image_size` from final placement; spot sheets `text_policy: none`, lettering sheets `embedded`:- **Grid**: derive `aspect_ratio` and `--grid` from the target shape, not a universal square grid. State an invisible logical **R×C grid** and the cell shape (compact square object, tall portrait, wide vignette, wide lettering mark); center each element in about 65% of its cell and keep at least 10% key-only margin on every side — tips, steam, particles, and effects included — so `slice_images.py --strict-alpha` never meets content on a cell edge. Never draw cells, panels, dividers, borders, frames, or alternate gutter colors; never shrink every subject into a square sticker.-- **Key**: one flat chroma key across the sheet — pure `#00FF00`, `#0000FF`, or `#FF0000`, chosen so its hue is absent from every element and effect (a pure key despills and recovers soft alpha; an opaque element of the key's hue keeps its color, but thin dark strokes of that hue still fringe) — stated as exact HEX before the palette and the subjects (deck colors appear only inside elements), unchanged in every gutter, free of reflections or spill; grain, halftone, and vignette stay inside elements. The key is technical, not deck palette. Every pixel that is not an element is the key itself — no white card, panel, paper, mat, or frame under an element and no second tint of the key; state the key rule first in the prompt and repeat it last, because a model told only "no borders" still paints each element on a white card.+- **Key**: one flat chroma key across the sheet — pure `#00FF00`, `#0000FF`, or `#FF0000`, chosen so its hue is absent from every element and effect (a pure key despills and recovers soft alpha; an opaque element of the key's hue keeps its color, but thin dark strokes of that hue still fringe; on a dark deck the despilled fringe takes the key's complementary hue — white chalk keyed on pure blue leaves a yellow-green halo on slate — so key those sheets with the measured ground colour, which skips despill) — stated as exact HEX before the palette and the subjects (deck colors appear only inside elements), unchanged in every gutter, free of reflections or spill; grain, halftone, and vignette stay inside elements. The key is technical, not deck palette. Every pixel that is not an element is the key itself — no white card, panel, paper, mat, or frame under an element and no second tint of the key; state the key rule first in the prompt and repeat it last, because a model told only "no borders" still paints each element on a white card.- **Identity**: shared `deck_rendering` + `color_scheme`.- **Illustration / illustrated-icon sheet**: name each element and its page or reuse job; for an icon, the compact cue that must survive at placement size; the §5.3 `none` cue.- **Lettering sheet**: exactly one named stable string per cell as the only text, quoted literally; the group's letterform character and treatment, then role, placement/background relationship, relative weight, and energy under §5.3's controlled-authorship default; artistry glyph-bound (silhouette, stroke structure, material, texture, depth, contour-bound light). No topic motifs, scene fragments, icons, detached ribbons, or particles unless the approved treatment is a lettering-plus-illustration lockup; key-only padding, no scene, unrelated copy, labels, watermark, or mockup surface. A single mark on a wide sheet (3:2 or wider) tends to come back with a faded ghost copy of itself above or below the real mark — give a lone mark a narrow band (about 4:1) that leaves no room for a second line, and inspect every lettering slice for a ghost band, not only for the characters.@@ -162,7 +162,7 @@ python3 scripts/slice_images.py <project>/images/illus_sheet.png --grid 2x3 \| Constraint | Rule ||---|---|-| **Strict key recovery** | Measure the smallest channel distance from any element pixel to the key first; raise `--tolerance` only enough to absorb measured flat-field drift and keep it below that distance, `--inset` for an isolated outer gutter or for grid lines the model drew between cells (its most frequent use — trim the gutter, never an element), and regenerate or enlarge when an effect reaches an edge. A `1x1` lettering sheet whose glyph touches the outer key border fails the same gate: pad the sheet with a key-colored border (about 10%) before slicing, or regenerate with more margin |+| **Strict key recovery** | Measure the smallest channel distance from any element pixel to the key first; raise `--tolerance` only enough to absorb measured flat-field drift and keep it below that distance, `--inset` for an isolated outer gutter or for grid lines the model drew between cells (its most frequent use — trim the gutter, never an element; wide lettering bands take `--inset 0.01,0.03` style H,V values so the horizontal line goes without cutting into the glyphs), and regenerate or enlarge when an effect reaches an edge. A `1x1` lettering sheet whose glyph touches the outer key border fails the same gate: pad the sheet with a key-colored border (about 10%) before slicing, or regenerate with more margin || **Clean isolated cells** | Fused cells, scene backgrounds, or flourishes crossing a cell make the sheet unusable; re-rolls follow only a strict keying failure or user/preview evidence, never taste || **Enough source pixels** | Each cell at least 1.5–2× its display size (`1K` small accents, `2K` medium, `4K` large or enlarged) |diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex 7f6deb78..f54468c8 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -92,7 +92,7 @@ Seed the six contract fields of [`plan-core.md`](./plan-core.md) §1 as open-pro**Hard rule — top-down direction construction**: author three complete, project-fit solution intents from the confirmed contract and source before touching any catalog basis. The three mode/style/rendering indexes are the only basis selectors. Freeze each direction's exact reference ids from the index summaries, read once only the deduplicated union of those detail files, then write the behaviors. Never force safe / shifted / bold archetypes, glob a catalog, read an unselected sibling, or write bespoke prose as an enum value.-**Direction serialization**: every direction serializes `mode: custom`, `visual_style: custom`, and `image_strategy.rendering: custom`, each with visible non-empty behavior prose. A custom may use catalog material in any way or none; one preset carried unchanged is valid. References record only actual sources, each owning a distinct executable contribution, never a decorative second basis.+**Direction serialization**: every direction serializes `mode: custom`, `visual_style: custom`, and `image_strategy.rendering: custom`, each with visible non-empty behavior prose. A custom may use catalog material in any way or none; one preset carried unchanged is valid; a layer the user or an installed template already fixed to a catalog preset locks that preset id instead of `custom`. References record only actual sources, each owning a distinct executable contribution, never a decorative second basis.**Three plainly different designs**: the three directions differ as designs *before* any field is written. Whichever components a design requires carry the difference; mode, style, rendering, bases, color, type, and icons are each free to coincide. A different name, note, or reference count alone is no difference, and identical projections are not three solutions. Where authoritative truth fixes components, the open ones carry the difference. Where nothing is open, keep the projections identical and state that boundary.diff --git a/skills/ppt-master/scripts/slice_images.py b/skills/ppt-master/scripts/slice_images.pyindex 93ea9164..2999d26b 100644--- a/skills/ppt-master/scripts/slice_images.py+++ b/skills/ppt-master/scripts/slice_images.py@@ -75,6 +75,12 @@ _KEY_DRIFT_MARGIN = 4_KEY_PURITY_OPAQUE_RATIO = 0.6# At most this many trim pixels on a touched edge count as isolated drift._EDGE_DRIFT_MAX_PIXELS = 8+# Strict-alpha haze gate: when this share of an element's trimmed box sits in+# the semi-transparent alpha band, the key field itself was recovered as soft+# alpha (the sheet ground is not the stated key), not an element edge.+_HAZE_ALPHA_LOW = 20+_HAZE_ALPHA_HIGH = 150+_HAZE_MAX_SHARE = 0.15# Corner sample inset (px) and minimum cell fill for the backing-panel notice._PANEL_CORNER_INSET = 2_PANEL_MIN_FILL = 0.75@@ -96,6 +102,20 @@ def parse_grid(spec: str) -> tuple[int, int]:return rows, cols+def parse_inset(spec: str) -> tuple[float, float]:+ """Parse `--inset` as one fraction or `H,V`; both must lie in [0, 0.5)."""+ parts = [part.strip() for part in str(spec).split(",")]+ if len(parts) not in (1, 2) or not all(parts):+ raise ValueError("--inset must be one fraction or H,V")+ try:+ values = [float(part) for part in parts]+ except ValueError as exc:+ raise ValueError("--inset must be one fraction or H,V") from exc+ if not all(0.0 <= value < 0.5 for value in values):+ raise ValueError("--inset must be in [0, 0.5)")+ return (values[0], values[-1])++def parse_hex(value: str) -> tuple[int, int, int]:"""Parse '#RRGGBB' / 'RRGGBB' into an (r, g, b) tuple."""h = value.strip().lstrip("#")@@ -531,6 +551,39 @@ def _keying_findings(return findings+def _haze_finding(+ label: str,+ alpha_mask: Image.Image,+ bbox: tuple[int, int, int, int],+ bg: tuple[int, int, int],+) -> Optional[str]:+ """Report an element box that is mostly semi-transparent haze.++ Soft-alpha recovery assumes the key field lies at the stated key; when the+ real ground sits farther than the tolerance, the whole field comes back as+ faint half-foreground that reads as a glowing rectangle on a dark slide.+ `--strict-alpha` only inspects the outer gutter, so this gate looks at the+ trimmed box itself.+ """+ box = alpha_mask.crop(bbox)+ total = box.width * box.height+ if total == 0:+ return None+ histogram = box.histogram()+ hazy = sum(histogram[_HAZE_ALPHA_LOW:_HAZE_ALPHA_HIGH + 1])+ share = hazy / total+ if share <= _HAZE_MAX_SHARE:+ return None+ hex_bg = "#{:02X}{:02X}{:02X}".format(*bg)+ return (+ f"{label}: {share:.0%} of the trimmed element box is semi-transparent "+ f"(alpha {_HAZE_ALPHA_LOW}-{_HAZE_ALPHA_HIGH}): the key field itself "+ f"was recovered as soft alpha, so the sheet ground is not {hex_bg}; "+ "rerun with --bg set to the measured ground colour (see the sheet "+ "border line below) instead of the nearest pure key"+ )++def _backing_panel_notice(label: str,alpha_mask: Image.Image,@@ -673,7 +726,7 @@ def slice_sheet(*,names: Optional[list[str]] = None,prefix: Optional[str] = None,- inset: float = 0.0,+ inset: float | tuple[float, float] = 0.0,trim: bool = False,alpha: bool = False,strict_alpha: bool = False,@@ -687,6 +740,7 @@ def slice_sheet(automated run never silently drops cells. Each name must be a bare filename."""total_cells = rows * cols+ inset_x, inset_y = inset if isinstance(inset, tuple) else (inset, inset)if strict_alpha and not alpha:raise ValueError("strict_alpha requires alpha=True")if names is not None and len(names) != total_cells:@@ -730,9 +784,9 @@ def slice_sheet(# Integer cell box via per-index rounding to avoid drift.x0, x1 = round(c * sw / cols), round((c + 1) * sw / cols)y0, y1 = round(r * sh / rows), round((r + 1) * sh / rows)- if inset > 0:- dx = round((x1 - x0) * inset)- dy = round((y1 - y0) * inset)+ if inset_x > 0 or inset_y > 0:+ dx = round((x1 - x0) * inset_x)+ dy = round((y1 - y0) * inset_y)x0, x1, y0, y1 = x0 + dx, x1 - dx, y0 + dy, y1 - dycell = sheet.crop((x0, y0, x1, y1))@@ -753,6 +807,10 @@ def slice_sheet(trim=trim, alpha=alpha, trim_mask=trim_mask, diff=diff,notices=notices,))+ if strict_alpha:+ haze = _haze_finding(f"cell ({r},{c})", alpha_mask, bbox, cell_bg)+ if haze:+ findings.append(haze)if trim and trim_mask is not None and alpha_mask is not None and bbox is not None:cell = cell.crop(bbox)@@ -830,8 +888,12 @@ def build_parser() -> argparse.ArgumentParser:help="Filename prefix when --names is absent (default: '<sheet-stem>_')",)parser.add_argument(- "--inset", type=float, default=0.0,- help="Trim each cell inward by this fraction on every side (0-0.49) to drop gutters",+ "--inset", type=str, default="0",+ help=(+ "Trim each cell inward by this fraction (0-0.49) to drop gutters: "+ "one value for every side, or H,V (e.g. 0.01,0.03) when wide cells "+ "only need the horizontal grid line trimmed"+ ),)parser.add_argument("--trim", action="store_true",@@ -876,8 +938,10 @@ def main(argv: Optional[list[str]] = None) -> int:print(f"[ERROR] {exc}", file=sys.stderr)return 1- if not 0.0 <= args.inset < 0.5:- print("[ERROR] --inset must be in [0, 0.5)", file=sys.stderr)+ try:+ inset = parse_inset(args.inset)+ except ValueError as exc:+ print(f"[ERROR] {exc}", file=sys.stderr)return 1if not 0 <= args.tolerance <= 255:print("[ERROR] --tolerance must be in [0, 255]", file=sys.stderr)@@ -892,7 +956,7 @@ def main(argv: Optional[list[str]] = None) -> int:try:written = slice_sheet(sheet_path, rows, cols, output_dir,- names=names, prefix=args.prefix, inset=args.inset,+ names=names, prefix=args.prefix, inset=inset,trim=args.trim, alpha=args.alpha, strict_alpha=args.strict_alpha,bg=bg, tolerance=args.tolerance,)diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.pyindex 707f6c11..05c9b384 100644--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.py+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.py@@ -1480,10 +1480,21 @@ def _chart_companion_entries(return entries+def _chart_companion_width_only(item: dict[str, Any]) -> int | None:+ """Return the authored width when a companion carries only `width`."""+ if "width" in item and not any(key in item for key in ("x", "y", "height")):+ return _powerpoint_emu(item["width"], "companion text width", positive=True)+ return None++def _chart_companion_box(item: dict[str, Any]) -> tuple[int, int, int, int] | None:"""Validate and resolve an optional explicit companion text box."""box_keys = ("x", "y", "width", "height")provided_box_keys = [key for key in box_keys if key in item]+ if provided_box_keys == ["width"]:+ # Width alone: the box is placed from the matching fallback text or+ # the default slot; only its width is authored.+ return Noneif provided_box_keys and len(provided_box_keys) != len(box_keys):raise RuntimeError("Native PPTX chart companion text boxes require x/y/width/height together"@@ -1595,6 +1606,7 @@ def _chart_companion_shapes(align = str(item.get("align") or ("ctr" if role == "title" else "l"))bold = bool(item.get("bold", role == "title"))explicit_box = _chart_companion_box(item)+ width_only = _chart_companion_width_only(item)if explicit_box is not None:off_x, off_y, ext_cx, ext_cy = explicit_boxelif role == "title":@@ -1611,6 +1623,8 @@ def _chart_companion_shapes(ext_cx = chart_ext_cxext_cy = px_to_emu(16)below_index += 1+ if width_only is not None:+ ext_cx = width_onlyanchor = "t"matches = [record for record in fallback_textsdiff --git a/skills/ppt-master/scripts/tests/test_native_chart_fidelity.py b/skills/ppt-master/scripts/tests/test_native_chart_fidelity.pyindex 53e0eb12..be892b17 100644--- a/skills/ppt-master/scripts/tests/test_native_chart_fidelity.py+++ b/skills/ppt-master/scripts/tests/test_native_chart_fidelity.py@@ -385,6 +385,54 @@ class SpacingTests(unittest.TestCase):class CompanionPlacementTests(unittest.TestCase):+ def test_svg_first_companion_may_carry_only_its_width(self) -> None:+ import json+ import re+ import tempfile++ from svg_to_pptx.drawingml.converter import convert_svg_to_slide_shapes+ from svg_to_pptx.drawingml.utils import px_to_emu+ from svg_to_pptx.native_objects.fallback_hash import stamp_native_fallback_baseline++ payload = {+ "x": 100, "y": 100, "width": 600, "height": 300,+ "name": "chart-note",+ "type": "column",+ "categories": ["A", "B"],+ "series": [{"name": "S", "values": [1, 2]}],+ "plot_area": {"x": 140, "y": 130, "width": 540, "height": 250},+ "style": {"colors": ["#111111"], "text_color": "#111111"},+ # Only the width is authored; x/y/height come from the fallback text.+ "notes": [{"text": "Unit note", "width": 200, "font_size": 18}],+ }+ svg = (+ f'<svg xmlns="{SVG_NS}" viewBox="0 0 1280 720">'+ '<g id="chart-note" data-pptx-replace-with="chart">'+ f'<metadata type="application/json">{json.dumps(payload)}</metadata>'+ '<rect x="140" y="130" width="540" height="250" fill="#FFFFFF"/>'+ '<text x="140" y="120" font-size="18" fill="#111111">Unit note</text>'+ '<text x="410" y="400" font-size="18" fill="#111111">A</text>'+ '<text x="410" y="400" font-size="18" fill="#111111">B</text>'+ "</g></svg>"+ )+ root = ET.fromstring(svg)+ stamp_native_fallback_baseline(root.find(f"{{{SVG_NS}}}g"), document_root=root)+ svg = ET.tostring(root, encoding="unicode")+ with tempfile.TemporaryDirectory() as tmp:+ path = Path(tmp) / "01.svg"+ path.write_text(svg, encoding="utf-8")+ slide_xml, *_ = convert_svg_to_slide_shapes(+ path, resource_root=Path(tmp), native_objects=True,+ )+ note = slide_xml[slide_xml.index("Chart Note"):]+ off_x = int(re.search(r'<a:off x="(\d+)" y="\d+"/>', note).group(1))+ off_y = int(re.search(r'<a:off x="\d+" y="(\d+)"/>', note).group(1))+ ext_cx = int(re.search(r'<a:ext cx="(\d+)" cy="\d+"/>', note).group(1))+ ext_cy = int(re.search(r'<a:ext cx="\d+" cy="(\d+)"/>', note).group(1))+ self.assertEqual(ext_cx, px_to_emu(200))+ self.assertEqual(off_x, px_to_emu(140))+ self.assertEqual(off_y + ext_cy, px_to_emu(120 + 18 * 0.25))+def test_svg_first_companion_sits_on_the_fallback_baseline(self) -> None:import jsonimport rediff --git a/skills/ppt-master/scripts/tests/test_slice_images.py b/skills/ppt-master/scripts/tests/test_slice_images.pyindex 1dc0e5b4..feaa2ac2 100644--- a/skills/ppt-master/scripts/tests/test_slice_images.py+++ b/skills/ppt-master/scripts/tests/test_slice_images.py@@ -172,6 +172,78 @@ class SliceImagesDiagnosticsTests(unittest.TestCase):self.assertIn("Suggested rerun:", result.stderr)self.assertFalse((output_dir / "element.png").exists())+ def test_inset_accepts_horizontal_and_vertical_fractions(self) -> None:+ from slice_images import parse_inset++ self.assertEqual(parse_inset("0.03"), (0.03, 0.03))+ self.assertEqual(parse_inset("0.01,0.03"), (0.01, 0.03))+ with self.assertRaises(ValueError):+ parse_inset("0.5")+ with self.assertRaises(ValueError):+ parse_inset("0.1,0.2,0.3")++ with tempfile.TemporaryDirectory() as tmp:+ root = Path(tmp)+ sheet_path = root / "sheet.png"+ output_dir = root / "output"+ # Two wide bands with a white grid line between them: an+ # isotropic inset wide enough for the line would cut the glyphs.+ image = Image.new("RGB", (400, 100), (0, 0, 255))+ draw = ImageDraw.Draw(image)+ draw.rectangle((0, 48, 399, 51), fill=(255, 255, 255))+ draw.rectangle((10, 8, 390, 40), fill=(240, 240, 240))+ draw.rectangle((10, 58, 390, 92), fill=(240, 240, 240))+ image.save(sheet_path)++ result = subprocess.run(+ [+ sys.executable, str(SCRIPT), str(sheet_path),+ "--grid", "2x1", "--names", "a,b",+ "--trim", "--alpha", "--strict-alpha",+ "--bg", "#0000FF", "--inset", "0,0.06",+ "--output", str(output_dir),+ ],+ capture_output=True, text=True, check=False,+ )+ self.assertEqual(result.returncode, 0, result.stderr)+ self.assertEqual(Image.open(output_dir / "a.png").size, (381, 33))+ self.assertEqual(Image.open(output_dir / "b.png").size, (381, 35))++ def test_strict_alpha_rejects_a_sheet_whose_ground_recovers_as_haze(self) -> None:+ with tempfile.TemporaryDirectory() as tmp:+ root = Path(tmp)+ sheet_path = root / "sheet.png"+ output_dir = root / "output"+ # The real ground (#034AF4) sits farther from pure blue than the+ # tolerance, so soft-alpha recovery turns the whole field into a+ # faint half-foreground; the outer gutter alone does not catch it.+ image = Image.new("RGB", (160, 120), (3, 74, 244))+ draw = ImageDraw.Draw(image)+ draw.rectangle((60, 40, 100, 80), fill=(250, 250, 250))+ image.save(sheet_path)++ args = [+ sys.executable, str(SCRIPT), str(sheet_path),+ "--grid", "1x1", "--names", "mark",+ "--trim", "--alpha", "--strict-alpha",+ "--output", str(output_dir),+ ]+ result = subprocess.run(+ args + ["--bg", "#0000FF", "--tolerance", "62"],+ capture_output=True, text=True, check=False,+ )+ self.assertEqual(result.returncode, 1)+ self.assertIn("semi-transparent", result.stderr)+ self.assertIn("measured ground colour", result.stderr)+ self.assertFalse((output_dir / "mark.png").exists())++ result = subprocess.run(+ args + ["--bg", "#034AF4", "--tolerance", "62"],+ capture_output=True, text=True, check=False,+ )+ self.assertEqual(result.returncode, 0, result.stderr)+ self.assertEqual(Image.open(output_dir / "mark.png").size, (41, 41))+class ImageOrientationProcessingTests(unittest.TestCase):def test_compression_applies_orientation_and_preserves_image_format(self) -> None:diff --git a/skills/ppt-master/workflows/stages/topic-research.md b/skills/ppt-master/workflows/stages/topic-research.mdindex 307cdaca..14aeb614 100644--- a/skills/ppt-master/workflows/stages/topic-research.md+++ b/skills/ppt-master/workflows/stages/topic-research.md@@ -49,7 +49,7 @@ Default bundles only genuinely missing scope or research-boundary decisions into## Step 2: Gather factual sources-Use the search and fetch tools available in the research context; an isolated worker without them returns `blocked: web-tools-unavailable`. With no usable search/fetch context, pause and ask the user for authoritative URLs covering the gaps, then fetch each with `web_to_md.py <URL> -o projects/<research_slug>_web_sources/<source_slug>.md --no-images` (remote image links stay in the Markdown; nothing is downloaded).+Use the search and fetch tools available in the research context; an isolated worker without them returns `blocked: web-tools-unavailable`. With no usable search/fetch context, pause and ask the user for authoritative URLs covering the gaps, then fetch each with `python3 ${SKILL_DIR}/scripts/source_to_md/web_to_md.py <URL> -o projects/<research_slug>_web_sources/<source_slug>.md --no-images` (remote image links stay in the Markdown; nothing is downloaded).Orient (map authoritative sources to the gaps) → deep fetch (read the highest-signal primary pages in full) → targeted fill (search only for gaps still unsupported). Prefer primary sources, official sites, institutional releases, standards, and original research; then authoritative reference works and academic sources; then reputable reporting; avoid unsourced reposts, unverifiable summaries, and stock-aggregator pages.@@ -92,7 +92,7 @@ python3 ${SKILL_DIR}/scripts/project_manager.py import-sources projects/<projectIf planning later exposes a required gap, return here and repair the pair before continuing; Strategist or Quick never consumes a newly fetched claim without updating it. The imported pair is the compact evidence-facing content authority, not a locked contract: Default's Strategist reads both files completely before confirmation; Quick's agent does the same before its content, design, and resource decisions.-**Single-page image fallback**: only after normal web-image providers, ranked thumbnail pages, and materially different queries fail may an image owner with visual capability select one relevant `source_url` from the facts JSON and fetch that one page package with `web_to_md.py "<source_url>" -o <project_path>/sources/<source_slug>.md`, review the companion `<source_slug>_files/` package, and copy only accepted images into `<project_path>/images/` — never pass the URL to `import-sources`, which would promote every companion image into the pool. Fetch another page only after the current package has no usable image; without vision, retain `Needs-Manual`.+**Single-page image fallback**: only after normal web-image providers, ranked thumbnail pages, and materially different queries fail may an image owner with visual capability select one relevant `source_url` from the facts JSON and fetch that one page package with `python3 ${SKILL_DIR}/scripts/source_to_md/web_to_md.py "<source_url>" -o <project_path>/sources/<source_slug>.md`, review the companion `<source_slug>_files/` package, and copy only accepted images into `<project_path>/images/` — never pass the URL to `import-sources`, which would promote every companion image into the pool. Fetch another page only after the current package has no usable image; without vision, retain `Needs-Manual`.```markdown## ✅ Topic Research Complete