@hasna/skills 0.0.2 → 0.0.4

package/skills/skill-read-gmail/src/index.ts

@@ -1,343 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Read Gmail Skill
- * Read and search emails from Gmail using OAuth access token
- */
-
-import { parseArgs } from "util";
-
-// Gmail API base URL
-const GMAIL_API_BASE = "https://gmail.googleapis.com/gmail/v1/users/me";
-
-// Types
-interface GmailMessage {
-  id: string;
-  threadId: string;
-  labelIds?: string[];
-  snippet?: string;
-  internalDate?: string;
-  payload?: {
-    headers?: Array<{ name: string; value: string }>;
-    body?: { data?: string };
-    parts?: Array<{
-      mimeType: string;
-      body?: { data?: string };
-      parts?: Array<{ mimeType: string; body?: { data?: string } }>;
-    }>;
-    mimeType?: string;
-  };
-}
-
-interface ListMessagesResponse {
-  messages?: Array<{ id: string; threadId: string }>;
-  nextPageToken?: string;
-  resultSizeEstimate?: number;
-}
-
-interface FormattedMessage {
-  id: string;
-  threadId: string;
-  from?: string;
-  to?: string;
-  subject?: string;
-  date?: string;
-  snippet?: string;
-  labelIds?: string[];
-  body?: {
-    text?: string;
-    html?: string;
-  };
-}
-
-// Get access token from environment
-function getAccessToken(): string {
-  const token = process.env.GMAIL_ACCESS_TOKEN;
-  if (!token) {
-    console.error("Error: Gmail not connected.");
-    console.error("");
-    console.error("To use this skill, you need to connect your Gmail account:");
-    console.error("1. Go to https://skills.md/dashboard/connectors");
-    console.error("2. Click 'Connect' on the Gmail connector");
-    console.error("3. Authorize access to your Gmail account");
-    process.exit(1);
-  }
-  return token;
-}
-
-// Make authenticated Gmail API request
-async function gmailRequest<T>(endpoint: string, accessToken: string): Promise<T> {
-  const response = await fetch(`${GMAIL_API_BASE}${endpoint}`, {
-    headers: {
-      Authorization: `Bearer ${accessToken}`,
-      Accept: "application/json",
-    },
-  });
-
-  if (!response.ok) {
-    const error = await response.json().catch(() => ({}));
-    if (response.status === 401) {
-      console.error("Error: Gmail access token expired or invalid.");
-      console.error("Please reconnect your Gmail account in the Connectors dashboard.");
-      process.exit(1);
-    }
-    throw new Error(error.error?.message || `Gmail API error: ${response.status}`);
-  }
-
-  return response.json();
-}
-
-// List messages
-async function listMessages(
-  accessToken: string,
-  options: {
-    query?: string;
-    maxResults: number;
-    labelIds?: string;
-    pageToken?: string;
-  }
-): Promise<ListMessagesResponse> {
-  const params = new URLSearchParams();
-  params.set("maxResults", options.maxResults.toString());
-
-  if (options.query) {
-    params.set("q", options.query);
-  }
-  if (options.labelIds) {
-    params.set("labelIds", options.labelIds);
-  }
-  if (options.pageToken) {
-    params.set("pageToken", options.pageToken);
-  }
-
-  return gmailRequest(`/messages?${params.toString()}`, accessToken);
-}
-
-// Get single message with metadata
-async function getMessage(
-  accessToken: string,
-  messageId: string,
-  format: "metadata" | "full" = "metadata"
-): Promise<GmailMessage> {
-  const metadataHeaders = "metadataHeaders=From&metadataHeaders=To&metadataHeaders=Subject&metadataHeaders=Date";
-  const endpoint = format === "full"
-    ? `/messages/${messageId}?format=full`
-    : `/messages/${messageId}?format=metadata&${metadataHeaders}`;
-
-  return gmailRequest(endpoint, accessToken);
-}
-
-// Extract header value
-function getHeader(message: GmailMessage, name: string): string | undefined {
-  const headers = message.payload?.headers || [];
-  return headers.find((h) => h.name.toLowerCase() === name.toLowerCase())?.value;
-}
-
-// Extract body from message
-function extractBody(message: GmailMessage): { text?: string; html?: string } {
-  let textBody = "";
-  let htmlBody = "";
-
-  const extractPart = (part: {
-    mimeType: string;
-    body?: { data?: string };
-    parts?: Array<{ mimeType: string; body?: { data?: string } }>;
-  }) => {
-    if (part.mimeType === "text/plain" && part.body?.data) {
-      textBody = Buffer.from(part.body.data, "base64").toString("utf-8");
-    } else if (part.mimeType === "text/html" && part.body?.data) {
-      htmlBody = Buffer.from(part.body.data, "base64").toString("utf-8");
-    } else if (part.parts) {
-      part.parts.forEach(extractPart);
-    }
-  };
-
-  if (message.payload?.parts) {
-    message.payload.parts.forEach(extractPart);
-  } else if (message.payload?.body?.data) {
-    const decoded = Buffer.from(message.payload.body.data, "base64").toString("utf-8");
-    if (message.payload.mimeType === "text/html") {
-      htmlBody = decoded;
-    } else {
-      textBody = decoded;
-    }
-  }
-
-  return { text: textBody || undefined, html: htmlBody || undefined };
-}
-
-// Format message for output
-function formatMessage(message: GmailMessage, includeFull: boolean = false): FormattedMessage {
-  const formatted: FormattedMessage = {
-    id: message.id,
-    threadId: message.threadId,
-    from: getHeader(message, "From"),
-    to: getHeader(message, "To"),
-    subject: getHeader(message, "Subject"),
-    date: getHeader(message, "Date"),
-    snippet: message.snippet,
-    labelIds: message.labelIds,
-  };
-
-  if (includeFull) {
-    formatted.body = extractBody(message);
-  }
-
-  return formatted;
-}
-
-// Format output for display
-function formatTextOutput(messages: FormattedMessage[], includeFull: boolean): string {
-  if (messages.length === 0) {
-    return "No messages found.";
-  }
-
-  const lines: string[] = ["=== Gmail Messages ===", ""];
-
-  messages.forEach((msg, index) => {
-    lines.push(`[${index + 1}] From: ${msg.from || "Unknown"}`);
-    lines.push(`    Subject: ${msg.subject || "(no subject)"}`);
-    lines.push(`    Date: ${msg.date || "Unknown"}`);
-
-    if (msg.labelIds?.length) {
-      lines.push(`    Labels: ${msg.labelIds.join(", ")}`);
-    }
-
-    if (includeFull && msg.body?.text) {
-      lines.push(`    ---`);
-      lines.push(`    ${msg.body.text.slice(0, 500)}${msg.body.text.length > 500 ? "..." : ""}`);
-    } else if (msg.snippet) {
-      lines.push(`    Preview: ${msg.snippet}`);
-    }
-
-    lines.push(`    ID: ${msg.id}`);
-    lines.push("");
-  });
-
-  return lines.join("\n");
-}
-
-// Main function
-async function main() {
-  const { values, positionals } = parseArgs({
-    args: Bun.argv.slice(2),
-    options: {
-      query: { type: "string", short: "q" },
-      max: { type: "string", default: "10" },
-      id: { type: "string" },
-      label: { type: "string" },
-      format: { type: "string", default: "text" },
-      full: { type: "boolean", default: false },
-      help: { type: "boolean", short: "h" },
-    },
-    allowPositionals: true,
-  });
-
-  // Show help
-  if (values.help) {
-    console.log(`
-Read Gmail - Read and search emails from your Gmail inbox
-
-Usage:
-  bun run src/index.ts [options]
-
-Options:
-  --query, -q <query>    Gmail search query (e.g., "from:user@example.com is:unread")
-  --max <number>         Maximum number of emails to return [default: 10]
-  --id <message-id>      Get a specific message by ID
-  --label <label>        Filter by label (INBOX, SENT, UNREAD, STARRED, etc.)
-  --format <format>      Output format: text or json [default: text]
-  --full                 Include full email body
-  --help, -h             Show this help
-
-Examples:
-  # List recent emails
-  bun run src/index.ts
-
-  # Search emails
-  bun run src/index.ts --query "from:boss@company.com"
-
-  # Get unread emails
-  bun run src/index.ts --query "is:unread" --max 20
-
-  # Read specific email
-  bun run src/index.ts --id abc123 --full
-
-  # Output as JSON
-  bun run src/index.ts --format json
-`);
-    process.exit(0);
-  }
-
-  const accessToken = getAccessToken();
-  const maxResults = Math.min(parseInt(values.max as string, 10) || 10, 100);
-  const outputFormat = values.format as string;
-  const includeFull = values.full as boolean;
-
-  try {
-    // Get specific message by ID
-    if (values.id) {
-      const message = await getMessage(accessToken, values.id as string, includeFull ? "full" : "metadata");
-      const formatted = formatMessage(message, includeFull);
-
-      if (outputFormat === "json") {
-        console.log(JSON.stringify(formatted, null, 2));
-      } else {
-        console.log(formatTextOutput([formatted], includeFull));
-      }
-      return;
-    }
-
-    // List messages
-    const listResult = await listMessages(accessToken, {
-      query: values.query as string | undefined,
-      maxResults,
-      labelIds: values.label as string | undefined,
-    });
-
-    if (!listResult.messages || listResult.messages.length === 0) {
-      if (outputFormat === "json") {
-        console.log(JSON.stringify({ messages: [], resultSizeEstimate: 0 }, null, 2));
-      } else {
-        console.log("No messages found.");
-      }
-      return;
-    }
-
-    // Fetch details for each message (limit to avoid rate limits)
-    const messagesToFetch = listResult.messages.slice(0, Math.min(maxResults, 20));
-    const messages = await Promise.all(
-      messagesToFetch.map(async (msg) => {
-        try {
-          const fullMsg = await getMessage(accessToken, msg.id, includeFull ? "full" : "metadata");
-          return formatMessage(fullMsg, includeFull);
-        } catch (error) {
-          return {
-            id: msg.id,
-            threadId: msg.threadId,
-            error: "Failed to fetch message details",
-          } as FormattedMessage;
-        }
-      })
-    );
-
-    // Output results
-    if (outputFormat === "json") {
-      console.log(JSON.stringify({
-        messages,
-        nextPageToken: listResult.nextPageToken,
-        resultSizeEstimate: listResult.resultSizeEstimate,
-      }, null, 2));
-    } else {
-      console.log(formatTextOutput(messages, includeFull));
-      if (listResult.resultSizeEstimate && listResult.resultSizeEstimate > messages.length) {
-        console.log(`Showing ${messages.length} of ~${listResult.resultSizeEstimate} messages.`);
-        console.log(`Use --max to fetch more messages.`);
-      }
-    }
-  } catch (error) {
-    console.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
-    process.exit(1);
-  }
-}
-
-main();

package/skills/skill-read-gmail/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "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-remember/LICENSE

@@ -1,21 +0,0 @@
-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-remember/README.md

@@ -1,17 +0,0 @@
-# skill-remember
-
-Persistent memory across sessions - store context, preferences, decisions
-
-## Overview
-
-This skill provides capabilities for persistent memory across sessions - store context, preferences, decisions.
-
-## Usage
-
-```bash
-# Coming soon
-```
-
-## Development
-
-See `.implementation/` for development notes and todos.

package/skills/skill-remember/install.sh

@@ -1,112 +0,0 @@
-#!/usr/bin/env bash
-
-# Install script for skills
-# Installs the skill either globally for Claude Code or locally in a project
-
-set -e
-
-SKILL_NAME="$(basename "$(pwd)")"
-SKILL_PATH="$(pwd)"
-
-echo "📦 Installing $SKILL_NAME..."
-echo ""
-
-# Check if Claude Code is installed
-if ! command -v claude &> /dev/null; then
-    echo "⚠️  Claude Code not found in PATH"
-    echo "   Please install Claude Code first: https://claude.com/claude-code"
-    exit 1
-fi
-
-# Check if we're in a git repository
-if git rev-parse --git-dir > /dev/null 2>&1; then
-    IN_REPO=true
-    REPO_ROOT="$(git rev-parse --show-toplevel)"
-    echo "📁 Detected git repository: $REPO_ROOT"
-else
-    IN_REPO=false
-    echo "📁 Not in a git repository"
-fi
-
-# Ask installation type
-echo ""
-echo "Where would you like to install this skill?"
-if [ "$IN_REPO" = true ]; then
-    echo "  1) Locally (this repository only)"
-    echo "  2) Globally (all Claude Code sessions)"
-    read -p "Choose [1/2]: " choice
-else
-    echo "  Installing globally (not in a git repository)"
-    choice=2
-fi
-
-# Install function
-install_skill() {
-    local config_dir=$1
-    local config_file="$config_dir/claude_mcp_config.json"
-
-    # Create config directory if it doesn't exist
-    mkdir -p "$config_dir"
-
-    # Create or update config file
-    if [ ! -f "$config_file" ]; then
-        echo "{" > "$config_file"
-        echo '  "mcpServers": {}' >> "$config_file"
-        echo "}" >> "$config_file"
-    fi
-
-    # Add skill to config using bun
-    bun -e "
-    const fs = require('fs');
-    const config = JSON.parse(fs.readFileSync('$config_file', 'utf8'));
-
-    if (!config.mcpServers) config.mcpServers = {};
-
-    config.mcpServers['$SKILL_NAME'] = {
-      command: 'bun',
-      args: ['run', '$SKILL_PATH/src/index.ts'],
-      env: {
-        SKILL_API_KEY: process.env.SKILL_API_KEY || '',
-        ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY || '',
-        OPENAI_API_KEY: process.env.OPENAI_API_KEY || '',
-        ELEVENLABS_API_KEY: process.env.ELEVENLABS_API_KEY || '',
-        GEMINI_API_KEY: process.env.GEMINI_API_KEY || '',
-        XAI_API_KEY: process.env.XAI_API_KEY || '',
-        GOOGLE_API_KEY: process.env.GOOGLE_API_KEY || '',
-        GOOGLE_PROJECT_ID: process.env.GOOGLE_PROJECT_ID || '',
-        BROWSER_USE_API_KEY: process.env.BROWSER_USE_API_KEY || '',
-        RUNWAY_API_KEY: process.env.RUNWAY_API_KEY || ''
-      }
-    };
-
-    fs.writeFileSync('$config_file', JSON.stringify(config, null, 2));
-    "
-
-    echo "✅ Installed $SKILL_NAME to $config_file"
-}
-
-# Install based on choice
-if [ "$choice" = "1" ]; then
-    # Local installation
-    install_skill "$REPO_ROOT/.claude"
-    echo ""
-    echo "🎉 $SKILL_NAME installed locally!"
-    echo "   Config: $REPO_ROOT/.claude/claude_mcp_config.json"
-elif [ "$choice" = "2" ]; then
-    # Global installation
-    install_skill "$HOME/.config/claude-code"
-    echo ""
-    echo "🎉 $SKILL_NAME installed globally!"
-    echo "   Config: $HOME/.config/claude-code/claude_mcp_config.json"
-else
-    echo "❌ Invalid choice"
-    exit 1
-fi
-
-echo ""
-echo "📝 Next steps:"
-echo "   1. Restart Claude Code"
-echo "   2. The skill will be available as: $SKILL_NAME"
-echo ""
-echo "   Usage: Claude Code will automatically detect and use this skill"
-echo "          based on your prompts and task context."

package/skills/skill-remember/package.json

@@ -1,31 +0,0 @@
-{
-  "name": "skill-remember",
-  "version": "1.0.0",
-  "description": "Persistent memory across sessions - store context, preferences, decisions",
-  "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "skill-remember": "src/index.ts"
-  },
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "dev": "bun run --watch src/index.ts"
-  },
-  "keywords": [
-    "claude",
-    "ai",
-    "skill"
-  ],
-  "author": "",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/bun": "latest"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/hasnaxyz/skill-remember.git"
-  }
-}

package/skills/skill-remember/src/auth.ts

@@ -1,49 +0,0 @@
-/**
- * Skill Authentication Check
- * Add this to the top of any skill's main function
- */
-
-export function checkSkillAuth(): void {
-  const SKILL_API_KEY = process.env.SKILL_API_KEY;
-  
-  // Check if SKILL_API_KEY is set
-  if (!SKILL_API_KEY) {
-    console.error('❌ Error: SKILL_API_KEY environment variable not set');
-    console.error('');
-    console.error('To use this skill, you must set your SKILL_API_KEY:');
-    console.error('');
-    console.error('  export SKILL_API_KEY=your-api-key-here');
-    console.error('');
-    console.error('Contact your administrator to get your API key.');
-    process.exit(1);
-  }
-
-  // Validate key format
-  if (!SKILL_API_KEY.startsWith('sk-skill-')) {
-    console.error('❌ Error: Invalid SKILL_API_KEY format');
-    console.error('Expected format: sk-skill-xxxxxxxxxxxx');
-    process.exit(1);
-  }
-
-  // Key is valid - skill can proceed
-}
-
-/**
- * Check if running remotely (via SSH or network)
- */
-export function isRemoteExecution(): boolean {
-  return !!(
-    process.env.SSH_CONNECTION ||
-    process.env.SSH_CLIENT ||
-    process.env.SSH_TTY
-  );
-}
-
-/**
- * Require auth only if remote execution
- */
-export function requireAuthIfRemote(): void {
-  if (isRemoteExecution()) {
-    checkSkillAuth();
-  }
-}