@hasna/skills 0.1.59 → 0.1.61

package/skills/destination-briefing/src/index.ts

@@ -1,291 +0,0 @@
-#!/usr/bin/env bun
-/**
- * destination-briefing
- * Generates destination briefings using OpenAI.
- */
-
-import { parseArgs } from "util";
-import { existsSync, mkdirSync, appendFileSync, readFileSync } from "fs";
-import { join, dirname, resolve } from "path";
-import { randomUUID } from "crypto";
-
-type OutputFormat = "markdown" | "json";
-
-type BriefingTemplate = {
-  destination?: Record<string, unknown>;
-  travelers?: Array<Record<string, unknown>>;
-  itinerary?: Array<Record<string, unknown>>;
-  notes?: string;
-};
-
-interface SkillOptions {
-  brief: string;
-  audience?: string;
-  tone?: string;
-  format: OutputFormat;
-  model: string;
-  output?: string;
-  template?: BriefingTemplate;
-}
-
-interface OpenAIChatResponse {
-  choices?: Array<{
-    message?: {
-      content?: string | null;
-    };
-  }>;
-  error?: {
-    message?: string;
-  };
-}
-
-const SKILL_SLUG = "destination-briefing";
-const SESSION_ID = randomUUID().slice(0, 8);
-
-function ensureDir(path: string) {
-  if (!existsSync(path)) {
-    mkdirSync(path, { recursive: true });
-  }
-}
-
-function getPaths() {
-  const sessionStamp = new Date().toISOString().replace(/[:.]/g, "_").replace(/-/g, "_");
-  const exportsRoot = process.env.SKILLS_EXPORTS_DIR || join(process.cwd(), ".skills", "exports");
-  const logsRoot = process.env.SKILLS_LOGS_DIR || join(process.cwd(), ".skills", "logs");
-
-  const skillExportsDir = join(exportsRoot, SKILL_SLUG);
-  const skillLogsDir = join(logsRoot, SKILL_SLUG);
-
-  ensureDir(skillExportsDir);
-  ensureDir(skillLogsDir);
-
-  return {
-    sessionStamp,
-    skillExportsDir,
-    skillLogsDir,
-  };
-}
-
-function createLogger(logDir: string, sessionStamp: string) {
-  const logFile = join(logDir, `log_${sessionStamp}_${SESSION_ID}.log`);
-
-  function write(level: "info" | "success" | "error", message: string) {
-    const timestamp = new Date().toISOString();
-    const entry = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
-    appendFileSync(logFile, entry);
-    const prefix = level === "success" ? "✅" : level === "error" ? "❌" : "ℹ️";
-    if (level === "error") {
-      console.error(`${prefix} ${message}`);
-    } else {
-      console.log(`${prefix} ${message}`);
-    }
-  }
-
-  return {
-    info: (message: string) => write("info", message),
-    success: (message: string) => write("success", message),
-    error: (message: string) => write("error", message),
-    logFile,
-  };
-}
-
-function slugify(value: string): string {
-  return value
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-+|-+$/g, "")
-    .slice(0, 40) || "destination-briefing";
-}
-
-function parseJsonTemplate(content: string): BriefingTemplate | undefined {
-  try {
-    const data = JSON.parse(content);
-    if (typeof data === "object" && data !== null) {
-      return data as BriefingTemplate;
-    }
-  } catch (_error) {
-    // treat as plain text when parsing fails
-  }
-  return undefined;
-}
-
-function parseOptions(): SkillOptions {
-  const { values, positionals } = parseArgs({
-    args: Bun.argv.slice(2),
-    options: {
-      text: { type: "string" },
-      audience: { type: "string" },
-      tone: { type: "string" },
-      format: { type: "string", default: "markdown" },
-      model: { type: "string", default: "gpt-4o-mini" },
-      output: { type: "string" },
-      help: { type: "boolean", short: "h" },
-    },
-    allowPositionals: true,
-  });
-
-  if (values.help) {
-    console.log(`
-Destination Briefing - Generates destination briefings
-
-Usage:
-  skills run destination-briefing -- [options] <file-path>
-
-Options:
-  --text <string>      Destination data (or use positional arg)
-  --audience <string>  Target audience
-  --tone <string>      Tone of voice
-  --format <fmt>       Output format: markdown, json (default: markdown)
-  --model <model>      OpenAI model to use (default: gpt-4o-mini)
-  --output <path>      Save report to file
-  --help, -h           Show this help
-`);
-    process.exit(0);
-  }
-
-  let brief = values.text || "";
-  let template: BriefingTemplate | undefined;
-
-  if (!brief && positionals[0]) {
-    const filePath = resolve(positionals[0]);
-    if (existsSync(filePath)) {
-      const content = readFileSync(filePath, "utf-8");
-      template = parseJsonTemplate(content);
-      brief = template ? "" : content;
-    } else {
-      brief = positionals.join(" ");
-    }
-  }
-
-  if (!brief.trim() && !template) {
-    throw new Error("Provide destination data via positional text, file path, or --text.");
-  }
-
-  const format: OutputFormat =
-    values.format === "json" ? "json" : values.format === "markdown" ? "markdown" : "markdown";
-
-  return {
-    brief,
-    audience: values.audience as string,
-    tone: values.tone as string,
-    format,
-    model: values.model as string,
-    output: values.output as string,
-    template,
-  };
-}
-
-function buildPrompt(options: SkillOptions) {
-  const system = `You are a travel risk and logistics advisor creating destination briefings.
-Cover visas, customs, health, safety, money, transport, connectivity, cultural etiquette, and local contacts.
-Tailor tone and detail to the specified audience.`;
-
-  const instructions =
-    options.format === "json"
-      ? "Respond in JSON with keys: summary, entry_requirements, health, safety, logistics, etiquette, contacts, next_steps." 
-      : "Respond in polished Markdown. Start with an executive summary, provide sections for entry/visa, health & safety, logistics (transport, money, connectivity), cultural etiquette, and include recommended actions.";
-
-  const payload = {
-    audience: options.audience || "Traveler",
-    tone: options.tone || "friendly",
-    brief_text: options.brief.substring(0, 6000),
-    structured_template: options.template,
-  };
-
-  const user = `${instructions}\n\n${JSON.stringify(payload, null, 2)}`;
-
-  return { system, user };
-}
-
-async function callOpenAI(options: SkillOptions, system: string, user: string): Promise<string> {
-  const apiKey = process.env.OPENAI_API_KEY;
-  if (!apiKey) {
-    throw new Error("OPENAI_API_KEY environment variable is required.");
-  }
-
-  const body = {
-    model: options.model,
-    messages: [
-      { role: "system", content: system },
-      { role: "user", content: user },
-    ],
-    temperature: 0.4,
-    max_tokens: options.format === "json" ? 2200 : 2000,
-  };
-
-  const response = await fetch("https://api.openai.com/v1/chat/completions", {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${apiKey}`,
-    },
-    body: JSON.stringify(body),
-  });
-
-  const data: OpenAIChatResponse = await response.json();
-
-  if (!response.ok) {
-    throw new Error(data.error?.message || `OpenAI API error (${response.status})`);
-  }
-
-  const content = data.choices?.[0]?.message?.content;
-  if (!content) {
-    throw new Error("OpenAI response did not include content.");
-  }
-
-  return content.trim();
-}
-
-async function writeExport(path: string, content: string) {
-  ensureDir(dirname(path));
-  await Bun.write(path, content);
-}
-
-function buildExportPath(skillExportsDir: string, sessionStamp: string, options: SkillOptions) {
-  if (options.output) {
-    return resolve(options.output);
-  }
-
-  const descriptorParts = [options.audience || "traveler", options.tone || "friendly"];
-  const base = slugify(descriptorParts.filter(Boolean).join("-"));
-  const extension = options.format === "json" ? "json" : "md";
-  return join(skillExportsDir, `${base}_${sessionStamp}.${extension}`);
-}
-
-function preview(content: string) {
-  const lines = content.split(/\r?\n/).slice(0, 8);
-  lines.forEach(line => console.log(`   ${line}`));
-  if (content.split(/\r?\n/).length > 8) {
-    console.log("   ...");
-  }
-}
-
-async function main() {
-  const { sessionStamp, skillExportsDir, skillLogsDir } = getPaths();
-  const logger = createLogger(skillLogsDir, sessionStamp);
-
-  try {
-    logger.info(`Starting ${SKILL_SLUG} session: ${SESSION_ID}`);
-    const options = parseOptions();
-    logger.info("Parsed destination inputs and options.");
-
-    const { system, user } = buildPrompt(options);
-    logger.info("Constructed destination briefing prompt.");
-
-    const content = await callOpenAI(options, system, user);
-    logger.success("Received destination briefing from OpenAI.");
-
-    const exportPath = buildExportPath(skillExportsDir, sessionStamp, options);
-    await writeExport(exportPath, content);
-    logger.success(`Saved destination briefing to ${exportPath}`);
-
-    console.log("\nPreview:");
-    preview(content);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    logger.error(message);
-    process.exitCode = 1;
-  }
-}
-
-main();

package/skills/destination-briefing/tsconfig.json

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

package/skills/doc-generate/CLAUDE.md

@@ -1,19 +0,0 @@
-# doc-generate
-
-Generate DOCX documents.
-
-## Development
-
-- Runtime: Bun
-- Use `bun` instead of `npm`, `yarn`, or `pnpm`
-- Use `bun run` instead of `npm run`
-- Use `bun install` instead of `npm install`
-
-## Commands
-
-```bash
-bun install        # Install dependencies
-bun run start      # Run the skill
-bun run dev        # Run with watch mode
-bun run cli        # Run via CLI
-```

package/skills/doc-generate/SKILL.md

@@ -1,295 +0,0 @@
----
-name: doc-generate
-version: 1.0.0
-description: Generate docx with customizable options
-author: skills.md
-category: Documentation
-tags:
-  - documentation
-  - markdown
-  - ai
----
---topic "Project Proposal for Mobile App Development" -o proposal.docx
-
-# Generate DOCX
-
-Create professional Microsoft Word documents from markdown content, plain text, or let AI generate complete documents from a topic or outline.
-
-> **This is a CLI skill.** It requires the `skills` CLI to execute. Install it with `npm install -g @hasna/skills`, then run the commands below.
-
-## Features
-
-- **Markdown to DOCX**: Convert markdown files to Word documents
-- **AI Generation**: Generate complete documents from topics/prompts
-- **Rich Formatting**: Headers, lists, tables, code blocks, quotes
-- **Custom Styling**: Fonts, colors, margins, spacing
-- **Templates**: Professional templates (report, letter, memo, resume)
-- **Table of Contents**: Auto-generated TOC
-- **Headers/Footers**: Page numbers, dates, custom text
-- **Images**: Embed images from local files or URLs
-
-## Installation
-
-```bash
-skills install generate-docx
-```
-
-## Quick Start
-
-### From Markdown
-
-```bash
-# Convert markdown to Word
-skills run generate-docx -- document.md -o output.docx
-
-# With custom styling
-skills run generate-docx -- document.md --template report --font "Times New Roman"
-```
-
-### AI Generation
-
-```bash
-# Generate from topic
-skills run generate-docx -- --topic "Project Proposal for Mobile App Development" -o proposal.docx
-
-# With more control
-skills run generate-docx -- --topic "Employee Handbook" \
-  --sections 10 \
-  --style formal \
-  --template report \
-  -o handbook.docx
-```
-
-### From Text/Prompt
-
-```bash
-# Generate from prompt
-skills run generate-docx -- --prompt "Write a cover letter for a software engineer position at Google" -o cover-letter.docx
-```
-
-## Options
-
-### Input Options
-
-| Flag              | Description                     |
-| ----------------- | ------------------------------- |
-| `<file>`          | Input markdown file             |
-| `--topic <text>`  | Topic for AI to write about     |
-| `--prompt <text>` | Direct prompt for AI generation |
-| `--text <text>`   | Plain text content              |
-
-### AI Options
-
-| Flag              | Default      | Description                                   |
-| ----------------- | ------------ | --------------------------------------------- |
-| `--sections <n>`  | 5            | Number of sections to generate                |
-| `--style <type>`  | professional | Style: professional, casual, formal, academic |
-| `--tone <type>`   | neutral      | Tone: neutral, friendly, authoritative        |
-| `--length <type>` | medium       | Length: short, medium, long, comprehensive    |
-
-### Output Options
-
-| Flag                  | Default         | Description      |
-| --------------------- | --------------- | ---------------- |
-| `-o, --output <path>` | auto            | Output file path |
-| `--dir <path>`        | .skills/exports | Output directory |
-
-### Template Options
-
-| Flag                | Default | Description                                              |
-| ------------------- | ------- | -------------------------------------------------------- |
-| `--template <name>` | default | Template: default, report, letter, memo, resume, article |
-| `--title <text>`    | auto    | Document title                                           |
-| `--author <text>`   | -       | Author name                                              |
-| `--company <text>`  | -       | Company name                                             |
-| `--date <text>`     | today   | Document date                                            |
-
-### Styling Options
-
-| Flag                    | Default       | Description             |
-| ----------------------- | ------------- | ----------------------- |
-| `--font <name>`         | Calibri       | Font family             |
-| `--font-size <pt>`      | 11            | Base font size          |
-| `--heading-font <name>` | Calibri Light | Heading font            |
-| `--line-spacing <n>`    | 1.15          | Line spacing multiplier |
-| `--margins <inches>`    | 1             | Page margins            |
-| `--page-size <size>`    | letter        | Page: letter, a4, legal |
-
-### Content Options
-
-| Flag              | Default | Description               |
-| ----------------- | ------- | ------------------------- |
-| `--toc`           | false   | Include table of contents |
-| `--page-numbers`  | true    | Include page numbers      |
-| `--header <text>` | -       | Header text               |
-| `--footer <text>` | -       | Footer text               |
-
-## Templates
-
-### default
-
-Clean, minimal document with standard formatting.
-
-### report
-
-Professional report with title page, TOC, headers/footers.
-
-### letter
-
-Business letter format with date, addresses, signature block.
-
-### memo
-
-Internal memo format with To/From/Subject/Date header.
-
-### resume
-
-CV/Resume format with sections for experience, education, skills.
-
-### article
-
-Article/essay format with abstract and section numbering.
-
-## Examples
-
-### Example 1: Simple Markdown Conversion
-
-```bash
-skills run generate-docx -- notes.md -o notes.docx
-```
-
-### Example 2: Professional Report
-
-```bash
-skills run generate-docx -- \
-  --topic "Q4 2024 Sales Analysis" \
-  --template report \
-  --sections 8 \
-  --style formal \
-  --toc \
-  --author "Sales Team" \
-  --company "Acme Corp" \
-  -o q4-report.docx
-```
-
-### Example 3: Business Letter
-
-```bash
-skills run generate-docx -- \
-  --prompt "Write a business letter declining a partnership offer politely" \
-  --template letter \
-  --author "John Smith" \
-  --company "Tech Solutions Inc" \
-  -o decline-letter.docx
-```
-
-### Example 4: Resume from Markdown
-
-```bash
-skills run generate-docx -- resume.md \
-  --template resume \
-  --font "Garamond" \
-  --margins 0.75 \
-  -o my-resume.docx
-```
-
-### Example 5: Academic Paper
-
-```bash
-skills run generate-docx -- paper.md \
-  --template article \
-  --font "Times New Roman" \
-  --font-size 12 \
-  --line-spacing 2 \
-  --toc \
-  -o research-paper.docx
-```
-
-### Example 6: Company Memo
-
-```bash
-skills run generate-docx -- \
-  --prompt "Write a memo announcing the new remote work policy" \
-  --template memo \
-  --author "HR Department" \
-  -o remote-work-memo.docx
-```
-
-## Markdown Support
-
-The skill supports standard markdown plus extensions:
-
-```markdown
-# Heading 1
-
-## Heading 2
-
-### Heading 3
-
-Regular paragraph text with **bold**, _italic_, and `code`.
-
-- Bullet list item 1
-- Bullet list item 2
-  - Nested item
-
-1. Numbered list
-2. Second item
-
-> Block quote text
-
-| Column 1 | Column 2 |
-| -------- | -------- |
-| Cell 1   | Cell 2   |
-
-![Image](path/to/image.png)
-
----
-
-Horizontal rule above
-```
-
-## Environment Variables
-
-```bash
-# Required for AI generation
-export OPENAI_API_KEY="sk-..."
-```
-
-## Credits
-
-- Base conversion: 3 credits
-- AI generation: +5 credits
-
-## Troubleshooting
-
-**Document won't open**
-
-- Ensure .docx extension is used
-- Try opening in Google Docs or LibreOffice
-
-**Formatting looks wrong**
-
-- Different Word versions render slightly differently
-- Try adjusting font and spacing options
-
-**Images not appearing**
-
-- Use absolute paths for local images
-- Ensure image files exist
-
-**AI generation failed**
-
-- Check OPENAI_API_KEY is set
-- Use markdown input instead of --topic
-
-## Related Skills
-
-- `generate-pdf` - Create PDF documents
-- `generate-slides` - Create presentations
-- `parse-pdf` - Extract content from PDFs
-
-## Support
-
-For issues or feature requests, visit [skills.md/skills/generate-docx](https://skills.md/skills/generate-docx)
-
-```

package/skills/doc-generate/package.json

@@ -1,23 +0,0 @@
-{
-  "name": "doc-generate",
-  "version": "0.1.0",
-  "description": "Generate DOCX documents with rich formatting and templates",
-  "type": "module",
-  "bin": {
-    "doc-generate": "./src/index.ts"
-  },
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "dev": "bun run --watch src/index.ts",
-    "cli": "bun run src/index.ts"
-  },
-  "dependencies": {
-    "docx": "^9.5.1",
-    "marked": "^15.0.4",
-    "openai": "^4.77.0"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "restricted"
-  }
-}

package/skills/doc-generate/src/ai.ts

@@ -1,50 +0,0 @@
-import { createOpenAIClient } from "./dependencies";
-import type { DocOptions } from "./types";
-
-export async function generateWithAI(options: DocOptions, topic: string, isPrompt = false): Promise<string> {
-  const apiKey = process.env.OPENAI_API_KEY;
-  if (!apiKey) {
-    throw new Error("OPENAI_API_KEY environment variable is required for AI generation");
-  }
-
-  const openai = await createOpenAIClient(apiKey);
-
-  const lengthGuide = {
-    short: "Keep it concise, around 500 words total.",
-    medium: "Write a moderate length document, around 1000-1500 words.",
-    long: "Write a comprehensive document, around 2000-3000 words.",
-    comprehensive: "Write a very detailed document, around 4000+ words with thorough coverage.",
-  };
-
-  const styleGuide = {
-    professional: "Use professional business language.",
-    casual: "Use a casual, conversational tone.",
-    formal: "Use formal, academic language.",
-    academic: "Use scholarly, well-researched language with citations where appropriate.",
-  };
-
-  const systemPrompt = isPrompt
-    ? `You are a professional document writer. Write in markdown format with proper headings, paragraphs, lists, and formatting. ${styleGuide[options.style]} ${lengthGuide[options.length]}`
-    : `You are a professional document writer creating a ${options.template} document. Write in markdown format with:
-- A clear title (# Title)
-- ${options.sections} main sections (## Section headings)
-- Proper paragraphs, bullet points, and formatting as needed
-- ${styleGuide[options.style]}
-- ${lengthGuide[options.length]}
-
-Output ONLY the markdown content, no explanations.`;
-  const userPrompt = isPrompt ? topic : `Write a document about: ${topic}`;
-
-  console.log("Generating content with AI...");
-
-  const response = await openai.chat.completions.create({
-    model: "gpt-4o",
-    messages: [
-      { role: "system", content: systemPrompt },
-      { role: "user", content: userPrompt },
-    ],
-    temperature: 0.7,
-  });
-
-  return response.choices[0]?.message?.content || "";
-}