@hasna/skills 0.1.60 → 0.1.61

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

@@ -0,0 +1,114 @@
+export type Layout = "title" | "agenda" | "bullets" | "section" | "quote" | "closing";
+
+export interface Slide {
+  index: number;
+  layout: Layout;
+  title: string;
+  subtitle?: string;
+  bullets: string[];
+  notes: string;
+}
+
+export interface Theme {
+  name: string;
+  label: string;
+  background: string;
+  surface: string;
+  text: string;
+  muted: string;
+  accent: string;
+  accentText: string;
+  headingFont: string;
+  bodyFont: string;
+  mood: string;
+}
+
+export interface CliOptions {
+  brief?: string;
+  source?: string;
+  title?: string;
+  audience: string;
+  format: string;
+  slides: number;
+  theme: string;
+  output: string;
+  json: boolean;
+  noPptx: boolean;
+}
+
+/* -------------------------------------------------------------------------- */
+/* Themes                                                                      */
+/* -------------------------------------------------------------------------- */
+
+export const THEMES: Record<string, Theme> = {
+  midnight: {
+    name: "midnight",
+    label: "Midnight",
+    background: "0B1020",
+    surface: "151B33",
+    text: "F5F7FF",
+    muted: "9AA6C8",
+    accent: "6E8BFF",
+    accentText: "0B1020",
+    headingFont: "Georgia, 'Times New Roman', serif",
+    bodyFont: "'Helvetica Neue', Helvetica, Arial, sans-serif",
+    mood: "High-contrast dark deck for keynotes and product launches.",
+  },
+  aurora: {
+    name: "aurora",
+    label: "Aurora",
+    background: "0E1F1C",
+    surface: "13302A",
+    text: "EAFFF7",
+    muted: "8FC4B2",
+    accent: "35D6A4",
+    accentText: "07120F",
+    headingFont: "'Trebuchet MS', 'Segoe UI', sans-serif",
+    bodyFont: "'Helvetica Neue', Helvetica, Arial, sans-serif",
+    mood: "Fresh dark-green deck for growth, sustainability, and roadmap reviews.",
+  },
+  sandstone: {
+    name: "sandstone",
+    label: "Sandstone",
+    background: "FBF7F0",
+    surface: "F2EAD9",
+    text: "2A2318",
+    muted: "7A6A52",
+    accent: "C1682C",
+    accentText: "FFF8EF",
+    headingFont: "Georgia, 'Times New Roman', serif",
+    bodyFont: "'Helvetica Neue', Helvetica, Arial, sans-serif",
+    mood: "Warm light deck for workshops, training, and long-form reports.",
+  },
+  ocean: {
+    name: "ocean",
+    label: "Ocean",
+    background: "F4F9FC",
+    surface: "E3EFF7",
+    text: "0C2233",
+    muted: "5A778C",
+    accent: "0F6FA8",
+    accentText: "FFFFFF",
+    headingFont: "'Segoe UI', 'Helvetica Neue', Arial, sans-serif",
+    bodyFont: "'Segoe UI', 'Helvetica Neue', Arial, sans-serif",
+    mood: "Calm light-blue deck for status updates and customer-facing reviews.",
+  },
+  mono: {
+    name: "mono",
+    label: "Mono",
+    background: "FFFFFF",
+    surface: "F1F1F1",
+    text: "111111",
+    muted: "666666",
+    accent: "111111",
+    accentText: "FFFFFF",
+    headingFont: "'Helvetica Neue', Helvetica, Arial, sans-serif",
+    bodyFont: "'Helvetica Neue', Helvetica, Arial, sans-serif",
+    mood: "Neutral black-and-white deck that prints and photocopies cleanly.",
+  },
+};
+
+export const AUDIENCES = ["team", "customers", "executives", "students"];
+export const FORMATS = ["general", "training", "sales", "report", "proposal"];
+
+

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

@@ -0,0 +1,53 @@
+export function stripInlineMarkdown(value: string): string {
+  return value
+    .replace(/!\[([^\]]*)\]\([^)]*\)/g, "$1")
+    .replace(/\[([^\]]+)\]\([^)]*\)/g, "$1")
+    .replace(/`{1,3}([^`]+)`{1,3}/g, "$1")
+    .replace(/\*\*([^*]+)\*\*/g, "$1")
+    .replace(/__([^_]+)__/g, "$1")
+    .replace(/(^|\s)\*([^*]+)\*/g, "$1$2")
+    .replace(/(^|\s)_([^_]+)_/g, "$1$2")
+    .replace(/^\s*[-*+]\s+/, "")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+export function titleCase(value: string): string {
+  const cleaned = value.trim().replace(/[.:;,]+$/, "");
+  if (!cleaned) return "Untitled";
+  return cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
+}
+
+export function splitSentences(text: string): string[] {
+  return text
+    .replace(/\s+/g, " ")
+    .split(/(?<=[.!?])\s+(?=[A-Z0-9"'(])/)
+    .map((sentence) => sentence.trim())
+    .filter(Boolean);
+}
+
+export function shorten(value: string, max: number): string {
+  const trimmed = value.trim();
+  if (trimmed.length <= max) return trimmed;
+  const cut = trimmed.slice(0, max);
+  const lastSpace = cut.lastIndexOf(" ");
+  return `${(lastSpace > max * 0.5 ? cut.slice(0, lastSpace) : cut).replace(/[,;:.\-\s]+$/, "")}…`;
+}
+
+export function headlineFrom(sentence: string): string {
+  const stripped = stripInlineMarkdown(sentence).replace(/^(the|a|an)\s+/i, "");
+  const words = stripped.split(" ").slice(0, 8).join(" ");
+  return titleCase(shorten(words, 60));
+}
+
+export function chunk<T>(items: T[], size: number): T[][] {
+  const out: T[][] = [];
+  for (let i = 0; i < items.length; i += size) out.push(items.slice(i, i + size));
+  return out;
+}
+
+/* -------------------------------------------------------------------------- */
+/* Slide model construction                                                    */
+/* -------------------------------------------------------------------------- */
+
+

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

@@ -0,0 +1,17 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "ESNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "resolveJsonModule": true,
+    "noEmit": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/skills/social-content-calendar/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: social-content-calendar
-description: Generate premium social content calendars with daily posts, channel strategy, asset briefs, publishing schedule, and repurposing map.
+description: Generate social content calendars with daily posts, channel strategy, asset briefs, publishing schedule, and repurposing map.
+kind: instruction
 ---
 
 # Social Content Calendar
@@ -9,29 +10,26 @@ Generate a 14 to 45 day campaign calendar for launch, nurture, hiring, community
 
 ## Requirements
 
-- Authenticate with `skills auth login`.
-- This premium skill runs through the hosted Skills runtime; local installs expose only skill metadata and instructions.
+None. This is an instruction skill: it is prose an agent follows, so it needs no
+credentials, no network access, and no local runtime.
 
 ## Usage
 
-```bash
-skills run social-content-calendar "Usage-based billing for AI SaaS" --audience "founders" --days 30
-skills run social-content-calendar --campaign "API monitoring launch" --channels "LinkedIn,X,Newsletter" --tone technical
-```
+Ask an agent for the deliverables below and give it the inputs. Reading this file
+IS the invocation; `skills run` refuses instruction skills on purpose.
 
-## Options
+## Inputs
 
-| Option | Description | Default |
+| Input | Description | Default |
 |--------|-------------|---------|
-| `--campaign <text>` | Campaign, product, or content brief. Positional text also works. | required |
-| `--audience <text>` | Target segment. | software teams |
-| `--goal <text>` | Campaign goal. | build qualified demand |
-| `--days <n>` | Calendar length, 14-45 days. | 30 |
-| `--channels <list>` | Comma-separated channels. | LinkedIn, X, Newsletter |
-| `--tone <tone>` | `direct`, `premium`, `friendly`, or `technical`. | direct |
-| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+| `campaign` | Campaign, product, or content brief. Positional text also works. | required |
+| `audience` | Target segment. | software teams |
+| `goal` | Campaign goal. | build qualified demand |
+| `days` | Calendar length, 14-45 days. | 30 |
+| `channels` | Comma-separated channels. | LinkedIn, X, Newsletter |
+| `tone` | `direct`, `premium`, `friendly`, or `technical`. | direct |
 
-## Outputs
+## Deliverables
 
 - `calendar.md`
 - `posts.csv`
@@ -42,4 +40,15 @@ skills run social-content-calendar --campaign "API monitoring launch" --channels
 - `repurposing-map.md`
 - `manifest.json`
 
-After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.
+## Method
+
+1. Fix the campaign goal and the two or three content pillars everything maps to.
+2. Adapt per channel rather than cross-posting: length, format and tone differ,
+   and an unadapted post reads as spam on at least one network.
+3. Write the hook as the first line, because on most networks it is the only line
+   guaranteed to be read.
+4. Schedule with real dates from the requested start, and balance the pillars
+   across the week rather than batching them.
+5. Build the repurposing map explicitly: which long-form asset each post derives
+   from, so production cost stays bounded.
+6. Include asset briefs for anything needing design, with dimensions per channel.

package/skills/social-content-calendar/package.json

@@ -5,7 +5,6 @@
   "description": "Hosted premium social content calendar artifact generator",
   "type": "module",
   "skills": {
-    "runtime": "hosted",
-    "source": "remote"
+    "kind": "instruction"
   }
 }

package/skills/split-pdf/src/index.ts

@@ -248,7 +248,7 @@ async function splitPdf(): Promise<void> {
     }
 
     // Set metadata
-    newPdf.setCreator("skills.md split-pdf");
+    newPdf.setCreator("split-pdf skill");
     newPdf.setProducer("pdf-lib");
 
     // Generate output path

package/skills/test-suite-generator/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: test-suite-generator
-description: Generate premium API, unit, and browser test suite packages with runnable tests and coverage notes.
+description: Generate API, unit, and browser test suite packages with runnable tests and coverage notes.
+kind: instruction
 ---
 
 # Test Suite Generator
@@ -9,27 +10,24 @@ Generate a test package for SaaS apps from routes, specs, or user flows.
 
 ## Requirements
 
-- Authenticate with `skills auth login`.
-- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+None. This is an instruction skill: it is prose an agent follows, so it needs no
+credentials, no network access, and no local runtime.
 
 ## Usage
 
-```bash
-skills run test-suite-generator --spec "POST /api/projects, GET /api/projects/:id" --framework "Next.js" --runner "bun"
-skills run test-suite-generator "signup, checkout, billing success" --include-browser
-```
+Ask an agent for the deliverables below and give it the inputs. Reading this file
+IS the invocation; `skills run` refuses instruction skills on purpose.
 
-## Options
+## Inputs
 
-| Option | Description | Default |
+| Input | Description | Default |
 |--------|-------------|---------|
-| `--spec <text>` | Routes, specs, or user flows. Positional text also works. | required |
-| `--framework <name>` | Application framework. | generic SaaS app |
-| `--runner <name>` | Test runner style: `bun`, `vitest`, or `playwright`. | bun |
-| `--include-browser` | Include browser flow tests. | false |
-| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+| `spec` | Routes, specs, or user flows. Positional text also works. | required |
+| `framework` | Application framework. | generic SaaS app |
+| `runner` | Test runner style: `bun`, `vitest`, or `playwright`. | bun |
+| `include-browser` | Include browser flow tests. | false |
 
-## Outputs
+## Deliverables
 
 - `tests/api.test.ts`
 - `tests/unit.test.ts`
@@ -38,4 +36,16 @@ skills run test-suite-generator "signup, checkout, billing success" --include-br
 - `coverage-notes.md`
 - `manifest.json`
 
-After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.
+## Method
+
+1. Turn the natural-language spec into an explicit list of behaviours with their
+   expected outcomes before writing any test code.
+2. Cover the boundaries first — empty, maximum, malformed, unauthorized,
+   concurrent. Happy-path-only suites give false confidence.
+3. Write assertions against observable behaviour, not implementation detail, so
+   the suite survives refactoring.
+4. Keep tests independent and order-agnostic; shared mutable fixtures are the
+   most common source of flakiness.
+5. Match the project's existing framework and conventions — detect them from the
+   repo rather than imposing your own.
+6. Note explicitly what you did NOT cover and why, so the gaps are visible.

package/skills/test-suite-generator/package.json

@@ -2,10 +2,9 @@
   "name": "test-suite-generator",
   "version": "0.1.0",
   "private": true,
-  "description": "Generate runnable SaaS test suite artifacts through the hosted Skills runtime",
+  "description": "Generate runnable SaaS test suite artifacts",
   "type": "module",
   "skills": {
-    "runtime": "hosted",
-    "source": "remote"
+    "kind": "instruction"
   }
 }