@hasna/skills 0.1.27 → 0.1.30

package/skills/pdf-to-markdown/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*.ts"]
+}

package/skills/performance-audit-report/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: performance-audit-report
+description: Generate premium performance audit reports for web apps, APIs, or SaaS surfaces with metrics, findings, budgets, remediation plans, and manifest metadata.
+---
+
+# Performance Audit Report
+
+Generate a performance audit package from a URL, repo notes, trace summary, or product brief. Hosted runs can gather richer measurements, while local direct execution produces deterministic artifacts for validation.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+
+## Usage
+
+```bash
+skills run performance-audit-report --target "https://skills.md" --app "Skills.md"
+skills run performance-audit-report --notes "Dashboard JS is 1.2MB and API p95 is 900ms" --surface web
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--target <url-or-path>` | App URL, route, repo path, or service name. | optional |
+| `--notes <text>` | Performance notes, metrics, trace summary, or constraints. Positional text also works. | optional |
+| `--app <text>` | Application or product name. | Performance Target |
+| `--surface <type>` | `web`, `api`, `mobile`, or `worker`. | web |
+| `--budget <profile>` | `strict`, `balanced`, or `growth`. | balanced |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `performance-audit-report.md`
+- `findings.csv`
+- `performance-budget.json`
+- `remediation-plan.md`
+- `metrics.json`
+- `manifest.json`
+
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

package/skills/performance-audit-report/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "performance-audit-report",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Hosted premium performance audit report generator",
+  "type": "module",
+  "bin": {
+    "performance-audit-report": "./src/index.ts"
+  }
+}

package/skills/persona-based-adwriter/src/index.ts

@@ -86,6 +86,24 @@ function slugify(value: string): string {
 }
 
 function parseOptions(): SkillOptions {
+  if (Bun.argv.includes("--help") || Bun.argv.includes("-h")) {
+    console.log(`persona-based-adwriter
+
+Usage:
+  skills run persona-based-adwriter -- <brief> [options]
+
+Options:
+  --brief <text>        Product or offer brief
+  --personas <list>     Semicolon-separated target personas
+  --channels <list>     Comma-separated channels
+  --offers <list>       Comma-separated offers
+  --tone <tone>         Copy tone
+  --format <format>     markdown or json
+  --model <model>       OpenAI model
+  --output <path>       Output file path`);
+    process.exit(0);
+  }
+
   const { values, positionals } = parseArgs({
     args: Bun.argv.slice(2),
     options: {
@@ -97,6 +115,7 @@ function parseOptions(): SkillOptions {
       format: { type: "string", default: "markdown" },
       model: { type: "string", default: "gpt-4o-mini" },
       output: { type: "string" },
+      help: { type: "boolean", short: "h" },
     },
     allowPositionals: true,
   });

package/skills/photo-album/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: photo-album
+description: Generate hosted themed photo albums with configurable image counts
+---
+
+# Photo Album
+
+Generate a hosted premium photo album around a theme, event, campaign, product, or concept. The hosted runtime creates a cohesive image set with configurable image count, style, aspect ratios, cover image, captions, gallery manifest, receipts, and downloadable assets.
+
+## Usage
+
+```
+skills run photo-album "autumn in Tokyo" --count 12 --style documentary
+skills run photo-album "startup office life" --count 21 --aspect-ratios "1:1,4:5"
+skills run photo-album "underwater coral reef exploration" --cover true
+```
+
+## Output
+
+- `album/` directory with high-quality images
+- `cover.png`
+- `captions.csv`
+- `gallery-manifest.json`
+- `receipt.json`
+
+## Requirements
+
+Hosted premium execution requires `SKILLS_API_KEY` or `skills auth login`.
+Provider keys stay server-side.

package/skills/photo-album/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "photo-album",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "bin": {
+    "photo-album": "./src/index.ts"
+  }
+}

package/skills/photo-album/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "../tsconfig.base.json",
+  "include": ["src"]
+}

package/skills/pitch-deck/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: pitch-deck
+description: Generate premium investor or sales pitch deck packages with PPTX, PDF, notes, and design direction.
+---
+
+# Pitch Deck
+
+Generate investor or sales deck packages from a short brief.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+
+## Usage
+
+```bash
+skills run pitch-deck --brief "AI support desk for Shopify merchants" --company "Acme" --audience investors
+skills run pitch-deck "Usage-based billing platform for AI SaaS" --slides 12 --tone bold
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--brief <text>` | Company, product, offer, or campaign brief. Positional text also works. | required |
+| `--company <name>` | Company or product name. | Company |
+| `--audience <type>` | `investors`, `sales`, or `internal`. | investors |
+| `--slides <number>` | Number of slides, 5-15. | 10 |
+| `--tone <tone>` | `concise`, `bold`, or `technical`. | concise |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `deck.md`
+- `deck.pdf`
+- `deck.pptx`
+- `slides.json`
+- `speaker-notes.md`
+- `design-direction.md`
+- `manifest.json`
+
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

package/skills/pitch-deck/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "pitch-deck",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "bin": {
+    "pitch-deck": "src/index.ts"
+  }
+}

package/skills/playlist-maker/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: playlist-maker
+description: Create a curated playlist with research, track selection, and AI-generated album art
+---
+
+# Playlist Maker
+
+Create a themed music playlist by researching artists and tracks, selecting 7 songs that fit the mood, and generating custom album artwork.
+
+## What it does
+
+1. Takes a theme, mood, or artist as input
+2. Searches the web for relevant tracks, reviews, and playlists
+3. Selects 7 tracks that form a cohesive listening experience
+4. Generates custom album art that captures the playlist vibe
+5. Outputs a structured playlist with track info and cover image
+
+## Usage
+
+```
+playlist-maker "late night jazz for coding"
+playlist-maker "90s hip hop summer vibes"
+playlist-maker "songs similar to Radiohead OK Computer"
+```
+
+## Output
+
+- `playlist.json` — structured playlist with track names, artists, and why each was chosen
+- `cover.png` — AI-generated album art for the playlist
+
+## Credits
+
+30 credits per playlist (web search + image generation).

package/skills/playlist-maker/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "playlist-maker",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "bin": {
+    "playlist-maker": "./src/index.ts"
+  }
+}

package/skills/playlist-maker/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "../tsconfig.base.json",
+  "include": ["src"]
+}

package/skills/product-mockup/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: product-mockup
+description: Generate premium product mockup packages with SVG visual variants, image direction prompts, scene planning, usage notes, asset metadata, and manifest.
+---
+
+# Product Mockup
+
+Generate a polished product mockup package for a SaaS product, app feature, launch campaign, or sales deck.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+
+## Usage
+
+```bash
+skills run product-mockup "Usage-based billing dashboard" --audience "founders" --variants 3
+skills run product-mockup --product "AI meeting assistant" --scene "homepage hero" --style "quiet premium"
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--product <text>` | Product, feature, or campaign description. Positional text also works. | required |
+| `--audience <text>` | Target audience. | software buyers |
+| `--scene <text>` | Desired context or surface. | SaaS marketing and product screens |
+| `--style <text>` | Visual direction. | polished SaaS, crisp product UI, restrained color |
+| `--variants <n>` | Number of mockup variants, 1-4. | 3 |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `mockup-brief.md`
+- `image-prompts.md`
+- `scene-plan.json`
+- `variants/variant-01.svg`
+- `variants/variant-02.svg`
+- `variants/variant-03.svg`
+- `usage-notes.md`
+- `asset-metadata.json`
+- `manifest.json`
+
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

package/skills/product-mockup/package.json

@@ -1,27 +1,10 @@
 {
   "name": "product-mockup",
   "version": "0.1.0",
-  "description": "Product Mockup skill",
+  "private": true,
+  "description": "Hosted premium product mockup artifact generator",
   "type": "module",
   "bin": {
     "product-mockup": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "src",
-    "tsconfig.json"
-  ]
+  }
 }

package/skills/product-mockup/tsconfig.json

@@ -1,10 +1,8 @@
 {
   "extends": "../tsconfig.base.json",
   "compilerOptions": {
-    "outDir": "dist"
+    "outDir": "./dist",
+    "rootDir": "./src"
   },
-  "include": [
-    "src/**/*",
-    "bin/**/*"
-  ]
+  "include": ["src/**/*"]
 }

package/skills/project-retro-companion/src/index.ts

@@ -109,6 +109,24 @@ function parseJsonTemplate(content: string): RetroTemplate | undefined {
 }
 
 function parseOptions(): SkillOptions {
+  if (Bun.argv.includes("--help") || Bun.argv.includes("-h")) {
+    console.log(`project-retro-companion
+
+Usage:
+  skills run project-retro-companion -- --text <feedback> [options]
+
+Options:
+  --text <feedback>   Retro notes or feedback
+  --cadence <value>   Sprint, monthly, quarterly
+  --team <name>       Team name
+  --focus <area>      process, delivery, collaboration, quality, or all
+  --history <text>    Prior retro context
+  --format <format>   markdown or json
+  --model <model>     OpenAI model
+  --output <path>     Output file path`);
+    process.exit(0);
+  }
+
   const { values, positionals } = parseArgs({
     args: Bun.argv.slice(2),
     options: {
@@ -120,6 +138,7 @@ function parseOptions(): SkillOptions {
       format: { type: "string", default: "markdown" },
       model: { type: "string", default: "gpt-4o-mini" },
       output: { type: "string" },
+      help: { type: "boolean", short: "h" },
     },
     allowPositionals: true,
   });

package/skills/proposal-pack/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: proposal-pack
+description: Generate premium client proposal packages with proposal, SOW, pricing, timeline, assumptions, cover email, Markdown, and PDF artifacts.
+---
+
+# Proposal Pack
+
+Generate a client-ready proposal package for agencies, consultants, SaaS services, and implementation teams.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+
+## Usage
+
+```bash
+skills run proposal-pack --client "Acme" --project "AI onboarding workflow" --budget "25k USD" --timeline "6 weeks"
+skills run proposal-pack "Revamp the customer onboarding portal" --services "Discovery,Design,Build,Training"
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--project <text>` | Project scope or proposal brief. Positional text also works. | required |
+| `--client <name>` | Client or account name. | Client |
+| `--budget <text>` | Budget range or fixed price. | To be confirmed |
+| `--timeline <text>` | Delivery timeline. | 4-6 weeks |
+| `--services <list>` | Comma-separated services or workstreams. | discovery, implementation, enablement |
+| `--tone <tone>` | `executive`, `friendly`, or `technical`. | executive |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `proposal.md`
+- `proposal.pdf`
+- `statement-of-work.md`
+- `pricing.csv`
+- `timeline.csv`
+- `assumptions.md`
+- `cover-email.md`
+- `manifest.json`
+
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

package/skills/proposal-pack/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "proposal-pack",
+  "version": "0.1.0",
+  "description": "Generate client proposal packages through the hosted Skills runtime",
+  "type": "module",
+  "bin": {
+    "proposal-pack": "src/index.ts"
+  },
+  "dependencies": {}
+}

package/skills/read-pdf/SKILL.md

@@ -16,19 +16,20 @@ Analyze a PDF with Claude's native document support and return structured output
 
 ## Requirements
 
-- `ANTHROPIC_API_KEY` must be available in the environment
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only `SKILL.md`.
 
 ## Usage
 
 ```bash
 # Read the whole PDF with markdown output
-read-pdf --input ./deck.pdf
+skills run read-pdf -- --input ./deck.pdf
 
 # Restrict to a few pages
-read-pdf --input ./contract.pdf --pages 1-3,8 --format text
+skills run read-pdf -- --input ./contract.pdf --pages 1-3,8 --format text
 
 # Ask for specific structure and save it
-read-pdf \
+skills run read-pdf -- \
   --input ./invoice.pdf \
   --prompt "Extract invoice metadata, every line item, and the payment terms." \
   --format json \

package/skills/repo-onboarding-report/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: repo-onboarding-report
+description: Generate premium repository onboarding reports with architecture maps, setup guides, first-week plans, code inventory, risk register, and manifest metadata.
+---
+
+# Repo Onboarding Report
+
+Generate a practical onboarding package for a software repository so a new engineer or agent can understand the codebase, setup path, architecture, risks, and first useful tasks quickly.
+
+## Requirements
+
+- Authenticate with `skills auth login`.
+- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+
+## Usage
+
+```bash
+skills run repo-onboarding-report --target ./my-app --name "Acme Web App" --stack "Next.js SaaS"
+skills run repo-onboarding-report --target . --focus "architecture,setup,testing,risks"
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--target <path>` | Repository directory to inspect. | current directory |
+| `--name <text>` | Project name used in report titles. | package name or folder name |
+| `--stack <text>` | Stack or product context. | inferred from repository files |
+| `--focus <list>` | Comma-separated focus areas. | architecture,setup,testing,risks,first-week |
+| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+
+## Outputs
+
+- `repo-onboarding-report.md`
+- `architecture-map.md`
+- `setup-quickstart.md`
+- `first-week-plan.md`
+- `code-inventory.json`
+- `risk-register.json`
+- `manifest.json`
+
+After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.

package/skills/repo-onboarding-report/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "repo-onboarding-report",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Hosted premium repository onboarding report generator",
+  "type": "module",
+  "bin": {
+    "repo-onboarding-report": "./src/index.ts"
+  }
+}

package/skills/sales-call-recapper/src/index.ts

@@ -110,6 +110,25 @@ function parseJsonTemplate(content: string): RecapTemplate | undefined {
 }
 
 function parseOptions(): SkillOptions {
+  if (Bun.argv.includes("--help") || Bun.argv.includes("-h")) {
+    console.log(`sales-call-recapper
+
+Usage:
+  skills run sales-call-recapper -- --text <notes> [options]
+
+Options:
+  --text <notes>      Sales call notes or transcript
+  --account <name>    Account name
+  --contact <name>    Contact name
+  --stage <stage>     Deal stage
+  --tone <tone>       professional, friendly, or concise
+  --cta <text>        Call to action
+  --format <format>   markdown or json
+  --model <model>     OpenAI model
+  --output <path>     Output file path`);
+    process.exit(0);
+  }
+
   const { values, positionals } = parseArgs({
     args: Bun.argv.slice(2),
     options: {
@@ -122,6 +141,7 @@ function parseOptions(): SkillOptions {
       format: { type: "string", default: "markdown" },
       model: { type: "string", default: "gpt-4o-mini" },
       output: { type: "string" },
+      help: { type: "boolean", short: "h" },
     },
     allowPositionals: true,
   });

package/skills/salescopy/package.json

@@ -4,7 +4,7 @@
   "description": "Sales copy generator using AI",
   "type": "module",
   "bin": {
-    "salescopy": "./bin/cli.ts"
+    "salescopygenerate": "src/index.ts"
   },
   "scripts": {
     "start": "bun run bin/cli.ts",

package/skills/salescopy/src/index.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+
+console.log("Usage: skills run salescopy -- <command> [options]");