@hasna/skills 0.1.59 → 0.1.61

package/skills/brand-assets/src/types.ts

@@ -0,0 +1,59 @@
+export interface CliOptions {
+  url?: string;
+  output: string;
+  timeout: number;
+  maxAssets: number;
+  download: boolean;
+  json: boolean;
+}
+
+export interface AssetCandidate {
+  role: string;
+  sourceUrl: string;
+  attributes: Record<string, string>;
+}
+
+export interface DownloadedAsset {
+  role: string;
+  file: string | null;
+  sourceUrl: string;
+  contentType: string | null;
+  bytes: number | null;
+  status: "downloaded" | "skipped" | "failed";
+  note?: string;
+  attributes: Record<string, string>;
+}
+
+export type ColorKind = "meta" | "manifest" | "custom-property" | "declaration";
+
+export interface ColorHit {
+  hex: string;
+  raw: string;
+  name: string;
+  kind: ColorKind;
+  foundIn: string;
+}
+
+export interface FontHit {
+  stack: string;
+  families: string[];
+  property: string;
+  foundIn: string;
+}
+
+/* ------------------------------------------------------------------ */
+/* deps                                                                */
+/* ------------------------------------------------------------------ */
+
+export type HtmlNode = {
+  getAttribute(name: string): string | undefined;
+  removeAttribute?(name: string): void;
+  text: string;
+  rawText: string;
+  toString(): string;
+  querySelectorAll(selector: string): HtmlNode[];
+  querySelector(selector: string): HtmlNode | null;
+  tagName?: string;
+  attributes: Record<string, string>;
+};
+

package/skills/brand-kit/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: brand-kit
-description: Generate premium brand kits with logo usage, palette, typography, brand voice, sample applications, Markdown guide, and PDF guide.
+description: Generate brand kits with logo usage, palette, typography, brand voice, sample applications, Markdown guide, and PDF guide.
+kind: instruction
 ---
 
 # Brand Kit
@@ -9,31 +10,27 @@ Generate a production-ready brand guide package for a startup, product, internal
 
 ## 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 brand-kit "Usage-based billing for AI SaaS" --audience "founders" --personality "precise, calm, pragmatic"
-skills run brand-kit --brand "Acme Ledger" --category "developer tools" --tone premium
-```
+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 |
 |--------|-------------|---------|
-| `--brand <text>` | Brand, product, or company name. Positional text also works. | required |
-| `--category <text>` | Market category or product type. | software product |
-| `--audience <text>` | Primary audience. | software teams |
-| `--personality <text>` | Brand personality words. | clear, capable, direct |
-| `--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 |
+| `brand` | Brand, product, or company name. Positional text also works. | required |
+| `category` | Market category or product type. | software product |
+| `audience` | Primary audience. | software teams |
+| `personality` | Brand personality words. | clear, capable, direct |
+| `tone` | `direct`, `premium`, `friendly`, or `technical`. | direct |
 
-## Outputs
+## Deliverables
 
 - `brand-guide.md`
-- `brand-guide.pdf`
 - `palette.json`
 - `typography.md`
 - `voice-guide.md`
@@ -42,4 +39,16 @@ skills run brand-kit --brand "Acme Ledger" --category "developer tools" --tone p
 - `brand-assets.svg`
 - `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 positioning first — audience, category, and the one adjective the
+   brand must own. Every later choice is judged against it.
+2. Build the palette with roles, not just hex values: primary, surface, text,
+   accent, semantic states. Record contrast ratios for text pairs.
+3. Choose type by role (display, body, mono) with fallbacks, and give a scale.
+4. Write voice as do/don't pairs with example sentences; adjectives alone are
+   not actionable.
+5. Specify logo usage: clear space, minimum size, permitted and forbidden
+   treatments, and behaviour on light and dark backgrounds.
+6. Show the system applied to at least two real surfaces (a landing hero, a
+   social card) so the rules are demonstrated rather than asserted.

package/skills/brand-kit/package.json

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

package/skills/compress-video/SKILL.md

@@ -2,7 +2,7 @@
 name: compress-video
 version: 0.1.0
 description: Compress videos while preserving quality using FFmpeg with multiple codec options and preset configurations
-author: skills.md
+author: Hasna
 category: Design & Creative
 tags:
   - video

package/skills/contract-review-report/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: contract-review-report
-description: Generate premium contract review reports with clause summaries, risk register, negotiation points, redline-style suggestions, counterparty email draft, and manifest metadata.
+description: Generate contract review reports with clause summaries, risk register, negotiation points, redline-style suggestions, counterparty email draft, and manifest metadata.
+kind: instruction
 ---
 
 # Contract Review Report
@@ -9,29 +10,26 @@ Generate a structured contract review package from an agreement, terms sheet, st
 
 ## 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 contract-review-report --source ./msa.txt --party "Acme" --counterparty "VendorCo"
-skills run contract-review-report --contract "Termination requires 90 days notice..." --focus "privacy,liability,payment"
-```
+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 |
 |--------|-------------|---------|
-| `--contract <text>` | Contract text. Positional text also works. | required unless `--source` is used |
-| `--source <path>` | Read contract text from a file. | none |
-| `--party <text>` | Your company or client name. | Our company |
-| `--counterparty <text>` | Other party name. | Counterparty |
-| `--jurisdiction <text>` | Governing context for notes. | Not specified |
-| `--focus <list>` | Comma-separated focus areas. | liability,payment,termination,privacy |
-| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+| `contract` | Contract text. Positional text also works. | required unless `--source` is used |
+| `source` | Read contract text from a file. | none |
+| `party` | Your company or client name. | Our company |
+| `counterparty` | Other party name. | Counterparty |
+| `jurisdiction` | Governing context for notes. | Not specified |
+| `focus` | Comma-separated focus areas. | liability,payment,termination,privacy |
 
-## Outputs
+## Deliverables
 
 - `contract-review-report.md`
 - `risk-register.csv`
@@ -40,4 +38,15 @@ skills run contract-review-report --contract "Termination requires 90 days notic
 - `negotiation-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>`.
+## Method
+
+1. Read the whole agreement before commenting on any clause; obligations are
+   frequently defined in one section and modified in another.
+2. Build a clause inventory: what it says, in plain language, per section.
+3. Score each risk on likelihood and impact, and say which party it favours.
+   A risk register with no counterparty attribution is not useful.
+4. Draft redlines as concrete replacement wording, not "consider revising".
+5. Separate deal-breakers from negotiable points, and rank the negotiables.
+6. Write the negotiation email so it opens with agreement, raises the top three
+   items only, and proposes specific alternatives.
+7. State clearly that this is not legal advice and name what a lawyer must review.

package/skills/contract-review-report/package.json

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

package/skills/customer-feedback-report/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: customer-feedback-report
-description: Generate premium customer feedback reports from reviews, support tickets, surveys, call notes, or raw feedback with clusters, sentiment, root causes, roadmap recommendations, evidence, and manifest metadata.
+description: Generate customer feedback reports from reviews, support tickets, surveys, call notes, or raw feedback with clusters, sentiment, root causes, roadmap recommendations, evidence, and manifest metadata.
+kind: instruction
 ---
 
 # Customer Feedback Report
@@ -9,36 +10,43 @@ Generate a structured customer feedback insight package from reviews, support ti
 
 ## 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 customer-feedback-report --feedback "Users love onboarding but struggle with invoices and integrations" --product "Skills.md"
-skills run customer-feedback-report ./feedback.txt --product "Acme CRM" --channel tickets --format product
-```
+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 |
 |--------|-------------|---------|
-| `--feedback <text>` | Raw feedback text. Positional text also works. | required unless `--source` is used |
-| `--source <path>` | Read feedback text from a file. | none |
-| `--product <text>` | Product, service, or workflow name. | Product |
-| `--segment <text>` | Customer segment or audience. | All customers |
-| `--channel <type>` | `reviews`, `tickets`, `calls`, `surveys`, or `mixed`. | mixed |
-| `--format <type>` | `product`, `support`, or `executive`. | product |
-| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+| `feedback` | Raw feedback text. Positional text also works. | required unless `--source` is used |
+| `source` | Read feedback text from a file. | none |
+| `product` | Product, service, or workflow name. | Product |
+| `segment` | Customer segment or audience. | All customers |
+| `channel` | `reviews`, `tickets`, `calls`, `surveys`, or `mixed`. | mixed |
+| `format` | `product`, `support`, or `executive`. | product |
 
-## Outputs
+## Deliverables
 
 - `customer-feedback-report.md`
-- `customer-feedback-report.pdf`
 - `feedback-clusters.csv`
 - `roadmap-suggestions.md`
 - `sentiment-summary.json`
 - `evidence.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. Normalize the raw feedback: dedupe, drop empty entries, and record the total
+   you actually analysed versus what you were given.
+2. Cluster by underlying problem, not by keyword — "slow" and "times out" are
+   often one cluster; "slow" and "sluggish onboarding" are often two.
+3. Size each cluster and cite two or three verbatim quotes per cluster. A cluster
+   without quotes cannot be checked.
+4. Assign sentiment per cluster and note where sentiment and volume disagree.
+5. For each top cluster, separate the reported symptom from your inferred root
+   cause, and mark the inference as an inference.
+6. Turn the top clusters into roadmap candidates with an effort/impact call.

package/skills/customer-feedback-report/package.json

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

package/skills/email-sequence/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: email-sequence
-description: Generate premium email campaigns with subject lines, preview text, body copy, segmentation notes, CTA variants, and HTML exports.
+description: Generate email campaigns with subject lines, preview text, body copy, segmentation notes, CTA variants, and HTML exports.
+kind: instruction
 ---
 
 # Email Sequence
@@ -9,28 +10,25 @@ Generate a 5 to 10 email campaign package for launch, nurture, onboarding, or re
 
 ## 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 email-sequence "Usage-based billing for AI SaaS" --audience "founders" --goal "book demos"
-skills run email-sequence --campaign "API monitoring launch" --emails 7 --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 offer brief. Positional text also works. | required |
-| `--audience <text>` | Target segment. | software teams |
-| `--goal <text>` | Conversion goal. | book demos |
-| `--emails <n>` | Number of emails, 5-10. | 5 |
-| `--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 offer brief. Positional text also works. | required |
+| `audience` | Target segment. | software teams |
+| `goal` | Conversion goal. | book demos |
+| `emails` | Number of emails, 5-10. | 5 |
+| `tone` | `direct`, `premium`, `friendly`, or `technical`. | direct |
 
-## Outputs
+## Deliverables
 
 - `sequence.md`
 - `emails/email-XX.md`
@@ -41,4 +39,15 @@ skills run email-sequence --campaign "API monitoring launch" --emails 7 --tone t
 - `send-plan.csv`
 - `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 sequence goal and the single action each email drives, then map the
+   arc across the whole sequence before writing any email.
+2. Write subject lines and preview text as a pair — preview text that repeats the
+   subject wastes the strongest real estate in the inbox.
+3. Keep one idea per email. If an email needs two CTAs, it is two emails.
+4. Vary structure across the sequence (story, proof, objection, direct offer) so
+   it does not read as one message sent five times.
+5. Add segmentation notes: who should be excluded, and what behaviour triggers
+   the next send.
+6. Provide plain-text alongside HTML; many recipients will only see the former.

package/skills/email-sequence/package.json

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

package/skills/generate-sitemap/src/index.ts

@@ -524,7 +524,7 @@ async function generateSitemap(
   console.log("   1. Upload sitemap to your website root");
   console.log("   2. Submit to search engines (Google Search Console, Bing Webmaster)");
   console.log("   3. Add sitemap location to robots.txt:");
-  console.log(`      Sitemap: https://your-domain.com/${basename(outputPath)}`);
+  console.log(`      Sitemap: https://example.com/${basename(outputPath)}`);
 }
 
 // ============================================================================

package/skills/invoice-reconciliation/SKILL.md

@@ -1,42 +1,98 @@
 ---
 name: invoice-reconciliation
-description: Generate premium invoice reconciliation reports from invoice, payment, purchase order, or CSV/XLSX-style exports with matches, discrepancies, anomaly notes, summaries, and manifest metadata.
+description: Reconcile invoice and payment CSV exports into matched rows, short/over payments, duplicates, unpaid invoices, orphan payments, anomaly notes, and per-bucket totals.
 ---
 
 # Invoice Reconciliation
 
-Generate a reconciliation package from invoice and payment exports. The hosted run produces matched rows, discrepancy tables, anomaly notes, and a management-ready report.
+Join an invoice CSV against a payment CSV on invoice id and classify every row.
+Everything runs locally and deterministically: no network calls, no credentials,
+no model calls. The judgement calls (are two payments instalments or a genuine
+duplicate?) are surfaced as anomalies for a human or agent to decide.
+
+## What It Does
+
+- Detects the id, amount, date, and counterparty columns in each CSV, tolerating naming variation (`invoice_id` / `Invoice Number` / `ref`, `amount` / `Amount Due` / `total`, `date` / `paid_at` / `Issue Date`).
+- Matches invoice ids case- and whitespace-insensitively (`INV-1006 ` matches `inv-1006`).
+- Parses money robustly: `$`, `€`, thousands separators, `1.234,56` European decimals, and `(1,234.00)` negatives.
+- Classifies each invoice into `matched`, `short-paid`, `over-paid`, `duplicate-payment`, `unpaid-invoice`, or `orphan-payment` (payment with no invoice).
+- Sums multiple payments per invoice and flags identical payment rows (same amount and date).
+- Reports counts, invoiced, paid, and difference totals per bucket, plus a match rate.
 
 ## Requirements
 
-- Authenticate with `skills auth login`.
-- This premium skill runs through the hosted Skills runtime; local installs expose only metadata and instructions.
+- [Bun](https://bun.sh) 1.x
+- npm dependencies: `csv-parse`, `csv-stringify` (install once with `bun install` in this skill directory)
+- Two CSV files: one with invoice rows, one with payment rows. Each needs an invoice id column and an amount column; date and counterparty columns are optional.
 
 ## Usage
 
 ```bash
-skills run invoice-reconciliation --invoices ./invoices.csv --payments ./payments.csv --company "Acme"
-skills run invoice-reconciliation --data "invoice_id,customer,amount,status\nINV-1,Acme,1200,open" --currency USD
+# Default reconciliation into ./reconciliation
+skills run invoice-reconciliation -- --invoices ./invoices.csv --payments ./payments.csv
+
+# Allow a 1.00 rounding tolerance and label amounts in EUR
+skills run invoice-reconciliation -- --invoices ./invoices.csv --payments ./payments.csv \
+  --tolerance 1 --currency EUR --output ./out/june-close
+
+# Machine-readable summary (buckets, totals, anomalies) on stdout
+skills run invoice-reconciliation -- --invoices ./invoices.csv --payments ./payments.csv --json
 ```
 
+Run it directly from the skill directory with
+`bun run src/index.ts --invoices ./invoices.csv --payments ./payments.csv`.
+
 ## Options
 
 | Option | Description | Default |
 |--------|-------------|---------|
-| `--invoices <path>` | CSV export with invoice rows. | optional |
-| `--payments <path>` | CSV export with payment rows. | optional |
-| `--data <text>` | Inline invoice/payment CSV-style data. Positional text also works. | optional |
-| `--company <text>` | Company or finance workspace name. | Company |
-| `--currency <code>` | Currency code for output amounts. | USD |
-| `--output <dir>` | Output directory for direct local execution. Hosted runs use the run export directory. | run export dir |
+| `-i, --invoices <path>` | CSV export with invoice rows | required |
+| `-p, --payments <path>` | CSV export with payment rows | required |
+| `-o, --output <dir>` | Output directory | `./reconciliation` |
+| `-t, --tolerance <n>` | Absolute amount difference still counted as matched | `0.01` |
+| `-c, --currency <code>` | Currency label used in the summary | `USD` |
+| `--json` | Print the summary (with anomalies) as JSON on stdout | off |
+| `--help` | Show usage | |
+| `--version` | Show version | |
+
+## Classification Rules
+
+| Status | Meaning |
+|--------|---------|
+| `matched` | Exactly one payment and `abs(paid - invoiced) <= tolerance` |
+| `short-paid` | Paid less than invoiced beyond the tolerance |
+| `over-paid` | Paid more than invoiced beyond the tolerance |
+| `duplicate-payment` | Two or more payment rows share the invoice id |
+| `unpaid-invoice` | Invoice with no matching payment row |
+| `orphan-payment` | Payment whose id matches no invoice row |
 
 ## Outputs
 
-- `reconciliation-report.md`
-- `matched-invoices.csv`
-- `discrepancies.csv`
-- `anomalies.json`
-- `summary.json`
-- `manifest.json`
+Written into `--output` (default `./reconciliation`):
+
+| File | Contents |
+|------|----------|
+| `matched.csv` | Invoices settled within the tolerance |
+| `discrepancies.csv` | Every non-matched row with amounts, difference, and a note |
+| `anomalies.json` | Duplicate invoice rows, multiple/identical payments, orphan payments, missing ids, unparseable amounts |
+| `summary.json` | Detected columns, per-bucket counts and totals, match rate, run metadata |
+
+A summary table is printed to stdout:
+
+```
+  bucket             count  invoiced      paid  difference
+  -----------------  -----  --------  --------  ----------
+  matched                2   1299.99   1299.99        0.00
+  short-paid             1    850.50    800.00      -50.50
+  over-paid              1   2400.00   2500.00      100.00
+  duplicate-payment      1  15000.00  15000.00        0.00
+  unpaid-invoice         1    320.00      0.00     -320.00
+  orphan-payment         1      0.00    450.00      450.00
+  -----------------  -----  --------  --------  ----------
+  TOTAL                  7  19870.49  20049.99      179.50
+```
+
+## Exit Codes
 
-After submitting a hosted run, poll with `skills runs status <run-id>` and download outputs with `skills exports download <run-id>`.
+- `0` — reconciliation completed
+- `1` — missing/unreadable CSV, unparseable CSV, or no id/amount column could be detected

package/skills/invoice-reconciliation/package.json

@@ -2,10 +2,35 @@
   "name": "invoice-reconciliation",
   "version": "0.1.0",
   "private": true,
-  "description": "Hosted premium invoice reconciliation report generator",
+  "description": "Reconcile invoice and payment CSV exports into matched rows, discrepancies, anomalies, and totals",
   "type": "module",
-  "skills": {
-    "runtime": "hosted",
-    "source": "remote"
+  "main": "src/index.ts",
+  "bin": {
+    "invoice-reconciliation": "src/index.ts"
+  },
+  "files": [
+    "src",
+    "SKILL.md",
+    "tsconfig.json"
+  ],
+  "keywords": [
+    "invoice",
+    "reconciliation",
+    "finance",
+    "csv",
+    "cli",
+    "skill"
+  ],
+  "scripts": {
+    "start": "bun run src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "csv-parse": "^5.5.6",
+    "csv-stringify": "^6.5.2"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
   }
 }