@hasna/skills 0.1.60 → 0.1.62

package/skills/{convert → invoice-reconciliation}/tsconfig.json

@@ -3,7 +3,9 @@
   "compilerOptions": {
     "module": "ESNext",
     "outDir": "./dist",
-    "rootDir": "./src"
+    "rootDir": "./src",
+    "resolveJsonModule": true,
+    "noEmit": true
   },
   "include": [
     "src/**/*"

package/skills/landing-page-pack/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: landing-page-pack
-description: Generate premium landing page copy, wireframes, CTA maps, experiments, and preview artifacts.
+description: Generate landing page copy, wireframes, CTA maps, experiments, and preview artifacts.
+kind: instruction
 ---
 
 # Landing Page Pack
@@ -9,30 +10,27 @@ Generate a conversion-focused landing page package for a product, service, or of
 
 ## 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 landing-page-pack "Usage-based billing for AI SaaS" --audience "founders" --goal "book demos"
-skills run landing-page-pack --product "API monitoring" --offer "Find broken API workflows before customers do"
-```
+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 |
 |--------|-------------|---------|
-| `--product <text>` | Product, service, or campaign brief. Positional text also works. | required |
-| `--audience <text>` | Primary buyer or user segment. | software teams |
-| `--offer <text>` | Core offer or promise. | derived from product |
-| `--goal <text>` | Main conversion goal. | book demos |
-| `--tone <tone>` | `direct`, `premium`, `friendly`, or `technical`. | direct |
-| `--proof <text>` | Proof points, metrics, or trust signals. | case studies and testimonials |
-| `--sections <list>` | Comma-separated section names. | hero, problem, solution, proof, faq, cta |
-| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+| `product` | Product, service, or campaign brief. Positional text also works. | required |
+| `audience` | Primary buyer or user segment. | software teams |
+| `offer` | Core offer or promise. | derived from product |
+| `goal` | Main conversion goal. | book demos |
+| `tone` | `direct`, `premium`, `friendly`, or `technical`. | direct |
+| `proof` | Proof points, metrics, or trust signals. | case studies and testimonials |
+| `sections` | Comma-separated section names. | hero, problem, solution, proof, faq, cta |
 
-## Outputs
+## Deliverables
 
 - `landing-page.md`
 - `copy-blocks.json`
@@ -44,4 +42,14 @@ skills run landing-page-pack --product "API monitoring" --offer "Find broken API
 - `implementation-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. Lead with the offer: who it is for, what changes for them, and why now.
+2. Write the hero before anything else. If the hero does not work, no section
+   below it will rescue the page.
+3. Order sections by the objections a real buyer raises, in the order they raise
+   them. Do not follow a template order by default.
+4. Make proof specific — named customers, real numbers, concrete screenshots.
+   Generic testimonials reduce credibility rather than adding to it.
+5. Keep one primary CTA, repeated; secondary CTAs must be visibly subordinate.
+6. Propose experiments as hypotheses with a metric and a decision rule.

package/skills/landing-page-pack/package.json

@@ -5,7 +5,6 @@
   "description": "Hosted premium landing page copy and conversion artifact generator",
   "type": "module",
   "skills": {
-    "runtime": "hosted",
-    "source": "remote"
+    "kind": "instruction"
   }
 }

package/skills/logo-design/SKILL.md

@@ -1,51 +1,94 @@
 ---
 name: logo-design
-description: Generate premium multi-variant logo packages with transparent PNG exports, vector-style SVGs, usage notes, and a manifest.
+description: Generate multi-variant geometric logo marks as SVG, with horizontal lockups, concept notes, usage guidelines, and a manifest. Runs entirely offline and deterministically from a text brief.
 ---
 
 # Logo Design
 
-Generate professional logo concepts from a text brief. Hosted runs return a downloadable brand exploration package.
+Compose parametric geometric logo marks locally. The brief, brand name, style,
+and palette are hashed into a master seed; every shape, rotation, grid cell, and
+color role is derived from that seed. The same inputs always produce
+byte-identical SVGs, so a concept you like can be regenerated exactly.
+
+There is no image model in this skill and no network call. If you want a
+generative-art or illustrative mark, use this skill for the geometric system and
+hand the written brief in `logo-brief.md` to your own image tool.
 
 ## Requirements
 
-- Authenticate with `skills auth login`.
-- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+- Bun (the skill runs as `bun run src/index.ts`).
+- No API keys, no network access, no environment variables.
+- Optional: `sharp` for `--png` raster exports. It is declared as an optional
+  dependency, so `bun install` will try to add it but will not fail without it.
+  If `sharp` is missing, `--png` prints a clear notice and the SVG outputs are
+  still written. Install it explicitly with `bun add sharp` in this directory.
 
 ## Usage
 
 ```bash
-skills run logo-design --brief "minimal geometric owl mark for a developer tool" --brand "Acme"
-skills run logo-design "coffee shop logo, vintage badge, warm tones" --variations 4
+# three concepts with the default palette
+skills run logo-design -- --brief "minimal geometric owl mark for a developer tool" --brand "Acme"
+
+# positional brief, custom hex palette, four variations
+skills run logo-design -- "vintage badge for a coffee roaster" --brand "Ember" --palette "#2B1B12,cream,rust" -n 4
+
+# write somewhere specific and rasterize
+skills run logo-design -- --brief "ledger app" --brand "Ledgerly" --output ./out/ledgerly --png --png-size 1024
+
+# machine-readable summary
+skills run logo-design -- --brief "mesh networking" --brand "Relay" --json
 ```
 
+Run it directly from the skill directory with `bun run src/index.ts --help`.
+
 ## Options
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `--brief <text>` | Logo brief. Positional text also works. | required |
-| `--brand <name>` | Brand or product name. | Brand |
-| `--style <text>` | Visual style direction. | clean vector mark |
-| `--palette <list>` | Comma-separated color direction. | navy,white,accent |
-| `--variations <n>` | Number of logo concepts, 1-6. | 3 |
-| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+| `--brief <text>`, `-b` | Logo brief. A positional string also works. | required |
+| `--brand <name>` | Brand or product name. Drives the monogram and the lockup wordmark. | `Brand` |
+| `--style <text>` | Style direction. Recorded in the brief and used as the lockup tagline. | `clean geometric mark` |
+| `--palette <list>` | Comma-separated colors. Accepts hex (`#1B2A4A`, `#abc`) and ~35 named colors (`navy`, `rust`, `mint`). Unknown words are hashed into a stable derived hue. | `navy,white,accent` |
+| `--variations <1-6>`, `-n` | Number of concepts. | `3` |
+| `--output <dir>`, `-o` | Output directory. | `./logo-design` |
+| `--background` | Draw a solid backdrop rect inside each SVG. | off (transparent) |
+| `--png` | Also rasterize each mark to PNG. Requires `sharp`. | off |
+| `--png-size <px>` | PNG width and height. | `512` |
+| `--json` | Print the run summary as JSON on stdout. | off |
+| `--help` | Show help and exit 0. | |
+| `--version` | Print the version. | |
 
 ## Outputs
 
-- `transparent/logo-*.png`
-- `vector/logo-*.svg`
-- `concepts.json`
-- `logo-brief.md`
-- `usage-notes.md`
-- `manifest.json`
+| File | Contents |
+|------|----------|
+| `vector/logo-NN.svg` | Standalone mark on a 256x256 viewBox, transparent by default, with `<title>`/`<desc>` for accessibility. |
+| `vector/logo-NN-lockup.svg` | 720x200 horizontal lockup: mark, wordmark, and the style line as a tagline. |
+| `png/logo-NN.png` | Raster export, only when `--png` is set and `sharp` is available. |
+| `concepts.json` | Per-variant seed, geometry name, description, palette roles, rationale. |
+| `logo-brief.md` | The brief as interpreted, the resolved palette table, and the reproducibility note. |
+| `usage-notes.md` | Clear space, minimum sizes, color roles, do / don't. |
+| `manifest.json` | Every file written, with byte sizes and the run inputs. |
+
+## Geometry system
+
+Eight parametric constructions are available; the seed shuffles them and the
+first `--variations` are used, so no two variants in a package repeat.
 
-## Logo Design Tips
+| Construction | What it draws |
+|--------------|---------------|
+| `monogram` | Brand initials knocked out of a circle, squircle, hexagon, or shield, with an accent underline. |
+| `glyph-grid` | 3x3 or 4x4 modular grid of squares, circles, and triangles, mirrored across the vertical axis. |
+| `orbit` | Open ring with a seeded aperture, an accent core, and a satellite dot on the ring path. |
+| `chevron-stack` | Three to four nested chevrons reading as motion or ascent. |
+| `prism` | Two rotated equilateral triangles with a translucent intersection. |
+| `aperture` | Five to seven rotating blades around a hollow center. |
+| `layer-stack` | Three sheared parallelograms reading as stacked planes. |
+| `arc-mark` | Alternating half-arcs of even stroke weight. |
 
-1. **Be specific**: "minimalist geometric owl logo, flat vector, navy and gold, white background" beats "owl logo"
-2. **Specify style**: flat vector, 3D, vintage, modern, hand-drawn, geometric, abstract
-3. **Request white/solid background**: Prevents complex backgrounds bleeding into the mark
-4. **Keep it simple**: Logos must work at favicon size (16x16). Ask for clean, minimal designs
-5. **Skip text in the logo**: Generators struggle with typography. Generate the icon, add text in Illustrator/Figma
-6. **Generate many variations**: Run 4-10 variations with slight prompt tweaks, pick the best
+## Notes on picking a direction
 
-After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.
+1. Judge the mark at 16 px first. Open `vector/logo-01.svg` in a browser and zoom out.
+2. Keep the mark and the wordmark separable — the lockup is a convenience, not the identity.
+3. Change one input at a time (`--palette`, then `--style`) so you can attribute what improved.
+4. Record the seed from `concepts.json` when you find a keeper; it is the only thing needed to reproduce it.

package/skills/logo-design/package.json

@@ -2,10 +2,34 @@
   "name": "logo-design",
   "version": "0.1.0",
   "private": true,
-  "description": "Hosted skill metadata for logo-design",
+  "description": "Generate deterministic geometric logo marks as SVG, with lockups, concept notes, and a manifest",
   "type": "module",
-  "skills": {
-    "runtime": "hosted",
-    "source": "remote"
+  "main": "src/index.ts",
+  "bin": {
+    "logo-design": "src/index.ts"
+  },
+  "files": [
+    "src",
+    "SKILL.md",
+    "tsconfig.json"
+  ],
+  "keywords": [
+    "logo",
+    "svg",
+    "branding",
+    "generator",
+    "skill"
+  ],
+  "scripts": {
+    "start": "bun run src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "optionalDependencies": {
+    "sharp": "^0.33.5"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
   }
 }

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

@@ -0,0 +1,132 @@
+import { VERSION } from "./constants.js";
+import { normalizeHex } from "./palette.js";
+import type { CliOptions } from "./types.js";
+
+function printHelp(): void {
+  console.log(`logo-design v${VERSION}
+
+Generate deterministic geometric logo marks as SVG. No network access and no
+API keys: every mark is composed locally from a hash of your brief, so the same
+inputs always produce the same output.
+
+USAGE:
+  logo-design --brief <text> [options]
+  logo-design "<brief text>" [options]
+
+OPTIONS:
+  -b, --brief <text>        Logo brief (positional text also works)   [required]
+      --brand <name>        Brand or product name                     [Brand]
+      --style <text>        Style direction, recorded in the brief    [clean geometric mark]
+      --palette <list>      Comma-separated colors: names or hex      [navy,white,accent]
+  -n, --variations <1-6>    Number of concepts to generate            [3]
+  -o, --output <dir>        Output directory                          [./logo-design]
+      --background          Draw a solid backdrop rect in each SVG    [off, transparent]
+      --png                 Also rasterize PNGs (requires sharp)      [off]
+      --png-size <px>       PNG width/height when --png is used       [512]
+      --json                Print the run summary as JSON
+      --help                Show this help message
+      --version             Show the current version
+
+OUTPUTS:
+  vector/logo-NN.svg        Standalone mark, 256x256 viewBox
+  vector/logo-NN-lockup.svg Horizontal mark + wordmark lockup
+  png/logo-NN.png           Optional raster export (--png)
+  concepts.json             Per-variant seed, geometry, palette, rationale
+  logo-brief.md             The brief as interpreted by this run
+  usage-notes.md            Clear space, minimum sizes, do / don't
+  manifest.json             Every file written, with byte sizes
+
+EXAMPLES:
+  logo-design --brief "minimal geometric owl mark for a developer tool" --brand Acme
+  logo-design "vintage badge for a coffee roaster" --palette "#2B1B12,cream,rust" -n 4
+  logo-design --brief "ledger app" --brand Ledgerly --png --png-size 1024
+`);
+}
+
+export function parseArgs(argv: string[]): CliOptions {
+  const options: CliOptions = {
+    brand: "Brand",
+    style: "clean geometric mark",
+    palette: "navy,white,accent",
+    variations: 3,
+    output: "./logo-design",
+    png: false,
+    pngSize: 512,
+    background: false,
+    json: 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 "--brand":
+        options.brand = argv[++i] ?? options.brand;
+        break;
+      case "--style":
+        options.style = argv[++i] ?? options.style;
+        break;
+      case "--palette":
+        options.palette = argv[++i] ?? options.palette;
+        break;
+      case "--variations":
+      case "-n": {
+        const value = Number.parseInt(argv[++i] ?? "", 10);
+        if (!Number.isFinite(value) || value < 1 || value > 6) {
+          throw new Error(`Invalid --variations value: ${argv[i]} (expected 1-6)`);
+        }
+        options.variations = value;
+        break;
+      }
+      case "--output":
+      case "-o":
+        options.output = argv[++i] ?? options.output;
+        break;
+      case "--background":
+        options.background = true;
+        break;
+      case "--png":
+        options.png = true;
+        break;
+      case "--png-size": {
+        const value = Number.parseInt(argv[++i] ?? "", 10);
+        if (!Number.isFinite(value) || value < 16 || value > 4096) {
+          throw new Error(`Invalid --png-size value: ${argv[i]} (expected 16-4096)`);
+        }
+        options.pngSize = value;
+        break;
+      }
+      case "--json":
+        options.json = true;
+        break;
+      default:
+        if (arg.startsWith("-")) {
+          throw new Error(`Unknown option: ${arg}`);
+        }
+        if (!options.brief) {
+          options.brief = arg;
+          break;
+        }
+        throw new Error(`Unexpected argument: ${arg}`);
+    }
+  }
+
+  if (!options.brief || options.brief.trim() === "") {
+    throw new Error("Missing required --brief <text> argument (a positional brief also works)");
+  }
+
+  return options;
+}
+
+

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

@@ -0,0 +1,5 @@
+export const VERSION = "0.1.0";
+export const CANVAS = 256;
+export const MARGIN = 32;
+export const SAFE = CANVAS - MARGIN * 2;
+

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

@@ -0,0 +1,102 @@
+import type { CliOptions, Concept, Palette } from "./types.js";
+
+export function usageNotes(brand: string, palette: Palette, concepts: Concept[]): string {
+  return `# ${brand} logo usage notes
+
+Generated by the \`logo-design\` skill. Every mark in this package is a plain SVG
+you can open in Figma, Illustrator, Inkscape, or any browser.
+
+## Clear space
+
+Reserve clear space equal to **25% of the mark height** (64 units on the 256 unit
+artboard) on all four sides. Nothing — type, rules, photography, other logos —
+enters that zone.
+
+## Minimum sizes
+
+| Context | Minimum width | Which file |
+|---------|---------------|------------|
+| Favicon / app icon | 16 px | \`vector/logo-01.svg\` (mark only) |
+| UI chrome, avatars | 24 px | mark only |
+| Print, business card | 12 mm | mark only |
+| Horizontal lockup | 120 px | \`vector/logo-01-lockup.svg\` |
+
+Below 120 px the wordmark in the lockup stops being legible. Drop to the mark.
+
+## Color
+
+| Role | Hex |
+|------|-----|
+| Primary | \`${palette.primary}\` |
+| Secondary | \`${palette.secondary}\` |
+| Accent | \`${palette.accent}\` |
+| Background | \`${palette.background}\` |
+
+The SVGs ship with a transparent background by default. Re-run with
+\`--background\` if you need a baked-in backdrop rect.
+
+## Do
+
+- Use the supplied SVG. It scales losslessly and stays crisp on any display.
+- Keep the mark on backgrounds that hold a contrast ratio of at least 3:1
+  against \`${palette.primary}\`.
+- Scale the whole group proportionally.
+
+## Don't
+
+- Don't recolor individual shapes ad hoc — swap the palette and regenerate.
+- Don't rotate, skew, or add drop shadows, bevels, or outlines.
+- Don't reflow the lockup: the mark stays left of the wordmark at the supplied
+  spacing.
+- Don't place the mark over busy photography without a solid or scrimmed plate.
+
+## Concepts in this package
+
+${concepts
+  .map((concept) => `- **${concept.id}** (\`${concept.geometry}\`, seed \`${concept.seed}\`) — ${concept.description}`)
+  .join("\n")}
+`;
+}
+
+export function briefDoc(options: CliOptions, palette: Palette, seed: number, concepts: Concept[]): string {
+  return `# Logo brief — ${options.brand}
+
+- **Brief**: ${options.brief}
+- **Brand**: ${options.brand}
+- **Style direction**: ${options.style}
+- **Palette request**: ${palette.requested.join(", ")}
+- **Master seed**: \`${seed}\` (derived from brief + brand + style + palette)
+- **Variations**: ${options.variations}
+
+## Resolved palette
+
+| Token | Hex | Origin |
+|-------|-----|--------|
+${palette.resolved.map((entry) => `| ${entry.token} | \`${entry.hex}\` | ${entry.origin} |`).join("\n")}
+
+Roles: primary \`${palette.primary}\`, secondary \`${palette.secondary}\`, accent \`${palette.accent}\`, background \`${palette.background}\`.
+
+## Concepts
+
+${concepts
+  .map(
+    (concept) => `### ${concept.id} — ${concept.geometry}
+
+${concept.description}
+
+- Seed: \`${concept.seed}\`
+- Mark: \`${concept.markFile}\`
+- Lockup: \`${concept.lockupFile}\`
+- Rationale: ${concept.rationale}`,
+  )
+  .join("\n\n")}
+
+## Reproducibility
+
+This package is deterministic. Running the same command with the same
+\`--brief\`, \`--brand\`, \`--style\`, and \`--palette\` regenerates byte-identical
+SVGs. Change any one of them to explore a different direction.
+`;
+}
+
+