@hasna/skills 0.0.2

package/skills/skill-codefix/src/types.ts

@@ -0,0 +1,211 @@
+/**
+ * Type definitions for skill-codefix
+ */
+
+export type Language =
+  | 'typescript'
+  | 'javascript'
+  | 'python'
+  | 'go'
+  | 'rust'
+  | 'java'
+  | 'c'
+  | 'cpp'
+  | 'csharp'
+  | 'ruby'
+  | 'php'
+  | 'swift'
+  | 'kotlin'
+  | 'shell'
+  | 'sql'
+  | 'html'
+  | 'css'
+  | 'json'
+  | 'yaml'
+  | 'markdown'
+  | 'auto';
+
+export type FixType =
+  | 'lint'        // Fix linting issues
+  | 'format'      // Format/prettify code
+  | 'types'       // Fix type errors (TypeScript)
+  | 'imports'     // Organize and fix imports
+  | 'style'       // Fix style guide violations
+  | 'security'    // Fix security issues
+  | 'perf'        // Fix performance issues
+  | 'docs'        // Add/fix documentation
+  | 'all';        // Run all applicable fixes
+
+export type Severity = 'error' | 'warning' | 'info' | 'hint';
+
+export interface Issue {
+  line: number;
+  column: number;
+  message: string;
+  rule?: string;
+  severity: Severity;
+  fixable: boolean;
+  fix?: string;
+}
+
+export interface FixOptions {
+  /** File or directory to fix */
+  path: string;
+  /** Type of fix to apply */
+  type: FixType;
+  /** Programming language (auto-detected if not specified) */
+  language?: Language;
+  /** Dry run - show what would be fixed without making changes */
+  dryRun?: boolean;
+  /** Fix files in place */
+  write?: boolean;
+  /** Output fixed content to a different path */
+  output?: string;
+  /** Show diff of changes */
+  diff?: boolean;
+  /** Ignore patterns (glob) */
+  ignore?: string[];
+  /** Include hidden files */
+  includeHidden?: boolean;
+  /** Config file path (eslint, prettier, etc.) */
+  config?: string;
+  /** Be verbose */
+  verbose?: boolean;
+}
+
+export interface AnalyzeOptions {
+  /** File or directory to analyze */
+  path: string;
+  /** Programming language (auto-detected if not specified) */
+  language?: Language;
+  /** Types of issues to check for */
+  types?: FixType[];
+  /** Output format */
+  format?: 'text' | 'json' | 'github';
+  /** Show only errors */
+  errorsOnly?: boolean;
+  /** Ignore patterns (glob) */
+  ignore?: string[];
+}
+
+export interface FixResult {
+  success: boolean;
+  path: string;
+  language: Language;
+  issuesFound: number;
+  issuesFixed: number;
+  issues: Issue[];
+  diff?: string;
+  error?: string;
+}
+
+export interface AnalyzeResult {
+  success: boolean;
+  path: string;
+  language: Language;
+  issues: Issue[];
+  summary: {
+    errors: number;
+    warnings: number;
+    info: number;
+    hints: number;
+    fixable: number;
+  };
+}
+
+export interface FileResult {
+  file: string;
+  result: FixResult | AnalyzeResult;
+}
+
+export interface BatchResult {
+  success: boolean;
+  filesProcessed: number;
+  filesWithIssues: number;
+  totalIssues: number;
+  totalFixed: number;
+  results: FileResult[];
+  duration: number;
+}
+
+/** Language-specific fixer configuration */
+export interface FixerConfig {
+  language: Language;
+  extensions: string[];
+  lintCommand?: string;
+  formatCommand?: string;
+  typeCheckCommand?: string;
+}
+
+/** Built-in fixer configurations */
+export const FIXER_CONFIGS: Record<string, FixerConfig> = {
+  typescript: {
+    language: 'typescript',
+    extensions: ['.ts', '.tsx', '.mts', '.cts'],
+    lintCommand: 'eslint --fix',
+    formatCommand: 'prettier --write',
+    typeCheckCommand: 'tsc --noEmit',
+  },
+  javascript: {
+    language: 'javascript',
+    extensions: ['.js', '.jsx', '.mjs', '.cjs'],
+    lintCommand: 'eslint --fix',
+    formatCommand: 'prettier --write',
+  },
+  python: {
+    language: 'python',
+    extensions: ['.py', '.pyi'],
+    lintCommand: 'ruff check --fix',
+    formatCommand: 'ruff format',
+    typeCheckCommand: 'mypy',
+  },
+  go: {
+    language: 'go',
+    extensions: ['.go'],
+    lintCommand: 'golangci-lint run --fix',
+    formatCommand: 'gofmt -w',
+  },
+  rust: {
+    language: 'rust',
+    extensions: ['.rs'],
+    lintCommand: 'cargo clippy --fix --allow-dirty',
+    formatCommand: 'cargo fmt',
+  },
+  json: {
+    language: 'json',
+    extensions: ['.json', '.jsonc'],
+    formatCommand: 'prettier --write',
+  },
+  yaml: {
+    language: 'yaml',
+    extensions: ['.yaml', '.yml'],
+    formatCommand: 'prettier --write',
+  },
+  markdown: {
+    language: 'markdown',
+    extensions: ['.md', '.mdx'],
+    formatCommand: 'prettier --write',
+  },
+  html: {
+    language: 'html',
+    extensions: ['.html', '.htm'],
+    formatCommand: 'prettier --write',
+  },
+  css: {
+    language: 'css',
+    extensions: ['.css', '.scss', '.sass', '.less'],
+    lintCommand: 'stylelint --fix',
+    formatCommand: 'prettier --write',
+  },
+  shell: {
+    language: 'shell',
+    extensions: ['.sh', '.bash', '.zsh'],
+    lintCommand: 'shellcheck',
+    formatCommand: 'shfmt -w',
+  },
+  sql: {
+    language: 'sql',
+    extensions: ['.sql'],
+    formatCommand: 'sql-formatter',
+  },
+};

package/skills/skill-codefix/tsconfig.json

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

package/skills/skill-color-palette-harmonizer/CLAUDE.md

@@ -0,0 +1,19 @@
+# skill-color-palette-harmonizer
+
+Color Palette Harmonizer skill.
+
+## Tech Stack
+
+- Runtime: Bun
+- Language: TypeScript
+- CLI: Commander.js
+
+## CLI
+
+```bash
+skill-color-palette-harmonizer run
+```
+
+## Data Directory
+
+~/.skill/skill-color-palette-harmonizer/

package/skills/skill-color-palette-harmonizer/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@hasnaxyz/skill-color-palette-harmonizer",
+  "version": "0.1.0",
+  "description": "Color Palette Harmonizer skill",
+  "type": "module",
+  "bin": {
+    "skill-color-palette-harmonizer": "./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-color-palette-harmonizer.git"
+  },
+  "author": "Hasna",
+  "license": "MIT"
+}

package/skills/skill-color-palette-harmonizer/src/index.ts

@@ -0,0 +1,278 @@
+#!/usr/bin/env bun
+/**
+ * skill-color-palette-harmonizer
+ * Generates accessible color palette systems using OpenAI.
+ */
+
+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;
+  base?: string;
+  constraints?: string;
+  channels: string[];
+  format: OutputFormat;
+  model: string;
+  output?: string;
+}
+
+interface OpenAIChatResponse {
+  choices?: Array<{
+    message?: {
+      content?: string | null;
+    };
+  }>;
+  error?: {
+    message?: string;
+  };
+}
+
+const SKILL_SLUG = "color-palette-harmonizer";
+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) || "palette";
+}
+
+function parseOptions(): SkillOptions {
+  const { values, positionals } = parseArgs({
+    args: Bun.argv.slice(2),
+    options: {
+      base: { type: "string" },
+      constraints: { type: "string" },
+      channels: { type: "string", default: "web,mobile,print" },
+      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(`
+Color Palette Harmonizer - Generates accessible color palette systems
+
+Usage:
+  skills run color-palette-harmonizer -- [options] <brief>
+
+Options:
+  --brief <string>     Palette brief or mood description (or use positional arg)
+  --base <string>      Base colors
+  --constraints <string> Constraints
+  --channels <list>    Comma-separated channels (default: web,mobile,print)
+  --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 palette brief or mood description is required.\nExample: skills run color-palette-harmonizer -- \"Warm, inclusive health brand\""
+    );
+  }
+
+  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", "print"];
+
+  return {
+    brief,
+    base: values.base as string,
+    constraints: values.constraints as string,
+    channels: channels.length > 0 ? channels : ["web", "mobile", "print"],
+    format,
+    model: values.model as string,
+    output: values.output as string,
+  };
+}
+
+function buildPrompt(options: SkillOptions) {
+  const system = `You are a color systems designer and accessibility specialist.
+Generate a cohesive palette including:
+- Primary, secondary, accent, neutral, semantic colors (with HEX + optional RGB)
+- Accessibility scores (WCAG AA/AAA) for light/dark text combinations
+- Usage guidance (UI tokens, backgrounds, surface, typography)
+- Gradient suggestions and overlay ideas
+- Color pairing matrix
+- Application notes across provided channels
+- Guardrails: what to avoid to prevent vibrational clashes or brand drift`;
+
+  const instructions =
+    options.format === "json"
+      ? "Respond in JSON with keys: overview, swatches, accessibility, usage, gradients, channels, guardrails. For swatches include name, role, hex, rgb, contrast_on_light, contrast_on_dark."
+      : "Respond in polished Markdown. Begin with an executive summary blockquote, include tables for swatches and contrast ratios, and bullet lists for usage notes.";
+
+  const userPayload = {
+    request: "Create an accessible brand palette",
+    brief: options.brief,
+    base_colors: options.base,
+    constraints: options.constraints,
+    channels: options.channels,
+    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.48,
+    max_tokens: options.format === "json" ? 2300 : 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);
+}
+
+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("Generating color palette system.");
+    logger.info(`Format: ${options.format.toUpperCase()}, Model: ${options.model}`);
+
+    const { system, user } = buildPrompt(options);
+    const content = await callOpenAI(options, system, user);
+
+    const paletteSlug = slugify(options.brief.split(/\s+/).slice(0, 3).join("-"));
+    const extension = options.format === "json" ? "json" : "md";
+    const defaultPath = join(skillExportsDir, `color-palette-${paletteSlug}-${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("Color palette guide generated successfully.");
+    console.log("\n=== Palette 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-color-palette-harmonizer/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-companyguide/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hasna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/skill-companyguide/README.md

@@ -0,0 +1,17 @@
+# skill-companyguide
+
+Access company-related guides and documentation
+
+## Overview
+
+This skill provides capabilities for Access company-related guides and documentation.
+
+## Usage
+
+```bash
+# Coming soon
+```
+
+## Development
+
+See `.implementation/` for development notes and todos.