@hasna/skills 0.0.2 → 0.0.3

package/skills/skill-implementation-memento/src/index.ts

@@ -1,442 +0,0 @@
-#!/usr/bin/env bun
-
-import * as fs from "fs";
-import * as path from "path";
-import minimist from "minimist";
-
-// Types
-interface MementoSection {
-  heading: string;
-  content: string;
-}
-
-interface MementoJsonData {
-  context?: string;
-  sections?: MementoSection[];
-  codeSnippets?: { language?: string; filename?: string; code: string }[];
-  keyPoints?: string[];
-  decisions?: { decision: string; rationale?: string }[];
-  links?: string[];
-  nextSteps?: string[];
-  notes?: string;
-}
-
-interface MementoData {
-  id: string;
-  slug: string;
-  title: string;
-  content: string;
-  category: "code" | "decision" | "context" | "note" | "research";
-  tags: string[];
-  related: string[];
-  created: string;
-  updated: string;
-  jsonData?: MementoJsonData;
-}
-
-// Parse command line arguments
-const args = minimist(process.argv.slice(2), {
-  string: ["slug", "category", "content", "tags", "related", "data"],
-  boolean: ["no-index", "help"],
-  default: {
-    category: "note",
-    "no-index": false,
-  },
-  alias: {
-    s: "slug",
-    c: "content",
-    t: "tags",
-    r: "related",
-    d: "data",
-    h: "help",
-  },
-});
-
-// Show help
-if (args.help) {
-  console.log(`
-Implementation Memento - Create memento files for capturing notes and context
-
-Usage:
-  skills run implementation-memento -- "<title>" [options]
-
-Options:
-  -s, --slug <name>       Slug name for the memento file (required)
-  --category <type>       Category: code, decision, context, note, research (default: note)
-  -c, --content <text>    Additional content/body for the memento
-  -t, --tags <tags>       Comma-separated tags
-  -r, --related <ids>     Related memento/todo/plan IDs (comma-separated)
-  -d, --data <json>       JSON data with sections, code snippets, etc.
-  --no-index              Skip updating MEMENTOS.md index
-  -h, --help              Show this help
-
-JSON Data Format (--data):
-  {
-    "context": "Background context for this memento",
-    "sections": [
-      { "heading": "Overview", "content": "Section content here" },
-      { "heading": "Details", "content": "More details" }
-    ],
-    "codeSnippets": [
-      { "language": "typescript", "filename": "src/index.ts", "code": "const x = 1;" }
-    ],
-    "keyPoints": ["Important point 1", "Important point 2"],
-    "decisions": [
-      { "decision": "Use PostgreSQL", "rationale": "Better JSON support" }
-    ],
-    "links": ["https://docs.example.com"],
-    "nextSteps": ["Review with team", "Create follow-up tasks"],
-    "notes": "Additional notes"
-  }
-
-Examples:
-  skills run implementation-memento -- "API endpoint found" --slug api-discovery
-  skills run implementation-memento -- "DB choice" --slug db-decision --category decision
-  skills run implementation-memento -- "Discovery" --slug discovery --data '{"keyPoints":["Found useful pattern"],"links":["https://example.com"]}'
-`);
-  process.exit(0);
-}
-
-// Get title
-const title = args._[0] as string;
-
-if (!title) {
-  console.error("Error: Title is required");
-  console.error('Usage: skills run implementation-memento -- "<title>" --slug <slug>');
-  process.exit(1);
-}
-
-// Get slug
-const rawSlug = args.slug as string;
-
-if (!rawSlug) {
-  console.error("Error: --slug is required");
-  console.error('Usage: skills run implementation-memento -- "<title>" --slug <slug>');
-  process.exit(1);
-}
-
-// Normalize slug (replace spaces and dashes with underscores)
-const slug = rawSlug.toLowerCase().replace(/[\s-]+/g, "_").replace(/[^a-z0-9_]/g, "");
-
-// Sanitize content for safe inclusion (handle quotes and special chars)
-function sanitizeContent(text: string): string {
-  if (!text) return "";
-  // Normalize line endings and trim
-  return text
-    .replace(/\\n/g, "\n")  // Handle escaped newlines from CLI
-    .replace(/\\t/g, "\t")  // Handle escaped tabs from CLI
-    .trim();
-}
-
-// Get content if provided
-const userContent = args.content ? sanitizeContent(args.content as string) : "";
-
-// Find .implementation directory
-function findImplementationDir(): string | null {
-  // Use SKILLS_CWD if available (user's working directory from remote execution)
-  let currentDir = process.env.SKILLS_CWD || process.cwd();
-
-  while (currentDir !== path.dirname(currentDir)) {
-    const implDir = path.join(currentDir, ".implementation");
-    if (fs.existsSync(implDir)) {
-      return implDir;
-    }
-    currentDir = path.dirname(currentDir);
-  }
-
-  return null;
-}
-
-const implDir = findImplementationDir();
-
-if (!implDir) {
-  console.error("Error: .implementation directory not found");
-  console.error("Run 'skills run implementation-init' first to create the folder structure");
-  process.exit(1);
-}
-
-// Output directory
-const outputDir = path.join(implDir, "data", "mementos");
-
-if (!fs.existsSync(outputDir)) {
-  fs.mkdirSync(outputDir, { recursive: true });
-}
-
-// Get next sequence number
-function getNextSequence(): number {
-  if (!fs.existsSync(outputDir)) return 1;
-
-  const files = fs.readdirSync(outputDir);
-  let maxSeq = 0;
-
-  for (const file of files) {
-    const match = file.match(/^memento_(\d{5})_/);
-    if (match) {
-      const seq = parseInt(match[1], 10);
-      if (seq > maxSeq) maxSeq = seq;
-    }
-  }
-
-  return maxSeq + 1;
-}
-
-const sequence = getNextSequence();
-const mementoId = `memento_${String(sequence).padStart(5, "0")}`;
-const timestamp = new Date().toISOString().split("T")[0];
-
-// Parse JSON data if provided
-let jsonData: MementoJsonData | undefined;
-if (args.data) {
-  try {
-    jsonData = JSON.parse(args.data as string);
-  } catch (e) {
-    console.error("Error: Invalid JSON data provided");
-    console.error("Make sure to escape quotes properly in the shell");
-    process.exit(1);
-  }
-}
-
-// Parse tags
-const tags = args.tags ? (args.tags as string).split(",").map((t: string) => t.trim()) : [];
-
-// Parse related
-const related = args.related ? (args.related as string).split(",").map((r: string) => r.trim()) : [];
-
-// Validate category
-const validCategories = ["code", "decision", "context", "note", "research"];
-const category = validCategories.includes(args.category) ? args.category : "note";
-
-// Build memento data
-const mementoData: MementoData = {
-  id: mementoId,
-  slug,
-  title,
-  content: userContent || title,
-  category: category as MementoData["category"],
-  tags,
-  related,
-  created: timestamp,
-  updated: timestamp,
-  jsonData,
-};
-
-// Get category description
-function getCategoryDescription(cat: string): string {
-  const descriptions: Record<string, string> = {
-    code: "Code snippets, functions, patterns discovered during development",
-    decision: "Architecture decisions, library choices, implementation approaches",
-    context: "Current state, progress updates, situational information",
-    note: "General notes, observations, reminders",
-    research: "Research findings, comparisons, evaluations",
-  };
-  return descriptions[cat] || descriptions.note;
-}
-
-// Generate markdown content
-function generateMarkdown(data: MementoData): string {
-  const json = data.jsonData;
-  let content = `# Memento: ${data.title}\n\n`;
-
-  // Metadata
-  content += `- **ID**: ${data.id}\n`;
-  content += `- **Slug**: ${data.slug}\n`;
-  content += `- **Category**: ${data.category}\n`;
-
-  if (data.tags.length > 0) {
-    content += `- **Tags**: ${data.tags.join(", ")}\n`;
-  }
-
-  if (data.related.length > 0) {
-    content += `- **Related**: ${data.related.join(", ")}\n`;
-  }
-
-  content += `- **Created**: ${data.created}\n`;
-  content += `- **Updated**: ${data.updated}\n`;
-
-  // Context section
-  content += `\n## Context\n\n`;
-  if (json?.context) {
-    content += `${json.context}\n`;
-  } else if (userContent) {
-    content += `${userContent}\n`;
-  } else {
-    content += `<!-- ${getCategoryDescription(data.category)} -->\n`;
-  }
-
-  // Custom sections (if provided)
-  if (json?.sections && json.sections.length > 0) {
-    for (const section of json.sections) {
-      content += `\n## ${section.heading}\n\n`;
-      content += `${section.content}\n`;
-    }
-  }
-
-  // Key Points (if provided)
-  if (json?.keyPoints && json.keyPoints.length > 0) {
-    content += `\n## Key Points\n\n`;
-    for (const point of json.keyPoints) {
-      content += `- ${point}\n`;
-    }
-  }
-
-  // Decisions (if provided - especially for decision category)
-  if (json?.decisions && json.decisions.length > 0) {
-    content += `\n## Decisions\n\n`;
-    for (const dec of json.decisions) {
-      content += `### ${dec.decision}\n\n`;
-      if (dec.rationale) {
-        content += `**Rationale:** ${dec.rationale}\n\n`;
-      }
-    }
-  }
-
-  // Code Snippets (if provided - especially for code category)
-  if (json?.codeSnippets && json.codeSnippets.length > 0) {
-    content += `\n## Code Snippets\n`;
-    for (const snippet of json.codeSnippets) {
-      if (snippet.filename) {
-        content += `\n### ${snippet.filename}\n\n`;
-      } else {
-        content += `\n`;
-      }
-      const lang = snippet.language || "";
-      content += `\`\`\`${lang}\n${snippet.code}\n\`\`\`\n`;
-    }
-  }
-
-  // Links (if provided)
-  if (json?.links && json.links.length > 0) {
-    content += `\n## Links\n\n`;
-    for (const link of json.links) {
-      content += `- ${link}\n`;
-    }
-  }
-
-  // Next Steps (if provided)
-  if (json?.nextSteps && json.nextSteps.length > 0) {
-    content += `\n## Next Steps\n\n`;
-    for (const step of json.nextSteps) {
-      content += `- [ ] ${step}\n`;
-    }
-  }
-
-  // Related Items
-  content += `\n## Related Items\n\n`;
-  if (data.related.length > 0) {
-    for (const rel of data.related) {
-      content += `- ${rel}\n`;
-    }
-  } else {
-    content += `<!-- Add related mementos, todos, or plans -->\n`;
-  }
-
-  // Notes section
-  content += `\n## Notes\n\n`;
-  if (json?.notes) {
-    content += `${json.notes}\n`;
-  } else {
-    content += `<!-- Additional notes and observations -->\n`;
-  }
-
-  // History
-  content += `\n## History\n\n`;
-  content += `| Date | Action |\n`;
-  content += `|------|--------|\n`;
-  content += `| ${data.created} | Created |\n`;
-
-  return content;
-}
-
-// Update index file
-function updateIndex(data: MementoData, filename: string): void {
-  const indexPath = path.join(implDir, "data", "indexes", "MEMENTOS.md");
-
-  // Create index file if it doesn't exist
-  if (!fs.existsSync(indexPath)) {
-    const initialContent = `# Mementos Index
-
-Project: ${path.basename(path.dirname(implDir))}
-Created: ${timestamp}
-
-## Overview
-
-This file indexes all mementos in this implementation.
-
-## Recent Mementos
-
-| ID | Slug | Title | Category | Created |
-|----|------|-------|----------|---------|
-| ${data.id} | ${data.slug} | ${data.title} | ${data.category} | ${data.created} |
-
----
-
-*Updated: ${timestamp}*
-`;
-    fs.writeFileSync(indexPath, initialContent);
-    return;
-  }
-
-  let content = fs.readFileSync(indexPath, "utf-8");
-
-  // Add new row to table
-  const newRow = `| ${data.id} | ${data.slug} | ${data.title} | ${data.category} | ${data.created} |`;
-
-  // Find the table and add new row after header
-  const tableMatch = content.match(/(## Recent Mementos[\s\S]*?\|[-|]+\|[-|]+\|[-|]+\|[-|]+\|[-|]+\|)/);
-  if (tableMatch) {
-    const insertPoint = tableMatch.index! + tableMatch[0].length;
-    content = content.slice(0, insertPoint) + "\n" + newRow + content.slice(insertPoint);
-  }
-
-  // Update timestamp
-  content = content.replace(/\*Updated:.*\*/, `*Updated: ${timestamp}*`);
-
-  fs.writeFileSync(indexPath, content);
-}
-
-// Main execution
-async function main(): Promise<void> {
-  console.log(`\nImplementation Memento`);
-  console.log(`======================\n`);
-
-  // Generate filename
-  const filename = `${mementoId}_${slug}.md`;
-  const outputPath = path.join(outputDir, filename);
-
-  // Generate content
-  const content = generateMarkdown(mementoData);
-
-  // Write file
-  fs.writeFileSync(outputPath, content);
-
-  console.log(`Created: ${outputPath}`);
-  console.log(`\nMemento Details:`);
-  console.log(`  ID: ${mementoData.id}`);
-  console.log(`  Title: ${mementoData.title}`);
-  console.log(`  Slug: ${mementoData.slug}`);
-  console.log(`  Category: ${mementoData.category}`);
-
-  if (mementoData.tags.length > 0) {
-    console.log(`  Tags: ${mementoData.tags.join(", ")}`);
-  }
-
-  if (mementoData.related.length > 0) {
-    console.log(`  Related: ${mementoData.related.join(", ")}`);
-  }
-
-  // Update index
-  if (!args["no-index"]) {
-    console.log(`\nUpdating MEMENTOS.md index...`);
-    updateIndex(mementoData, filename);
-    console.log(`Index updated.`);
-  }
-
-  console.log(`\n${"=".repeat(40)}`);
-  console.log(`\nMemento created successfully!`);
-  console.log(`File: .implementation/data/mementos/${filename}`);
-}
-
-main().catch((error) => {
-  console.error(`Error: ${error.message}`);
-  process.exit(1);
-});

package/skills/skill-implementation-memento/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-linear/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-linear/README.md

@@ -1,28 +0,0 @@
-# skill-linear
-
-Work with Linear issues, projects, and workflows
-
-## Overview
-
-This Skill provides capabilities for managing Linear project management tasks including creating issues, updating status, searching across projects, and managing teams and cycles.
-
-## MCP Server
-
-Uses the Linear MCP server for API access.
-
-Connection options:
-- Remote SSE: `https://mcp.linear.app/sse`
-- NPM package: `linear-mcp-server`
-
-## Usage
-
-This Skill is automatically invoked by Claude Code when working with Linear-related tasks.
-
-Example requests:
-- "Create a Linear issue for the authentication bug"
-- "Find all high-priority issues in the backend project"
-- "Update LIN-123 to In Progress"
-
-## Setup
-
-Get your Linear API key from: Linear Settings → API → Personal API Keys

package/skills/skill-linear/SKILL.md

@@ -1,94 +0,0 @@
----
-name: skill-linear
-description: Work with Linear issues, projects, and workflows. Create, update, search issues, manage projects, cycles, and teams. Use when working with Linear project management tasks.
----
-
-# Linear Project Management Skill
-
-## What this Skill does
-
-This Skill helps you interact with Linear for project management tasks using the Linear MCP server tools.
-
-## When to use this Skill
-
-Use this Skill when you need to:
-- Create or update Linear issues
-- Search for issues across projects
-- Manage projects, milestones, and cycles
-- Work with teams and assignments
-- Track issue status and progress
-- Comment on issues or discussions
-
-## MCP Server Connection
-
-The Linear MCP server provides access to Linear's API. To connect:
-
-### Option 1: Remote SSE Connection (Recommended)
-```json
-{
-  "linear": {
-    "url": "https://mcp.linear.app/sse"
-  }
-}
-```
-
-### Option 2: NPM Package
-```json
-{
-  "linear": {
-    "command": "npx",
-    "args": ["-y", "linear-mcp-server"],
-    "env": {
-      "LINEAR_API_KEY": "${LINEAR_API_KEY}"
-    }
-  }
-}
-```
-
-**Setup**: Get your API key from Linear Settings → API → Personal API Keys
-
-## Available Operations
-
-The Linear MCP server provides tools for:
-
-- **Issue Management**: Create, update, search, and manage issues
-- **Projects**: List and manage projects and roadmaps
-- **Teams**: Work with team structures and assignments
-- **Cycles**: Manage sprint cycles and iterations
-- **Comments**: Add comments and discussions to issues
-- **Labels**: Organize issues with labels and tags
-- **Status**: Track and update issue states
-
-## Examples
-
-### Example 1: Create an issue
-"Create a Linear issue for implementing the new authentication system"
-→ Claude uses Linear MCP tools to create an issue with details
-
-### Example 2: Search issues
-"Find all high-priority bugs in the backend project"
-→ Claude searches Linear and provides filtered results
-
-### Example 3: Update issue status
-"Move issue LIN-123 to In Progress"
-→ Claude updates the issue status using Linear tools
-
-### Example 4: List project issues
-"Show me all issues in the Q1 Roadmap project"
-→ Claude fetches and displays project issues
-
-## Best practices
-
-- Reference specific issue IDs when updating (e.g., "LIN-123")
-- Include priority, labels, and assignees when creating issues
-- Use clear descriptions for better issue tracking
-- Leverage Linear's project hierarchy for organization
-- Set appropriate due dates and cycles
-
-## Integration Notes
-
-The Linear MCP server automatically handles:
-- Authentication via API key
-- Rate limiting and retries
-- Issue state transitions
-- Team and project resolution