@hasna/skills 0.1.62 → 0.1.63

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

@@ -1,51 +0,0 @@
----
-name: market-research-report
-description: Generate a market research report with competitor, audience, pricing, source, Markdown, and PDF artifacts.
-kind: instruction
----
-
-# Market Research Report
-
-Generate a market research report package for SaaS, developer tools, and business planning work.
-
-## Requirements
-
-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
-
-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.
-
-## Inputs
-
-| Input | Description | Default |
-|--------|-------------|---------|
-| `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 |
-
-## Deliverables
-
-- `market-research-report.md`
-- `competitors.csv`
-- `sources.json`
-- `manifest.json`
-
-## 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

@@ -1,10 +0,0 @@
-{
-  "name": "market-research-report",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Generate market research report artifacts",
-  "type": "module",
-  "skills": {
-    "kind": "instruction"
-  }
-}

package/skills/meeting-pack/SKILL.md

@@ -1,52 +0,0 @@
----
-name: meeting-pack
-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
-
-Generate a complete meeting artifact package from transcripts, notes, call summaries, or rough bullets.
-
-## Requirements
-
-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
-
-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.
-
-## Inputs
-
-| Input | Description | Default |
-|--------|-------------|---------|
-| `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 |
-
-## Deliverables
-
-- `meeting-summary.md`
-- `decisions.md`
-- `action-items.csv`
-- `follow-up-email.md`
-- `project-export.json`
-- `timeline.md`
-- `manifest.json`
-
-## 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

@@ -1,10 +0,0 @@
-{
-  "name": "meeting-pack",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Hosted premium meeting artifact package generator",
-  "type": "module",
-  "skills": {
-    "kind": "instruction"
-  }
-}

package/skills/merge-pdfs/CLAUDE.md

@@ -1,19 +0,0 @@
-# merge-pdfs
-
-Merge Pdfs skill.
-
-## Tech Stack
-
-- Runtime: Bun
-- Language: TypeScript
-- CLI: Commander.js
-
-## CLI
-
-```bash
-merge-pdfs run
-```
-
-## Data Directory
-
-~/.skill/merge-pdfs/

package/skills/merge-pdfs/package.json

@@ -1,31 +0,0 @@
-{
-  "name": "merge-pdfs",
-  "version": "0.1.0",
-  "description": "Merge Pdfs skill",
-  "type": "module",
-  "bin": {
-    "merge-pdfs": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "pdf-lib": "^1.17.1",
-    "minimist": "^1.2.8",
-    "glob": "^11.1.0"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "src",
-    "tsconfig.json"
-  ]
-}

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

@@ -1,427 +0,0 @@
-#!/usr/bin/env bun
-
-import { PDFDocument, rgb, StandardFonts, degrees } from "pdf-lib";
-import * as fs from "fs";
-import * as path from "path";
-import minimist from "minimist";
-import { globSync } from "glob";
-
-// Types
-interface FileSpec {
-  path: string;
-  pages: string;
-}
-
-interface MergeOptions {
-  output: string;
-  bookmarks: boolean;
-  sort: "none" | "name" | "date" | "size";
-  reverse: boolean;
-  blankBetween: boolean;
-  title: string | null;
-  author: string | null;
-  rotate: number;
-  compress: boolean;
-  pageNumbers: boolean;
-  pageNumberFormat: string;
-  pageNumberPosition: string;
-}
-
-// Parse command line arguments
-const args = minimist(process.argv.slice(2), {
-  string: [
-    "output",
-    "sort",
-    "title",
-    "author",
-    "page-number-format",
-    "page-number-position",
-  ],
-  boolean: [
-    "bookmarks",
-    "reverse",
-    "blank-between",
-    "compress",
-    "page-numbers",
-    "help",
-  ],
-  default: {
-    output: "merged.pdf",
-    sort: "none",
-    reverse: false,
-    bookmarks: false,
-    "blank-between": false,
-    compress: false,
-    "page-numbers": false,
-    "page-number-format": "Page {n}",
-    "page-number-position": "bottom-center",
-    rotate: 0,
-  },
-  alias: {
-    o: "output",
-    h: "help",
-  },
-});
-
-// Show help
-if (args.help || args._.length === 0) {
-  console.log(`
-Merge PDFs - Combine multiple PDF files into one
-
-Usage:
-  skills run merge-pdfs -- <file1.pdf> [file2.pdf...] [options]
-
-Options:
-  -o, --output <file>           Output file path (default: merged.pdf)
-  --bookmarks                   Add bookmarks for each source file
-  --sort <type>                 Sort order: none, name, date, size (default: none)
-  --reverse                     Reverse the merge order
-  --blank-between               Insert blank page between documents
-  --title <text>                Set PDF title metadata
-  --author <text>               Set PDF author metadata
-  --rotate <degrees>            Rotate all pages: 0, 90, 180, 270
-  --compress                    Compress output PDF
-  --page-numbers                Add page numbers
-  --page-number-format <fmt>    Format: "Page {n}" or "Page {n} of {total}"
-  --page-number-position <pos>  Position: top/bottom-left/center/right
-  -h, --help                    Show this help message
-
-Page Selection:
-  file.pdf                      All pages
-  file.pdf:1-5                  Pages 1 through 5
-  file.pdf:1,3,5                Specific pages
-  file.pdf:1-3,7,10-12          Mixed ranges
-
-Examples:
-  skills run merge-pdfs -- doc1.pdf doc2.pdf -o combined.pdf
-  skills run merge-pdfs -- "doc.pdf:1-5" "other.pdf:2,4" -o output.pdf
-  skills run merge-pdfs -- ./docs/*.pdf --sort name --bookmarks -o book.pdf
-`);
-  process.exit(0);
-}
-
-// Parse options
-const options: MergeOptions = {
-  output: args.output,
-  bookmarks: args.bookmarks,
-  sort: args.sort as MergeOptions["sort"],
-  reverse: args.reverse,
-  blankBetween: args["blank-between"],
-  title: args.title || null,
-  author: args.author || null,
-  rotate: parseInt(args.rotate) || 0,
-  compress: args.compress,
-  pageNumbers: args["page-numbers"],
-  pageNumberFormat: args["page-number-format"],
-  pageNumberPosition: args["page-number-position"],
-};
-
-// Parse file spec (path:pages)
-function parseFileSpec(spec: string): FileSpec {
-  const colonIndex = spec.lastIndexOf(":");
-  // Check if colon is part of page spec (not Windows drive letter)
-  if (colonIndex > 1 && !spec.substring(colonIndex + 1).includes("/")) {
-    const possiblePages = spec.substring(colonIndex + 1);
-    if (/^[\d,\-all]+$/i.test(possiblePages)) {
-      return {
-        path: spec.substring(0, colonIndex),
-        pages: possiblePages.toLowerCase(),
-      };
-    }
-  }
-  return { path: spec, pages: "all" };
-}
-
-// Parse page range into array of page indices (0-based)
-function parsePageRange(pageStr: string, totalPages: number): number[] {
-  if (pageStr === "all") {
-    return Array.from({ length: totalPages }, (_, i) => i);
-  }
-
-  const pages: Set<number> = new Set();
-  const parts = pageStr.split(",").map((p) => p.trim());
-
-  for (const part of parts) {
-    if (part.includes("-")) {
-      const [startStr, endStr] = part.split("-");
-      const start = startStr ? parseInt(startStr) : 1;
-      const end = endStr ? parseInt(endStr) : totalPages;
-      for (let i = start - 1; i < Math.min(end, totalPages); i++) {
-        if (i >= 0) pages.add(i);
-      }
-    } else {
-      const pageNum = parseInt(part) - 1;
-      if (pageNum >= 0 && pageNum < totalPages) {
-        pages.add(pageNum);
-      }
-    }
-  }
-
-  return Array.from(pages).sort((a, b) => a - b);
-}
-
-// Expand glob patterns and get file list
-function getFileList(specs: string[]): FileSpec[] {
-  const files: FileSpec[] = [];
-
-  for (const spec of specs) {
-    const { path: pattern, pages } = parseFileSpec(spec);
-
-    // Try glob expansion
-    const matches = globSync(pattern);
-
-    if (matches.length === 0) {
-      // No glob match, try as literal path
-      if (fs.existsSync(pattern)) {
-        files.push({ path: pattern, pages });
-      } else {
-        console.warn(`Warning: File not found: ${pattern}`);
-      }
-    } else {
-      for (const match of matches) {
-        if (match.toLowerCase().endsWith(".pdf")) {
-          files.push({ path: match, pages });
-        }
-      }
-    }
-  }
-
-  return files;
-}
-
-// Sort files based on option
-function sortFiles(files: FileSpec[], sortBy: string, reverse: boolean): FileSpec[] {
-  const sorted = [...files];
-
-  switch (sortBy) {
-    case "name":
-      sorted.sort((a, b) =>
-        path.basename(a.path).localeCompare(path.basename(b.path))
-      );
-      break;
-    case "date":
-      sorted.sort((a, b) => {
-        const statA = fs.statSync(a.path);
-        const statB = fs.statSync(b.path);
-        return statA.mtime.getTime() - statB.mtime.getTime();
-      });
-      break;
-    case "size":
-      sorted.sort((a, b) => {
-        const statA = fs.statSync(a.path);
-        const statB = fs.statSync(b.path);
-        return statA.size - statB.size;
-      });
-      break;
-  }
-
-  if (reverse) {
-    sorted.reverse();
-  }
-
-  return sorted;
-}
-
-// Add page numbers to document
-async function addPageNumbers(
-  pdfDoc: PDFDocument,
-  format: string,
-  position: string
-): Promise<void> {
-  const pages = pdfDoc.getPages();
-  const totalPages = pages.length;
-  const font = await pdfDoc.embedFont(StandardFonts.Helvetica);
-  const fontSize = 10;
-
-  for (let i = 0; i < pages.length; i++) {
-    const page = pages[i];
-    const { width, height } = page.getSize();
-
-    const text = format
-      .replace("{n}", String(i + 1))
-      .replace("{total}", String(totalPages));
-
-    const textWidth = font.widthOfTextAtSize(text, fontSize);
-
-    let x: number;
-    let y: number;
-
-    // Determine position
-    const [vPos, hPos] = position.split("-");
-
-    // Vertical position
-    if (vPos === "top") {
-      y = height - 30;
-    } else {
-      y = 20;
-    }
-
-    // Horizontal position
-    switch (hPos) {
-      case "left":
-        x = 30;
-        break;
-      case "right":
-        x = width - textWidth - 30;
-        break;
-      default: // center
-        x = (width - textWidth) / 2;
-    }
-
-    page.drawText(text, {
-      x,
-      y,
-      size: fontSize,
-      font,
-      color: rgb(0.3, 0.3, 0.3),
-    });
-  }
-}
-
-// Create a blank page with same size as reference
-function createBlankPage(pdfDoc: PDFDocument, width: number, height: number) {
-  return pdfDoc.addPage([width, height]);
-}
-
-// Main merge function
-async function mergePdfs(fileSpecs: FileSpec[]): Promise<void> {
-  console.log(`\nMerging ${fileSpecs.length} PDF files...\n`);
-
-  // Create output document
-  const mergedPdf = await PDFDocument.create();
-
-  // Track source documents for bookmarks
-  const bookmarkInfo: { title: string; pageIndex: number }[] = [];
-  let totalSourcePages = 0;
-  const sourceStats: { name: string; pages: number }[] = [];
-
-  // Process each file
-  for (const spec of fileSpecs) {
-    console.log(`Processing: ${spec.path}`);
-
-    try {
-      const fileBytes = fs.readFileSync(spec.path);
-      const sourcePdf = await PDFDocument.load(fileBytes);
-      const sourcePageCount = sourcePdf.getPageCount();
-
-      // Get pages to include
-      const pageIndices = parsePageRange(spec.pages, sourcePageCount);
-      console.log(`  - Including ${pageIndices.length} of ${sourcePageCount} pages`);
-
-      // Record bookmark position
-      if (options.bookmarks) {
-        bookmarkInfo.push({
-          title: path.basename(spec.path, ".pdf"),
-          pageIndex: mergedPdf.getPageCount(),
-        });
-      }
-
-      // Copy pages
-      const copiedPages = await mergedPdf.copyPages(sourcePdf, pageIndices);
-
-      for (const page of copiedPages) {
-        // Apply rotation if specified
-        if (options.rotate !== 0) {
-          page.setRotation(degrees(options.rotate));
-        }
-        mergedPdf.addPage(page);
-      }
-
-      // Add blank page between documents if requested
-      if (options.blankBetween && spec !== fileSpecs[fileSpecs.length - 1]) {
-        const lastPage = copiedPages[copiedPages.length - 1];
-        const { width, height } = lastPage.getSize();
-        createBlankPage(mergedPdf, width, height);
-      }
-
-      totalSourcePages += pageIndices.length;
-      sourceStats.push({
-        name: path.basename(spec.path),
-        pages: pageIndices.length,
-      });
-    } catch (error: any) {
-      console.error(`  Error processing ${spec.path}: ${error.message}`);
-    }
-  }
-
-  // Set metadata
-  if (options.title) {
-    mergedPdf.setTitle(options.title);
-  }
-  if (options.author) {
-    mergedPdf.setAuthor(options.author);
-  }
-  mergedPdf.setCreator("merge-pdfs skill");
-  mergedPdf.setProducer("pdf-lib");
-  mergedPdf.setCreationDate(new Date());
-  mergedPdf.setModificationDate(new Date());
-
-  // Add page numbers if requested
-  if (options.pageNumbers) {
-    console.log("\nAdding page numbers...");
-    await addPageNumbers(
-      mergedPdf,
-      options.pageNumberFormat,
-      options.pageNumberPosition
-    );
-  }
-
-  // Note: pdf-lib doesn't support bookmarks/outlines directly
-  // For full bookmark support, we'd need a different library
-  if (options.bookmarks && bookmarkInfo.length > 0) {
-    console.log("\nNote: Bookmark metadata recorded (visual bookmarks require additional processing)");
-  }
-
-  // Save output
-  console.log("\nSaving merged PDF...");
-  const outputBytes = await mergedPdf.save();
-
-  // Ensure output directory exists
-  const outputDir = path.dirname(options.output);
-  if (outputDir && !fs.existsSync(outputDir)) {
-    fs.mkdirSync(outputDir, { recursive: true });
-  }
-
-  fs.writeFileSync(options.output, outputBytes);
-
-  // Print summary
-  console.log(`\n${"=".repeat(50)}`);
-  console.log(`Merged ${fileSpecs.length} files (${mergedPdf.getPageCount()} pages total) into: ${options.output}`);
-  console.log("=".repeat(50));
-  for (const stat of sourceStats) {
-    console.log(`  - ${stat.name}: ${stat.pages} pages`);
-  }
-  console.log("");
-
-  const outputSize = fs.statSync(options.output).size;
-  console.log(`Output file size: ${(outputSize / 1024 / 1024).toFixed(2)} MB`);
-  console.log("\nDone!");
-}
-
-// Main execution
-async function main() {
-  try {
-    // Get file list
-    let files = getFileList(args._ as string[]);
-
-    if (files.length === 0) {
-      console.error("Error: No valid PDF files found");
-      process.exit(1);
-    }
-
-    if (files.length === 1) {
-      console.warn("Warning: Only one file specified, nothing to merge");
-    }
-
-    // Sort files
-    files = sortFiles(files, options.sort, options.reverse);
-
-    // Perform merge
-    await mergePdfs(files);
-  } catch (error: any) {
-    console.error(`Error: ${error.message}`);
-    process.exit(1);
-  }
-}
-
-main();

package/skills/merge-pdfs/tsconfig.json

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

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

@@ -1,56 +0,0 @@
----
-name: migration-plan-pack
-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
-
-Generate a migration package from current state, target state, system context, and operating constraints. Hosted runs can inspect richer project inputs, while local direct execution produces deterministic artifacts for validation.
-
-## Requirements
-
-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
-
-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.
-
-## Inputs
-
-| Input | Description | Default |
-|--------|-------------|---------|
-| `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 |
-
-## Deliverables
-
-- `migration-plan.md`
-- `risk-matrix.csv`
-- `ordered-checklist.md`
-- `test-strategy.md`
-- `dependency-map.json`
-- `rollout-plan.md`
-- `manifest.json`
-
-## 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

@@ -1,10 +0,0 @@
-{
-  "name": "migration-plan-pack",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Hosted premium migration planning pack generator",
-  "type": "module",
-  "skills": {
-    "kind": "instruction"
-  }
-}