@hasna/skills 0.0.2

package/skills/skill-brand-style-guide/src/index.ts

@@ -0,0 +1,288 @@
+#!/usr/bin/env bun
+/**
+ * skill-brand-style-guide
+ * Generates comprehensive brand guidelines using OpenAI.
+ *
+ * This microservice relies only on its local files and the Bun runtime.
+ */
+
+import { parseArgs } from "util";
+import { existsSync, mkdirSync, appendFileSync } from "fs";
+import { join, dirname } from "path";
+import { randomUUID } from "crypto";
+
+type OutputFormat = "markdown" | "json";
+
+interface SkillOptions {
+  brief: string;
+  brand?: string;
+  voice?: string;
+  audience?: string;
+  channels: string[];
+  format: OutputFormat;
+  model: string;
+  output?: string;
+}
+
+interface OpenAIChatResponse {
+  choices?: Array<{
+    message?: {
+      content?: string | null;
+    };
+  }>;
+  error?: {
+    message?: string;
+  };
+}
+
+const SKILL_SLUG = "brand-style-guide";
+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) || "brand";
+}
+
+function parseOptions(): SkillOptions {
+  const { values, positionals } = parseArgs({
+    args: Bun.argv.slice(2),
+    options: {
+      brand: { type: "string" },
+      voice: { type: "string" },
+      audience: { type: "string" },
+      channels: { type: "string", default: "web,mobile,email,social" },
+      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(`
+Brand Style Guide - Generates comprehensive brand guidelines
+
+Usage:
+  skills run brand-style-guide -- [options] <brief>
+
+Options:
+  --brief <string>     Creative brief (or use positional arg)
+  --brand <string>     Brand name
+  --voice <string>     Voice description
+  --audience <string>  Target audience
+  --channels <list>    Comma-separated channels (default: web,mobile,email,social)
+  --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);
+  }
+
+  const brief = positionals.join(" ").trim();
+
+  if (!brief) {
+    throw new Error(
+      "A creative brief is required.\nExample: skills run brand-style-guide -- \"AI writing assistant for marketers\""
+    );
+  }
+
+  const format: OutputFormat =
+    values.format === "json" ? "json" : values.format === "markdown" ? "markdown" : "markdown";
+
+  const channels = values.channels
+    ? (values.channels as string)
+        .split(",")
+        .map((c) => c.trim())
+        .filter(Boolean)
+    : ["web", "mobile", "email", "social"];
+
+  return {
+    brief,
+    brand: values.brand as string,
+    voice: values.voice as string,
+    audience: values.audience as string,
+    channels: channels.length > 0 ? channels : ["web", "mobile", "email", "social"],
+    format,
+    model: values.model as string,
+    output: values.output as string,
+  };
+}
+
+function buildPrompt(options: SkillOptions) {
+  const system = `You are an award-winning brand strategist and creative director.
+Produce a complete, actionable brand style guide that includes:
+- Brand essence and positioning
+- Voice & tone (with do/don't examples)
+- Audience insights
+- Visual direction (color palette with accessibility notes, typography, imagery, iconography)
+- Channel-specific applications for each requested channel
+- Asset checklist and governance tips.
+`;
+
+  const userDetails = {
+    request: "Create a brand style guide",
+    brief: options.brief,
+    brand: options.brand,
+    voice: options.voice,
+    audience: options.audience,
+    channels: options.channels,
+    format: options.format,
+  };
+
+  const user =
+    (options.format === "json"
+      ? "Respond in JSON with keys: overview, voice, audience, visual_identity, channel_applications, asset_checklist, governance. Use structured subfields.\n\n"
+      : "Respond in polished Markdown with an executive summary blockquote, clear headings, tables, and action lists.\n\n") +
+    JSON.stringify(userDetails, 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.6,
+    max_tokens: options.format === "json" ? 2500 : 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(filePath: string, content: string) {
+  ensureDir(dirname(filePath));
+  await Bun.write(filePath, content);
+}
+
+async function run() {
+  const { sessionStamp, skillExportsDir, skillLogsDir } = getPaths();
+  const logger = createLogger(skillLogsDir, sessionStamp);
+
+  try {
+    logger.info(`Starting ${SKILL_SLUG} session: ${SESSION_ID}`);
+    const options = parseOptions();
+    logger.info("Starting brand-style-guide generation.");
+    logger.info(`Format: ${options.format.toUpperCase()}, Model: ${options.model}`);
+
+    const { system, user } = buildPrompt(options);
+    const content = await callOpenAI(options, system, user);
+
+    const brandSlug = slugify(options.brand || options.brief.split(/\s+/).slice(0, 3).join("-"));
+    const extension = options.format === "json" ? "json" : "md";
+
+    const targetPath =
+      options.output ||
+      join(skillExportsDir, `brand-style-guide-${brandSlug}-${sessionStamp}.${extension}`);
+
+    let finalContent = content;
+
+    if (options.format === "json") {
+      try {
+        finalContent = JSON.stringify(JSON.parse(content), null, 2);
+      } catch {
+        logger.error("Model response was not valid JSON. Wrapping response.");
+        finalContent = JSON.stringify({ raw: content }, null, 2);
+      }
+    }
+
+    await writeExport(targetPath, finalContent);
+
+    logger.success("Brand style guide generated successfully.");
+
+    console.log("\n=== Brand Style Guide Preview ===\n");
+    console.log(finalContent.slice(0, 1500));
+    if (finalContent.length > 1500) {
+      console.log("\n… (truncated)");
+    }
+    console.log(`\nExport saved to: ${targetPath}`);
+    console.log(`Logs written to: ${skillLogsDir}`);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(message);
+    process.exit(1);
+  }
+}
+
+run();

package/skills/skill-brand-style-guide/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "types": ["bun"],
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": "."
+  },
+  "include": ["bin/**/*", "src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/skills/skill-brand-voice-audit/CLAUDE.md

@@ -0,0 +1,19 @@
+# skill-brand-voice-audit
+
+Brand Voice Audit skill.
+
+## Tech Stack
+
+- Runtime: Bun
+- Language: TypeScript
+- CLI: Commander.js
+
+## CLI
+
+```bash
+skill-brand-voice-audit run
+```
+
+## Data Directory
+
+~/.skill/skill-brand-voice-audit/

package/skills/skill-brand-voice-audit/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@hasnaxyz/skill-brand-voice-audit",
+  "version": "0.1.0",
+  "description": "Brand Voice Audit skill",
+  "type": "module",
+  "bin": {
+    "skill-brand-voice-audit": "./bin/cli.ts"
+  },
+  "scripts": {
+    "dev": "bun run bin/cli.ts",
+    "build": "bun build bin/cli.ts --outdir dist --target node",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "commander": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": ["bin", "src", "tsconfig.json"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hasnaxyz/skill-brand-voice-audit.git"
+  },
+  "author": "Hasna",
+  "license": "MIT"
+}

package/skills/skill-brand-voice-audit/src/index.ts

@@ -0,0 +1,302 @@
+#!/usr/bin/env bun
+/**
+ * skill-brand-voice-audit
+ * Audits brand copy against desired voice attributes 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";
+
+interface SkillOptions {
+  brief: string;
+  samplePath?: string;
+  text?: string;
+  attributes?: string;
+  audience?: string;
+  format: OutputFormat;
+  model: string;
+  output?: string;
+}
+
+interface OpenAIChatResponse {
+  choices?: Array<{
+    message?: {
+      content?: string | null;
+    };
+  }>;
+  error?: {
+    message?: string;
+  };
+}
+
+const SKILL_SLUG = "brand-voice-audit";
+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) || "voice-audit";
+}
+
+function parseOptions(): SkillOptions {
+  const { values, positionals } = parseArgs({
+    args: Bun.argv.slice(2),
+    options: {
+      sample: { type: "string" },
+      text: { type: "string" },
+      attributes: { type: "string" },
+      audience: { 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(`
+Brand Voice Audit - Audits brand copy against desired voice attributes
+
+Usage:
+  skills run brand-voice-audit -- [options] <voice-description>
+
+Options:
+  --sample <file>      Path to copy sample file
+  --text <string>      Raw copy text
+  --attributes <list>  Specific attributes to check
+  --audience <string>  Target audience
+  --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);
+  }
+
+  const brief = positionals.join(" ").trim();
+
+  if (!brief) {
+    throw new Error(
+      "A voice description is required.\nExample: skills run brand-voice-audit -- \"Voice: confident, helpful\" --sample ./copy.txt"
+    );
+  }
+
+  if (!values.sample && !values.text) {
+    throw new Error("Provide copy to audit via --sample <file> or --text \"...\".");
+  }
+
+  const format: OutputFormat =
+    values.format === "json" ? "json" : values.format === "markdown" ? "markdown" : "markdown";
+
+  return {
+    brief,
+    samplePath: values.sample as string,
+    text: values.text as string,
+    attributes: values.attributes as string,
+    audience: values.audience as string,
+    format,
+    model: values.model as string,
+    output: values.output as string,
+  };
+}
+
+function loadCopyText(options: SkillOptions): string {
+  let content = "";
+
+  if (options.samplePath) {
+    const resolved = resolve(options.samplePath);
+    if (!existsSync(resolved)) {
+      throw new Error(`Sample file not found: ${resolved}`);
+    }
+    content += readFileSync(resolved, "utf-8");
+  }
+
+  if (options.text) {
+    content += (content ? "\n\n" : "") + options.text;
+  }
+
+  return content.trim();
+}
+
+function buildPrompt(options: SkillOptions, copy: string) {
+  const system = `You are a brand voice strategist and copy editor.
+Audit the provided copy against the requested voice attributes. Produce:
+- Voice alignment scores (0-10) for each attribute
+- Strengths: where copy aligns well
+- Risks: inconsistencies, tone drifts, jargon, clarity issues
+- Rewrite examples: headline + paragraph variations matching desired voice
+- Guardrails: do/don't list for future writers
+- Checklist: reminders for editors and QA`;
+
+  const instructions =
+    options.format === "json"
+      ? "Respond in JSON with keys: summary, scores, strengths, risks, rewrites, guardrails, checklist. Scores array should include attribute, requested_trait, score, rationale."
+      : "Respond in polished Markdown. Start with an executive summary blockquote, use tables for attribute scores, and bullet lists for strengths/risks.";
+
+  const userPayload = {
+    request: "Audit brand voice alignment",
+    voice_description: options.brief,
+    explicit_attributes: options.attributes,
+    audience_context: options.audience,
+    copy_sample: copy,
+    format: options.format,
+  };
+
+  const user = `${instructions}\n\n${JSON.stringify(userPayload, 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.35,
+    max_tokens: options.format === "json" ? 2200 : 1900,
+  };
+
+  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);
+}
+
+async function run() {
+  const { sessionStamp, skillExportsDir, skillLogsDir } = getPaths();
+  const logger = createLogger(skillLogsDir, sessionStamp);
+
+  try {
+    logger.info(`Starting ${SKILL_SLUG} session: ${SESSION_ID}`);
+    const options = parseOptions();
+    const copy = loadCopyText(options);
+
+    if (!copy) {
+      throw new Error("The provided copy sample is empty.");
+    }
+
+    logger.info("Starting brand voice audit.");
+    logger.info(`Format: ${options.format.toUpperCase()}, Model: ${options.model}`);
+
+    const { system, user } = buildPrompt(options, copy);
+    const content = await callOpenAI(options, system, user);
+
+    const slugBase = options.attributes || options.brief.split(/\s+/).slice(0, 3).join("-");
+    const reportSlug = slugify(slugBase);
+    const extension = options.format === "json" ? "json" : "md";
+    const defaultPath = join(skillExportsDir, `brand-voice-audit-${reportSlug}-${sessionStamp}.${extension}`);
+    const targetPath = options.output ? options.output : defaultPath;
+
+    let finalContent = content;
+
+    if (options.format === "json") {
+      try {
+        finalContent = JSON.stringify(JSON.parse(content), null, 2);
+      } catch {
+        logger.error("Model response was not valid JSON. Wrapping raw response.");
+        finalContent = JSON.stringify({ raw: content }, null, 2);
+      }
+    }
+
+    await writeExport(targetPath, finalContent);
+
+    logger.success("Brand voice audit completed.");
+    console.log("\n=== Voice Audit Preview ===\n");
+    console.log(finalContent.slice(0, 1500));
+    if (finalContent.length > 1500) {
+      console.log("\n… (truncated)");
+    }
+    console.log(`\nExport saved to: ${targetPath}`);
+    console.log(`Logs written to: ${skillLogsDir}`);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.error(message);
+    process.exit(1);
+  }
+}
+
+run();

package/skills/skill-brand-voice-audit/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "declaration": true,
+    "types": ["bun-types"]
+  },
+  "include": ["src/**/*", "bin/**/*"]
+}

package/skills/skill-browse/.env.example

@@ -0,0 +1,14 @@
+# Browser-Use API Configuration
+# Copy this file to .env and fill in your API key
+
+# Browser-Use Cloud API Key
+# Get your key from: https://cloud.browser-use.com/billing
+BROWSER_USE_API_KEY=bu_xxx...
+
+# Default LLM Model (optional)
+# Options: gpt-4o, o3, claude-sonnet-4, etc.
+# BROWSER_USE_MODEL=gpt-4o
+
+# Default proxy settings (optional)
+# BROWSER_USE_PROXY=true
+# BROWSER_USE_PROXY_COUNTRY=us