@hasna/skills 0.1.21 → 0.1.23

package/skills/skill-excel/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: excel
+version: 0.1.0
+description: Generate Excel spreadsheets with tables, formulas, multiple sheets, styling, and optional AI-generated data.
+category: Content Generation
+tags:
+  - excel
+  - spreadsheet
+  - xlsx
+  - generation
+  - data
+---
+
+# Excel
+
+Generate `.xlsx` spreadsheets or CSV exports from templates, prompt-provided data, or AI-generated sample data. Use this when the user needs a workbook, budget, invoice sheet, report table, tracker, or structured spreadsheet file.
+
+## Usage
+
+```bash
+skill-excel --preset budget --rows 12 --output ./budget.xlsx
+skill-excel --prompt "Create a weekly content calendar" --output ./calendar.xlsx
+skill-excel --format csv --preset invoice --output ./invoice.csv
+```
+
+## Inputs
+
+- `--preset <name>`: use a built-in workbook template such as `budget`, `invoice`, or `tracker`
+- `--prompt <text>`: ask AI to generate spreadsheet data
+- `--rows <n>`: number of rows to create
+- `--sheets <names>`: comma-separated sheet names
+- `--format <xlsx|csv>`: output format
+- `--output <path>`: output file path
+
+## Requirements
+
+- `OPENAI_API_KEY` is required only when using prompt-based AI data generation.
+- Local template generation does not need network access.

package/skills/skill-excel/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@hasnaxyz/skill-excel",
+  "version": "0.1.0",
+  "description": "Generate Excel spreadsheets with data, formulas, and professional styling",
+  "type": "module",
+  "bin": {
+    "skill-excel": "./src/index.ts"
+  },
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "openai": "^4.77.0",
+    "xlsx": "^0.18.5"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "src",
+    "tsconfig.json"
+  ]
+}

package/skills/{skill-generate-excel → skill-excel}/src/index.ts

@@ -1,11 +1,15 @@
 #!/usr/bin/env bun
-import * as XLSX from "xlsx";
 import { parseArgs } from "util";
 import { existsSync, mkdirSync, appendFileSync } from "fs";
 import { join } from "path";
-import OpenAI from "openai";
 import { randomUUID } from "crypto";
 
+type XlsxModule = typeof import("xlsx");
+type WorkSheet = import("xlsx").WorkSheet;
+type WorkBook = import("xlsx").WorkBook;
+
+let XLSX: XlsxModule;
+
 const SKILL_NAME = "generate-excel";
 const SESSION_ID = randomUUID().slice(0, 8);
 
@@ -37,11 +41,6 @@ function log(message: string, level: "info" | "error" | "success" | "warn" = "in
   }
 }
 
-// OpenAI client
-const openai = new OpenAI({
-  apiKey: process.env.OPENAI_API_KEY,
-});
-
 // Type definitions
 interface ExcelCell {
   v: any; // value
@@ -118,6 +117,23 @@ const TEMPLATES: Record<string, (rows: number) => SheetData> = {
   }),
 };
 
+async function loadXlsx(): Promise<XlsxModule> {
+  try {
+    return await import("xlsx");
+  } catch {
+    throw new Error("Missing dependency 'xlsx'. Run bun install in this skill directory.");
+  }
+}
+
+async function createOpenAIClient() {
+  try {
+    const { default: OpenAI } = await import("openai");
+    return new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+  } catch {
+    throw new Error("Missing dependency 'openai'. Run bun install in this skill directory.");
+  }
+}
+
 // Data generators
 function generateBudgetData(rows: number): any[][] {
   const categories = [
@@ -297,6 +313,7 @@ Return a JSON object with:
 
 Generate exactly ${rows} rows of data. Make the data realistic and varied.`;
 
+  const openai = await createOpenAIClient();
   const response = await openai.chat.completions.create({
     model: "gpt-4o-mini",
     messages: [
@@ -341,7 +358,7 @@ function parseJsonData(jsonString: string): SheetData {
 
 // Apply styling to worksheet
 function applyStyles(
-  ws: XLSX.WorkSheet,
+  ws: WorkSheet,
   sheetData: SheetData,
   styling: "none" | "basic" | "professional"
 ) {
@@ -401,7 +418,7 @@ function applyStyles(
 
 // Add formulas to worksheet
 function addFormulas(
-  ws: XLSX.WorkSheet,
+  ws: WorkSheet,
   sheetData: SheetData,
   startRow: number = 2
 ) {
@@ -423,7 +440,7 @@ function addFormulas(
 
 // Add summary row with totals
 function addSummaryRow(
-  ws: XLSX.WorkSheet,
+  ws: WorkSheet,
   sheetData: SheetData
 ): void {
   const lastRow = sheetData.rows.length + 1;
@@ -458,7 +475,7 @@ function addSummaryRow(
 function createWorkbook(
   sheets: SheetData[],
   options: GenerateOptions
-): XLSX.WorkBook {
+): WorkBook {
   const wb = XLSX.utils.book_new();
 
   sheets.forEach((sheetData) => {
@@ -494,6 +511,12 @@ function createWorkbook(
 
 // Main function
 async function main() {
+  if (process.argv.includes("--help") || process.argv.includes("-h")) {
+    printHelpAndExit();
+  }
+
+  XLSX = await loadXlsx();
+
   const { values, positionals } = parseArgs({
     args: process.argv.slice(2),
     options: {
@@ -510,7 +533,11 @@ async function main() {
   });
 
   if (values.help) {
-    console.log(`
+    printHelpAndExit();
+  }
+
+function printHelpAndExit(): never {
+  console.log(`
 Generate Excel - Create Excel spreadsheets with data and formatting
 
 Usage:
@@ -526,8 +553,8 @@ Options:
   --output <path>      Output file path
   --help, -h           Show this help
 `);
-    process.exit(0);
-  }
+  process.exit(0);
+}
 
   const prompt = positionals[0];
 

package/skills/skill-experiment-power-calculator/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-experiment-power-calculator.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-extract/package.json

@@ -22,7 +22,6 @@
     "text-extraction"
   ],
   "author": "",
-  "license": "Apache-2.0",
   "dependencies": {
     "pdf-parse": "^1.1.1"
   },
@@ -32,9 +31,5 @@
   },
   "peerDependencies": {
     "typescript": "^5.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/hasnaxyz/skill-extract.git"
   }
 }

package/skills/skill-extract-frames/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-extract-frames.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-extract-invoice/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-extract-invoice.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-family-activity-curator/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-family-activity-curator.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-faq-packager/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-faq-packager.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-feedback-survey-designer/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-feedback-survey-designer.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-field-trip-planner/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-field-trip-planner.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-file-organizer/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-file-organizer.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-folder-tree/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-folder-tree.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-forecast-scenario-lab/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-forecast-scenario-lab.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-form-filler/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-form-filler.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-api-client/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-api-client.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-book-cover/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-book-cover.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-chart/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-chart.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-diagram/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-diagram.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-dockerfile/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-dockerfile.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-documentation/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-documentation.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-env/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-env.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-favicon/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-favicon.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-mock-data/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-mock-data.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-pr-description/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-pr-description.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-presentation/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-presentation.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-qrcode/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-qrcode.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-regex/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-regex.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-resume/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-resume.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-sitemap/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-sitemap.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-social-posts/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-social-posts.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-generate-sql/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-generate-sql.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-gif-maker/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-gif-maker.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-github-manager/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-github-manager.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-gmail/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-compose-gmail.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }

package/skills/skill-goal-quarterly-roadmap/package.json

@@ -23,11 +23,5 @@
   "files": [
     "src",
     "tsconfig.json"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hasnaxyz/skill-goal-quarterly-roadmap.git"
-  },
-  "author": "Hasna",
-  "license": "Apache-2.0"
+  ]
 }