@hasna/skills 0.1.61 → 0.1.63

package/skills/slide-deck-generator/package.json

@@ -1,38 +0,0 @@
-{
-  "name": "slide-deck-generator",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Turn a brief or markdown outline into a real slide deck: slides.json, deck.md, speaker notes, theme guide, self-contained HTML, and a PPTX file",
-  "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "slide-deck-generator": "src/index.ts"
-  },
-  "files": [
-    "src",
-    "SKILL.md",
-    "tsconfig.json"
-  ],
-  "keywords": [
-    "slides",
-    "deck",
-    "pptx",
-    "powerpoint",
-    "presentation",
-    "markdown",
-    "cli",
-    "skill"
-  ],
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "marked": "^15.0.0",
-    "pptxgenjs": "^3.12.0"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  }
-}

package/skills/slide-deck-generator/src/cli.ts

@@ -1,133 +0,0 @@
-import { AUDIENCES, FORMATS, THEMES, type CliOptions } from "./types.js";
-
-const VERSION = "0.1.0";
-
-function printHelp(): void {
-  console.log(`slide-deck-generator v${VERSION}
-
-USAGE:
-  slide-deck-generator --brief "<text>" [options]
-  slide-deck-generator --source <outline.md> [options]
-
-OPTIONS:
-  -b, --brief <text>      Brief, outline, or narrative text. A bare positional also works.
-  -s, --source <path>     Read the brief/outline from a Markdown or text file.
-  -t, --title <text>      Deck title (default: first heading, or first line of the brief)
-  -n, --slides <n>        Target slide count (default: 8)
-      --theme <name>      ${Object.keys(THEMES).join(" | ")} (default: midnight)
-      --audience <type>   ${AUDIENCES.join(" | ")} (default: team)
-      --format <type>     ${FORMATS.join(" | ")} (default: general)
-  -o, --output <dir>      Output directory (default: ./slide-deck)
-      --no-pptx           Skip deck.pptx rendering (all other files still emitted)
-      --json              Print the manifest as JSON instead of a text summary
-  -h, --help              Show this help message
-  -v, --version           Show the current version
-
-EXAMPLES:
-  slide-deck-generator --brief "Q2 launch review for AI billing" --slides 10 --theme aurora
-  slide-deck-generator --source ./outline.md --audience executives --output ./out
-`);
-}
-
-export function parseArgs(argv: string[]): CliOptions {
-  const options: CliOptions = {
-    audience: "team",
-    format: "general",
-    slides: 8,
-    theme: "midnight",
-    output: "./slide-deck",
-    json: false,
-    noPptx: false,
-  };
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-
-    switch (arg) {
-      case "--help":
-      case "-h":
-        printHelp();
-        process.exit(0);
-      case "--version":
-      case "-v":
-        console.log(VERSION);
-        process.exit(0);
-      case "--brief":
-      case "-b":
-        options.brief = argv[++i];
-        break;
-      case "--source":
-      case "-s":
-        options.source = argv[++i];
-        break;
-      case "--title":
-      case "-t":
-        options.title = argv[++i];
-        break;
-      case "--slides":
-      case "-n": {
-        const value = Number.parseInt(argv[++i] ?? "", 10);
-        if (!Number.isFinite(value) || value < 1 || value > 60) {
-          throw new Error(`Invalid --slides value: ${argv[i]}. Use 1-60.`);
-        }
-        options.slides = value;
-        break;
-      }
-      case "--theme": {
-        const value = (argv[++i] ?? "").toLowerCase();
-        if (!THEMES[value]) {
-          throw new Error(`Unknown --theme: ${value}. Available: ${Object.keys(THEMES).join(", ")}`);
-        }
-        options.theme = value;
-        break;
-      }
-      case "--audience": {
-        const value = (argv[++i] ?? "").toLowerCase();
-        if (!AUDIENCES.includes(value)) {
-          throw new Error(`Unknown --audience: ${value}. Available: ${AUDIENCES.join(", ")}`);
-        }
-        options.audience = value;
-        break;
-      }
-      case "--format": {
-        const value = (argv[++i] ?? "").toLowerCase();
-        if (!FORMATS.includes(value)) {
-          throw new Error(`Unknown --format: ${value}. Available: ${FORMATS.join(", ")}`);
-        }
-        options.format = value;
-        break;
-      }
-      case "--output":
-      case "-o":
-        options.output = argv[++i] ?? "./slide-deck";
-        break;
-      case "--no-pptx":
-        options.noPptx = true;
-        break;
-      case "--json":
-        options.json = true;
-        break;
-      default:
-        if (arg.startsWith("-")) {
-          throw new Error(`Unknown option: ${arg}`);
-        }
-        if (!options.brief && !options.source) {
-          options.brief = arg;
-          break;
-        }
-        throw new Error(`Unexpected argument: ${arg}`);
-    }
-  }
-
-  if (!options.brief && !options.source) {
-    throw new Error("Provide --brief <text> or --source <file>. See --help.");
-  }
-
-  return options;
-}
-
-/* -------------------------------------------------------------------------- */
-/* Text helpers                                                                */
-/* -------------------------------------------------------------------------- */
-
-

package/skills/slide-deck-generator/src/index.ts

@@ -1,148 +0,0 @@
-#!/usr/bin/env bun
-
-import { mkdir, readFile, writeFile } from "fs/promises";
-import { basename, dirname, join, resolve } from "path";
-
-import { parseArgs } from "./cli.js";
-import { buildSlides, draftsFromBrief, parseMarkdown, type DraftSlide } from "./model.js";
-import { renderPptx } from "./pptx.js";
-import {
-  renderDeckMarkdown,
-  renderHtml,
-  renderSpeakerNotes,
-  renderThemeGuide,
-} from "./render.js";
-import { THEMES } from "./types.js";
-import { shorten, stripInlineMarkdown, titleCase } from "./utils.js";
-
-const VERSION = "0.1.0";
-
-async function writeOut(root: string, relativePath: string, contents: string): Promise<string> {
-  const target = join(root, relativePath);
-  await mkdir(dirname(target), { recursive: true });
-  await writeFile(target, contents, "utf8");
-  return relativePath;
-}
-
-async function main(): Promise<void> {
-  const options = parseArgs(process.argv.slice(2));
-  const theme = THEMES[options.theme];
-
-  let sourceText = options.brief ?? "";
-  let sourceLabel = "brief";
-  if (options.source) {
-    const sourcePath = resolve(options.source);
-    try {
-      sourceText = await readFile(sourcePath, "utf8");
-    } catch {
-      throw new Error(`Unable to read source file: ${sourcePath}`);
-    }
-    sourceLabel = sourcePath;
-  }
-
-  if (!sourceText.trim()) {
-    throw new Error("Source text is empty. Nothing to build a deck from.");
-  }
-
-  const looksLikeMarkdown = /^\s*#|^\s*[-*+]\s+|^\s*\d+\.\s+/m.test(sourceText);
-  let deckTitle = options.title;
-  let drafts: DraftSlide[];
-
-  if (looksLikeMarkdown) {
-    const parsed = await parseMarkdown(sourceText);
-    deckTitle = deckTitle ?? parsed.deckTitle;
-    drafts = parsed.drafts;
-    if (drafts.length === 0) drafts = draftsFromBrief(sourceText);
-  } else {
-    drafts = draftsFromBrief(sourceText);
-  }
-
-  if (!deckTitle) {
-    const firstLine = sourceText.split("\n").map((line) => stripInlineMarkdown(line)).find(Boolean) ?? "Slide Deck";
-    deckTitle = titleCase(shorten(firstLine, 70));
-  }
-
-  if (drafts.length === 0) {
-    throw new Error("Could not derive any slides from the source text.");
-  }
-
-  const slides = buildSlides(deckTitle, drafts, options);
-  const outputRoot = resolve(options.output);
-  const written: string[] = [];
-
-  const slidesJson = {
-    title: deckTitle,
-    theme: theme.name,
-    audience: options.audience,
-    format: options.format,
-    slideCount: slides.length,
-    slides,
-  };
-
-  written.push(await writeOut(outputRoot, "slides.json", `${JSON.stringify(slidesJson, null, 2)}\n`));
-  written.push(await writeOut(outputRoot, "deck.md", renderDeckMarkdown(deckTitle, slides, theme, options)));
-  written.push(await writeOut(outputRoot, "speaker-notes.md", renderSpeakerNotes(deckTitle, slides, options)));
-  written.push(await writeOut(outputRoot, "theme-guide.md", renderThemeGuide(theme, slides)));
-  written.push(await writeOut(outputRoot, "deck.html", renderHtml(deckTitle, slides, theme, options)));
-
-  let pptxError: string | undefined;
-  if (!options.noPptx) {
-    await mkdir(outputRoot, { recursive: true });
-    try {
-      await renderPptx(join(outputRoot, "deck.pptx"), deckTitle, slides, theme, options);
-      written.push("deck.pptx");
-    } catch (error) {
-      pptxError = error instanceof Error ? error.message : String(error);
-    }
-  }
-
-  const manifest = {
-    skill: "slide-deck-generator",
-    skillVersion: VERSION,
-    generatedAt: new Date().toISOString(),
-    title: deckTitle,
-    source: options.source ? { type: "file", path: sourceLabel } : { type: "brief", chars: sourceText.length },
-    theme: theme.name,
-    audience: options.audience,
-    format: options.format,
-    slideCount: slides.length,
-    layouts: slides.map((slide) => slide.layout),
-    outputDir: outputRoot,
-    files: [...written, "manifest.json"].sort(),
-    pptx: options.noPptx ? "skipped" : pptxError ? `failed: ${pptxError}` : "ok",
-  };
-
-  written.push(await writeOut(outputRoot, "manifest.json", `${JSON.stringify(manifest, null, 2)}\n`));
-
-  if (pptxError) {
-    process.stderr.write(`slide-deck-generator: warning: deck.pptx was not written (${pptxError})\n`);
-  }
-
-  if (options.json) {
-    process.stdout.write(`${JSON.stringify(manifest, null, 2)}\n`);
-    return;
-  }
-
-  console.log(
-    [
-      `slide-deck-generator v${VERSION}`,
-      `  title      ${deckTitle}`,
-      `  source     ${options.source ? basename(sourceLabel) : `brief (${sourceText.length} chars)`}`,
-      `  theme      ${theme.label} (${theme.name})`,
-      `  audience   ${options.audience} · format ${options.format}`,
-      `  slides     ${slides.length}`,
-      `  output     ${outputRoot}`,
-      "",
-      "Files:",
-      ...manifest.files.map((file) => `  ${file}`),
-      "",
-      `Open the deck: ${join(outputRoot, "deck.html")} (← → to navigate, N for notes, Ctrl/Cmd-P to print)`,
-    ].join("\n"),
-  );
-}
-
-main().catch((error) => {
-  const message = error instanceof Error ? error.message : String(error);
-  process.stderr.write(`slide-deck-generator: ${message}\n`);
-  process.exit(1);
-});

package/skills/slide-deck-generator/src/model.ts

@@ -1,307 +0,0 @@
-import type { CliOptions, Layout, Slide } from "./types.js";
-import { chunk, headlineFrom, shorten, splitSentences, stripInlineMarkdown, titleCase } from "./utils.js";
-
-async function loadMarked() {
-  try {
-    return (await import("marked")).marked;
-  } catch {
-    throw new Error("Missing dependency 'marked'. Run bun install in this skill directory.");
-  }
-}
-
-
-export interface DraftSlide {
-  layout: Layout;
-  title: string;
-  subtitle?: string;
-  bullets: string[];
-  notes: string[];
-}
-
-export async function parseMarkdown(source: string): Promise<{ deckTitle?: string; drafts: DraftSlide[] }> {
-  const marked = await loadMarked();
-  const tokens = marked.lexer(source);
-
-  const drafts: DraftSlide[] = [];
-  let deckTitle: string | undefined;
-  let current: DraftSlide | undefined;
-  let sectionTitle: string | undefined;
-
-  const push = (draft: DraftSlide) => {
-    drafts.push(draft);
-    current = draft;
-  };
-
-  /** Title used when content appears without a heading of its own. */
-  const implicitTitle = (fallback: string): string => {
-    if (!sectionTitle) return fallback;
-    const used = drafts.filter(
-      (draft) =>
-        draft.title.startsWith(sectionTitle!) && (draft.bullets.length > 0 || draft.notes.length > 0),
-    ).length;
-    return used === 0 ? sectionTitle : `${sectionTitle} (cont.)`;
-  };
-
-  const ensureCurrent = (fallback: string) => {
-    if (!current) push({ layout: "bullets", title: implicitTitle(fallback), bullets: [], notes: [] });
-  };
-
-  for (const token of tokens as any[]) {
-    switch (token.type) {
-      case "heading": {
-        const text = stripInlineMarkdown(token.text ?? "");
-        if (!text) break;
-        if (token.depth === 1 && !deckTitle) {
-          deckTitle = text;
-          break;
-        }
-        if (token.depth <= 2) {
-          sectionTitle = titleCase(text);
-          push({ layout: "bullets", title: sectionTitle, bullets: [], notes: [] });
-        } else if (current) {
-          current.bullets.push(text);
-        } else {
-          sectionTitle = titleCase(text);
-          push({ layout: "bullets", title: sectionTitle, bullets: [], notes: [] });
-        }
-        break;
-      }
-      case "list": {
-        const items = (token.items ?? []) as any[];
-        ensureCurrent("Overview");
-        for (const item of items) {
-          const text = stripInlineMarkdown(item.text ?? "");
-          if (text) current!.bullets.push(shorten(text, 160));
-        }
-        break;
-      }
-      case "paragraph": {
-        const text = stripInlineMarkdown(token.text ?? "");
-        if (!text) break;
-        ensureCurrent("Overview");
-        current!.notes.push(text);
-        break;
-      }
-      case "blockquote": {
-        const text = stripInlineMarkdown(token.text ?? "");
-        if (!text) break;
-        push({ layout: "quote", title: shorten(text, 220), bullets: [], notes: [] });
-        current = undefined;
-        break;
-      }
-      case "code": {
-        ensureCurrent("Example");
-        const firstLines = String(token.text ?? "")
-          .split("\n")
-          .filter(Boolean)
-          .slice(0, 4);
-        for (const line of firstLines) current!.bullets.push(shorten(line.trim(), 120));
-        break;
-      }
-      default:
-        break;
-    }
-  }
-
-  // Any slide with prose but no bullets gets bullets derived from its prose.
-  for (const draft of drafts) {
-    if (draft.bullets.length === 0 && draft.notes.length > 0 && draft.layout === "bullets") {
-      const sentences = splitSentences(draft.notes.join(" ")).slice(0, 5);
-      draft.bullets = sentences.map((sentence) => shorten(sentence, 160));
-    }
-  }
-
-  return { deckTitle, drafts: drafts.filter((draft) => draft.bullets.length > 0 || draft.layout === "quote") };
-}
-
-export function draftsFromBrief(brief: string): DraftSlide[] {
-  const sentences = splitSentences(stripInlineMarkdown(brief));
-  if (sentences.length === 0) return [];
-
-  const groups = chunk(sentences, Math.max(2, Math.ceil(sentences.length / 5)));
-  return groups.map((group) => ({
-    layout: "bullets" as Layout,
-    title: headlineFrom(group[0]),
-    bullets: group.map((sentence) => shorten(sentence, 160)),
-    notes: [group.join(" ")],
-  }));
-}
-
-const FORMAT_CLOSERS: Record<string, Array<{ title: string; bullets: string[] }>> = {
-  general: [
-    { title: "Key takeaways", bullets: ["What changed", "Why it matters", "What we do next"] },
-    { title: "Next steps", bullets: ["Owner and date per action", "Open decisions", "How we measure success"] },
-  ],
-  training: [
-    { title: "Practice", bullets: ["Hands-on exercise", "Common mistakes", "Check for understanding"] },
-    { title: "Resources", bullets: ["Reference docs", "Where to ask questions", "Follow-up session"] },
-  ],
-  sales: [
-    { title: "Why now", bullets: ["Cost of waiting", "Time to value", "Proof from similar teams"] },
-    { title: "Proposed next step", bullets: ["Pilot scope", "Success criteria", "Commercial terms"] },
-  ],
-  report: [
-    { title: "Findings", bullets: ["What the data shows", "What surprised us", "Confidence and caveats"] },
-    { title: "Recommendations", bullets: ["Priority actions", "Owners", "Review cadence"] },
-  ],
-  proposal: [
-    { title: "Scope and plan", bullets: ["Phases and milestones", "Team and roles", "Assumptions"] },
-    { title: "Investment and outcomes", bullets: ["Cost breakdown", "Expected outcomes", "Decision date"] },
-  ],
-};
-
-const AUDIENCE_NOTE: Record<string, string> = {
-  team: "Internal audience: keep the detail, name owners, and be explicit about trade-offs.",
-  customers: "External audience: lead with outcomes, avoid internal jargon, and end on a clear ask.",
-  executives: "Executive audience: state the decision up front, then the evidence, then the ask.",
-  students: "Learning audience: define terms, pause for questions, and reinforce with an example.",
-}
-;
-
-function agendaSlide(drafts: DraftSlide[]): DraftSlide {
-  const seen = new Set<string>();
-  const titles: string[] = [];
-  for (const draft of drafts) {
-    if (draft.layout === "quote") continue;
-    const title = draft.title.replace(/\s*\(cont\.\)$/, "");
-    if (seen.has(title)) continue;
-    seen.add(title);
-    titles.push(title);
-    if (titles.length >= 6) break;
-  }
-  return {
-    layout: "agenda",
-    title: "Agenda",
-    bullets: titles.length > 0 ? titles : ["Context", "Findings", "Next steps"],
-    notes: ["Walk the agenda in under 30 seconds, then move on."],
-  };
-}
-
-function fitSlideCount(drafts: DraftSlide[], target: number, format: string): DraftSlide[] {
-  const working = drafts.map((draft) => ({ ...draft, bullets: [...draft.bullets], notes: [...draft.notes] }));
-
-  // Split dense slides while we still need more.
-  let guard = 0;
-  while (working.length < target && guard < 200) {
-    guard += 1;
-    let bestIndex = -1;
-    let bestCount = 4;
-    for (let i = 0; i < working.length; i += 1) {
-      if (working[i].layout === "quote") continue;
-      if (working[i].bullets.length > bestCount) {
-        bestCount = working[i].bullets.length;
-        bestIndex = i;
-      }
-    }
-    if (bestIndex === -1) break;
-    const slide = working[bestIndex];
-    const half = Math.ceil(slide.bullets.length / 2);
-    const continuation: DraftSlide = {
-      layout: slide.layout,
-      title: `${slide.title} (cont.)`,
-      bullets: slide.bullets.slice(half),
-      notes: slide.notes.slice(),
-    };
-    slide.bullets = slide.bullets.slice(0, half);
-    working.splice(bestIndex + 1, 0, continuation);
-  }
-
-  // Pad with format-aware closing sections.
-  const closers = FORMAT_CLOSERS[format] ?? FORMAT_CLOSERS.general;
-  let closerIndex = 0;
-  while (working.length < target) {
-    const closer = closers[closerIndex % closers.length];
-    const suffix = closerIndex >= closers.length ? ` ${Math.floor(closerIndex / closers.length) + 1}` : "";
-    working.push({
-      layout: "bullets",
-      title: `${closer.title}${suffix}`,
-      bullets: [...closer.bullets],
-      notes: ["Scaffold slide — replace with specifics before presenting."],
-    });
-    closerIndex += 1;
-  }
-
-  // Merge the lightest adjacent pair until we hit the target.
-  guard = 0;
-  while (working.length > target && working.length > 1 && guard < 500) {
-    guard += 1;
-    let bestIndex = 0;
-    let bestWeight = Number.POSITIVE_INFINITY;
-    for (let i = 0; i < working.length - 1; i += 1) {
-      const weight = working[i].bullets.length + working[i + 1].bullets.length;
-      if (weight < bestWeight) {
-        bestWeight = weight;
-        bestIndex = i;
-      }
-    }
-    const first = working[bestIndex];
-    const second = working[bestIndex + 1];
-    first.bullets = [...first.bullets, ...second.bullets].slice(0, 8);
-    first.notes = [...first.notes, ...second.notes];
-    if (first.layout === "quote") first.layout = "bullets";
-    working.splice(bestIndex + 1, 1);
-  }
-
-  return working;
-}
-
-function buildNotes(draft: DraftSlide, options: CliOptions, position: number, total: number): string {
-  const parts: string[] = [];
-  if (draft.notes.length > 0) {
-    parts.push(shorten(draft.notes.join(" "), 600));
-  } else if (draft.bullets.length > 0) {
-    parts.push(`Walk through: ${draft.bullets.slice(0, 3).join("; ")}.`);
-  }
-  parts.push(AUDIENCE_NOTE[options.audience] ?? AUDIENCE_NOTE.team);
-  parts.push(`Slide ${position} of ${total}. Target pace: about ${position === 1 ? 30 : 60} seconds.`);
-  return parts.join(" ");
-}
-
-export function buildSlides(
-  deckTitle: string,
-  drafts: DraftSlide[],
-  options: CliOptions,
-): Slide[] {
-  const bodyTarget = Math.max(1, options.slides - (options.slides >= 3 ? 2 : 1));
-  const fitted = fitSlideCount(drafts, Math.max(1, bodyTarget - (options.slides >= 4 ? 1 : 0)), options.format);
-
-  const assembled: DraftSlide[] = [
-    {
-      layout: "title",
-      title: deckTitle,
-      subtitle: `${titleCase(options.format)} deck for ${options.audience}`,
-      bullets: [],
-      notes: [`Open with why this matters to ${options.audience}.`],
-    },
-  ];
-
-  if (options.slides >= 4) assembled.push(agendaSlide(fitted));
-  assembled.push(...fitted);
-
-  if (options.slides >= 3) {
-    assembled.push({
-      layout: "closing",
-      title: "Thank you",
-      subtitle: "Questions and next steps",
-      bullets: ["Recap the ask", "Confirm owners and dates", "Share this deck and the source material"],
-      notes: ["Leave time for questions. Restate the single decision you need."],
-    });
-  }
-
-  const trimmed = assembled.slice(0, options.slides);
-
-  return trimmed.map((draft, index) => ({
-    index: index + 1,
-    layout: draft.layout,
-    title: draft.title,
-    subtitle: draft.subtitle,
-    bullets: draft.bullets,
-    notes: buildNotes(draft, options, index + 1, trimmed.length),
-  }));
-}
-
-/* -------------------------------------------------------------------------- */
-/* Renderers                                                                   */
-/* -------------------------------------------------------------------------- */
-
-