@hasna/skills 0.1.59 → 0.1.61

package/skills/logo-design/src/palette.ts

@@ -0,0 +1,258 @@
+import type { Palette } from "./types.js";
+
+export function fnv1a(input: string): number {
+  let hash = 0x811c9dc5;
+  for (let i = 0; i < input.length; i += 1) {
+    hash ^= input.charCodeAt(i);
+    hash = Math.imul(hash, 0x01000193) >>> 0;
+  }
+  return hash >>> 0;
+}
+
+export function mulberry32(seed: number): () => number {
+  let a = seed >>> 0;
+  return () => {
+    a = (a + 0x6d2b79f5) >>> 0;
+    let t = a;
+    t = Math.imul(t ^ (t >>> 15), t | 1);
+    t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+  };
+}
+
+export function pick<T>(rng: () => number, items: readonly T[]): T {
+  return items[Math.floor(rng() * items.length) % items.length];
+}
+
+export function shuffle<T>(rng: () => number, items: readonly T[]): T[] {
+  const copy = [...items];
+  for (let i = copy.length - 1; i > 0; i -= 1) {
+    const j = Math.floor(rng() * (i + 1));
+    [copy[i], copy[j]] = [copy[j], copy[i]];
+  }
+  return copy;
+}
+
+/* ------------------------------------------------------------------ */
+/* color                                                               */
+/* ------------------------------------------------------------------ */
+
+const NAMED_COLORS: Record<string, string> = {
+  amber: "#D98324",
+  black: "#0B0B0F",
+  bone: "#F3EFE7",
+  charcoal: "#22262B",
+  coral: "#E4644B",
+  cream: "#FBF7EF",
+  crimson: "#B3243C",
+  emerald: "#1F8A5B",
+  forest: "#1E4634",
+  gold: "#C9A227",
+  graphite: "#3A3F44",
+  indigo: "#3A3D98",
+  ink: "#101418",
+  ivory: "#FDFCF7",
+  lavender: "#8E86C9",
+  lime: "#7FB800",
+  magenta: "#B5177E",
+  mint: "#4FBF9F",
+  navy: "#1B2A4A",
+  ocean: "#12566B",
+  olive: "#6B7233",
+  orange: "#E2761B",
+  plum: "#63305C",
+  purple: "#5B2A86",
+  red: "#C0392B",
+  rose: "#D96A8A",
+  rust: "#9C4221",
+  sand: "#DDCBA4",
+  sky: "#2E86C1",
+  slate: "#4A5568",
+  steel: "#5B6C7F",
+  teal: "#0F7B7B",
+  violet: "#6C4AB6",
+  white: "#FFFFFF",
+};
+
+function clamp(value: number, min: number, max: number): number {
+  return Math.min(max, Math.max(min, value));
+}
+
+function hslToHex(h: number, s: number, l: number): string {
+  const hue = ((h % 360) + 360) % 360;
+  const sat = clamp(s, 0, 1);
+  const lit = clamp(l, 0, 1);
+  const c = (1 - Math.abs(2 * lit - 1)) * sat;
+  const x = c * (1 - Math.abs(((hue / 60) % 2) - 1));
+  const m = lit - c / 2;
+  let rgb: [number, number, number];
+  if (hue < 60) rgb = [c, x, 0];
+  else if (hue < 120) rgb = [x, c, 0];
+  else if (hue < 180) rgb = [0, c, x];
+  else if (hue < 240) rgb = [0, x, c];
+  else if (hue < 300) rgb = [x, 0, c];
+  else rgb = [c, 0, x];
+  const toHex = (v: number) =>
+    Math.round((v + m) * 255)
+      .toString(16)
+      .padStart(2, "0")
+      .toUpperCase();
+  return `#${toHex(rgb[0])}${toHex(rgb[1])}${toHex(rgb[2])}`;
+}
+
+function hexToRgb(hex: string): [number, number, number] {
+  const value = hex.replace("#", "");
+  const full =
+    value.length === 3
+      ? value
+          .split("")
+          .map((c) => c + c)
+          .join("")
+      : value;
+  return [
+    Number.parseInt(full.slice(0, 2), 16),
+    Number.parseInt(full.slice(2, 4), 16),
+    Number.parseInt(full.slice(4, 6), 16),
+  ];
+}
+
+function relativeLuminance(hex: string): number {
+  const [r, g, b] = hexToRgb(hex).map((channel) => {
+    const c = channel / 255;
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+  });
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+
+function chroma(hex: string): number {
+  const [r, g, b] = hexToRgb(hex);
+  return (Math.max(r, g, b) - Math.min(r, g, b)) / 255;
+}
+
+function hueOf(hex: string): number {
+  const [r, g, b] = hexToRgb(hex).map((c) => c / 255);
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  const delta = max - min;
+  if (delta === 0) return 0;
+  let hue: number;
+  if (max === r) hue = ((g - b) / delta) % 6;
+  else if (max === g) hue = (b - r) / delta + 2;
+  else hue = (r - g) / delta + 4;
+  return (hue * 60 + 360) % 360;
+}
+
+export function normalizeHex(token: string): string | null {
+  const match = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(token.trim());
+  if (!match) return null;
+  const body = match[1];
+  const full =
+    body.length === 3
+      ? body
+          .split("")
+          .map((c) => c + c)
+          .join("")
+      : body;
+  return `#${full.toUpperCase()}`;
+}
+
+function resolveColorToken(token: string, seed: number, index: number): Palette["resolved"][number] {
+  const trimmed = token.trim();
+  const asHex = normalizeHex(trimmed);
+  if (asHex) return { token: trimmed, hex: asHex, origin: "hex" };
+  const named = NAMED_COLORS[trimmed.toLowerCase()];
+  if (named) return { token: trimmed, hex: named, origin: "named" };
+  const localSeed = fnv1a(`${seed}:${trimmed.toLowerCase()}:${index}`);
+  const hue = localSeed % 360;
+  const sat = 0.52 + ((localSeed >>> 9) % 26) / 100;
+  const light = 0.38 + ((localSeed >>> 17) % 22) / 100;
+  return { token: trimmed, hex: hslToHex(hue, sat, light), origin: "derived" };
+}
+
+export function buildPalette(tokens: string[], seed: number): Palette {
+  const resolved = tokens.map((token, index) => resolveColorToken(token, seed, index));
+  const byLuminance = [...resolved].sort((a, b) => relativeLuminance(a.hex) - relativeLuminance(b.hex));
+  const darkest = byLuminance[0].hex;
+  const lightest = byLuminance[byLuminance.length - 1].hex;
+
+  const background = relativeLuminance(lightest) > 0.7 ? lightest : "#FFFFFF";
+  const primary = darkest;
+
+  const accentCandidates = resolved
+    .filter((entry) => entry.hex !== primary && entry.hex !== background)
+    .sort((a, b) => chroma(b.hex) - chroma(a.hex));
+  const accent =
+    accentCandidates.length > 0 && chroma(accentCandidates[0].hex) > 0.12
+      ? accentCandidates[0].hex
+      : hslToHex(hueOf(primary) + 152, 0.62, 0.54);
+
+  const secondaryCandidates = resolved
+    .map((entry) => entry.hex)
+    .filter((hex) => hex !== primary && hex !== background && hex !== accent);
+  const secondary = secondaryCandidates[0] ?? hslToHex(hueOf(primary), 0.24, 0.42);
+
+  return {
+    primary,
+    secondary,
+    accent,
+    background,
+    requested: tokens,
+    resolved,
+  };
+}
+
+/* ------------------------------------------------------------------ */
+/* svg helpers                                                         */
+/* ------------------------------------------------------------------ */
+
+export function xmlEscape(value: string): string {
+  return value.replace(/[&<>"']/g, (char) => {
+    switch (char) {
+      case "&":
+        return "&amp;";
+      case "<":
+        return "&lt;";
+      case ">":
+        return "&gt;";
+      case '"':
+        return "&quot;";
+      default:
+        return "&apos;";
+    }
+  });
+}
+
+export const FONT_STACK =
+  "'Inter','Helvetica Neue',Helvetica,'Segoe UI',Arial,'DejaVu Sans',sans-serif";
+
+export function round(value: number): number {
+  return Math.round(value * 100) / 100;
+}
+
+export function polygonPoints(cx: number, cy: number, radius: number, sides: number, rotation: number): string {
+  const points: string[] = [];
+  for (let i = 0; i < sides; i += 1) {
+    const angle = rotation + (i * 2 * Math.PI) / sides;
+    points.push(`${round(cx + radius * Math.cos(angle))},${round(cy + radius * Math.sin(angle))}`);
+  }
+  return points.join(" ");
+}
+
+export function initialsOf(brand: string): string {
+  const words = brand
+    .split(/[^\p{L}\p{N}]+/u)
+    .filter(Boolean)
+    .slice(0, 2);
+  if (words.length === 0) return "A";
+  if (words.length === 1) {
+    const word = words[0];
+    return (word.length > 1 ? word.slice(0, 2) : word).toUpperCase();
+  }
+  return words.map((word) => word[0]).join("").toUpperCase();
+}
+
+/* ------------------------------------------------------------------ */
+/* geometry generators                                                 */
+/* ------------------------------------------------------------------ */
+
+

package/skills/logo-design/src/types.ts

@@ -0,0 +1,50 @@
+export interface CliOptions {
+  brief?: string;
+  brand: string;
+  style: string;
+  palette: string;
+  variations: number;
+  output: string;
+  png: boolean;
+  pngSize: number;
+  background: boolean;
+  json: boolean;
+}
+
+export interface Palette {
+  primary: string;
+  secondary: string;
+  accent: string;
+  background: string;
+  requested: string[];
+  resolved: Array<{ token: string; hex: string; origin: "named" | "hex" | "derived" }>;
+}
+
+export interface Concept {
+  id: string;
+  index: number;
+  seed: number;
+  geometry: string;
+  description: string;
+  markFile: string;
+  lockupFile: string;
+  pngFile?: string;
+  palette: { primary: string; secondary: string; accent: string; background: string };
+  rationale: string;
+}
+
+/* ------------------------------------------------------------------ */
+/* deterministic randomness                                            */
+/* ------------------------------------------------------------------ */
+
+export interface GeometryContext {
+  rng: () => number;
+  palette: Palette;
+  brand: string;
+}
+
+export interface Geometry {
+  name: string;
+  build: (ctx: GeometryContext) => { body: string; description: string };
+}
+

package/skills/logo-design/tsconfig.json

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

package/skills/market-research-report/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: market-research-report
-description: Generate a premium market research report with competitor, audience, pricing, source, Markdown, and PDF artifacts.
+description: Generate a market research report with competitor, audience, pricing, source, Markdown, and PDF artifacts.
+kind: instruction
 ---
 
 # Market Research Report
@@ -9,33 +10,42 @@ Generate a market research report package for SaaS, developer tools, and busines
 
 ## 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 market-research-report --topic "AI developer tools" --audience "SaaS founders" --competitors "Cursor,Copilot,Replit"
-skills run market-research-report "B2B onboarding analytics" --region "US/EU" --format strategic
-```
+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 |
 |--------|-------------|---------|
-| `--topic <text>` | Market, product category, or research question. Positional text also works. | required |
-| `--audience <text>` | Target audience or buyer segment. | Operators and founders |
-| `--competitors <list>` | Comma-separated competitor names. | inferred examples |
-| `--region <text>` | Geographic or commercial scope. | Global |
-| `--format <format>` | `strategic`, `investor`, or `product`. | strategic |
-| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+| `topic` | Market, product category, or research question. Positional text also works. | required |
+| `audience` | Target audience or buyer segment. | Operators and founders |
+| `competitors` | Comma-separated competitor names. | inferred examples |
+| `region` | Geographic or commercial scope. | Global |
+| `format` | `strategic`, `investor`, or `product`. | strategic |
 
-## Outputs
+## Deliverables
 
 - `market-research-report.md`
-- `market-research-report.pdf`
 - `competitors.csv`
 - `sources.json`
 - `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. State the question, the market boundary, and the date. A market report without
+   an explicit as-of date decays silently.
+2. Map competitors by the dimension that actually differentiates them, not by
+   feature checklist. Say what each one is genuinely best at.
+3. Segment the audience by job-to-be-done and note which segments are underserved.
+4. Analyse pricing as packaging: what is metered, what is gated, where the
+   upgrade pressure sits.
+5. Separate what you verified from what you inferred, and record every source
+   with its URL and access date. Use your own web tools or sources the user
+   supplied; do not invent citations.
+6. Close with the two or three findings that would change a decision, and say
+   what evidence would falsify each.

package/skills/market-research-report/package.json

@@ -2,10 +2,9 @@
   "name": "market-research-report",
   "version": "0.1.0",
   "private": true,
-  "description": "Generate market research report artifacts through the hosted Skills runtime",
+  "description": "Generate market research report artifacts",
   "type": "module",
   "skills": {
-    "runtime": "hosted",
-    "source": "remote"
+    "kind": "instruction"
   }
 }

package/skills/meeting-pack/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: meeting-pack
-description: Generate premium meeting artifact packs from transcripts or notes with summaries, decisions, action items, owner/deadline tables, follow-up email, project export, timeline, and manifest metadata.
+description: Generate meeting artifact packs from transcripts or notes with summaries, decisions, action items, owner/deadline tables, follow-up email, project export, timeline, and manifest metadata.
+kind: instruction
 ---
 
 # Meeting Pack
@@ -9,28 +10,25 @@ Generate a complete meeting artifact package from transcripts, notes, call summa
 
 ## 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 meeting-pack --notes "Discussed billing launch, docs, and support owner follow-ups" --meeting "Billing Launch Sync"
-skills run meeting-pack ./transcript.txt --participants "Hasna,Alex,Sam" --format executive
-```
+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 |
 |--------|-------------|---------|
-| `--notes <text>` | Meeting transcript, rough notes, or summary. Positional text also works. | required unless `--source` is used |
-| `--source <path>` | Read notes or transcript from a file. | none |
-| `--meeting <text>` | Meeting title. | Meeting |
-| `--participants <list>` | Comma-separated participant names. | Team |
-| `--format <type>` | `project`, `executive`, `sales`, or `standup`. | project |
-| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+| `notes` | Meeting transcript, rough notes, or summary. Positional text also works. | required unless `--source` is used |
+| `source` | Read notes or transcript from a file. | none |
+| `meeting` | Meeting title. | Meeting |
+| `participants` | Comma-separated participant names. | Team |
+| `format` | `project`, `executive`, `sales`, or `standup`. | project |
 
-## Outputs
+## Deliverables
 
 - `meeting-summary.md`
 - `decisions.md`
@@ -40,4 +38,15 @@ skills run meeting-pack ./transcript.txt --participants "Hasna,Alex,Sam" --forma
 - `timeline.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. Read the transcript fully before summarizing; decisions are often reversed
+   later in the same meeting.
+2. Separate decisions from discussion. A decision has an owner and a resolution;
+   everything else is context.
+3. Extract action items with owner, deadline, and the acceptance condition. An
+   action item without an owner will not happen.
+4. Flag anything explicitly deferred, and anything raised but never resolved —
+   the second category is what meetings routinely lose.
+5. Build the timeline from what was said, not from what you expect the process to be.
+6. Draft the follow-up email so a non-attendee can act on it without the transcript.

package/skills/meeting-pack/package.json

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

package/skills/merge-pdfs/src/index.ts

@@ -351,7 +351,7 @@ async function mergePdfs(fileSpecs: FileSpec[]): Promise<void> {
   if (options.author) {
     mergedPdf.setAuthor(options.author);
   }
-  mergedPdf.setCreator("skills.md merge-pdfs");
+  mergedPdf.setCreator("merge-pdfs skill");
   mergedPdf.setProducer("pdf-lib");
   mergedPdf.setCreationDate(new Date());
   mergedPdf.setModificationDate(new Date());

package/skills/migration-plan-pack/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: migration-plan-pack
-description: Generate premium migration planning packs for framework, library, database, infrastructure, or architecture upgrades with risk matrix, checklist, rollout plan, and test strategy.
+description: Generate migration planning packs for framework, library, database, infrastructure, or architecture upgrades with risk matrix, checklist, rollout plan, and test strategy.
+kind: instruction
 ---
 
 # Migration Plan Pack
@@ -9,30 +10,27 @@ Generate a migration package from current state, target state, system context, a
 
 ## 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 migration-plan-pack --system "Acme SaaS" --from "Next.js 14, Postgres 14" --to "Next.js 16, Postgres 16"
-skills run migration-plan-pack --from "single-region worker" --to "multi-region worker" --constraints "no downtime, preserve RLS"
-```
+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 |
 |--------|-------------|---------|
-| `--system <text>` | Product, repo, app, or service being migrated. | Migration Target |
-| `--from <text>` | Current framework, library, database, infrastructure, or architecture state. | current state |
-| `--to <text>` | Desired target state. | target state |
-| `--scope <list>` | Comma-separated systems or workstreams in scope. | app, data, deploy, tests |
-| `--constraints <text>` | Risk, downtime, compliance, billing, or operational constraints. | optional |
-| `--deadline <text>` | Date, release train, or migration window. | optional |
-| `--strategy <type>` | `phased`, `big-bang`, or `parallel-run`. | phased |
-| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+| `system` | Product, repo, app, or service being migrated. | Migration Target |
+| `from` | Current framework, library, database, infrastructure, or architecture state. | current state |
+| `to` | Desired target state. | target state |
+| `scope` | Comma-separated systems or workstreams in scope. | app, data, deploy, tests |
+| `constraints` | Risk, downtime, compliance, billing, or operational constraints. | optional |
+| `deadline` | Date, release train, or migration window. | optional |
+| `strategy` | `phased`, `big-bang`, or `parallel-run`. | phased |
 
-## Outputs
+## Deliverables
 
 - `migration-plan.md`
 - `risk-matrix.csv`
@@ -42,4 +40,17 @@ skills run migration-plan-pack --from "single-region worker" --to "multi-region
 - `rollout-plan.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. Establish the from/to states precisely, including versions, and list what is
+   explicitly out of scope.
+2. Map dependencies before sequencing. The order is forced by the dependency
+   graph, not by preference.
+3. Identify the irreversible steps. These dominate the plan: everything else can
+   be retried.
+4. Build the risk matrix with a concrete mitigation and a rollback for each row.
+   "Monitor closely" is not a mitigation.
+5. Define the cutover checklist as ordered, individually verifiable steps with an
+   explicit go/no-go gate.
+6. Specify the test strategy per phase, including how you prove parity between
+   old and new rather than merely that the new one starts.

package/skills/migration-plan-pack/package.json

@@ -5,7 +5,6 @@
   "description": "Hosted premium migration planning pack generator",
   "type": "module",
   "skills": {
-    "runtime": "hosted",
-    "source": "remote"
+    "kind": "instruction"
   }
 }