@hasna/skills 0.1.23 → 0.1.25

package/skills/skill-monitor/SKILL.md

@@ -1,69 +0,0 @@
----
-name: skill-monitor
-description: Interact with the open-monitor MCP — check machine health, list processes, kill memory hogs, run doctor, manage cron jobs, trigger cache cleanup
-user_invocable: true
----
-
-# skill-monitor
-
-Use the `monitor_*` MCP tools from `@hasna/monitor` to help the user manage their machines.
-
-## Prerequisites check
-
-If any `monitor_*` tool call fails with "tool not found" or "MCP not connected", tell the user:
-
-```text
-The open-monitor MCP is not installed. Add it with:
-  claude mcp add monitor -- monitor-mcp
-Then restart Claude Code and try again.
-```
-
-## Use cases
-
-### Check machine health
-**Trigger**: "how is the machine doing?", "machine health", "system status", "is everything ok?"
-
-1. Call `monitor_health` (no args, or `machine_id: "local"`)
-2. Call `monitor_snapshot` to get current CPU/memory/disk
-3. Summarize: overall status, any alerts, top resource users
-
-### List memory hogs
-**Trigger**: "what's eating memory?", "high memory processes", "memory usage", "what's using RAM?"
-
-1. Call `monitor_processes`
-2. Show a table: PID, name, memory (MB), CPU%
-3. Offer to kill any if the user wants
-
-### Kill a process
-**Trigger**: "kill pid 1234", "kill process X", "stop process Y"
-
-1. Confirm the process name/PID with the user if ambiguous
-2. Call `monitor_kill` with `pid: <pid>` and `signal: "SIGTERM"`
-3. Report the result; if it failed, offer `SIGKILL`
-
-### Run doctor
-**Trigger**: "run doctor", "doctor check", "health check", "diagnose"
-
-1. Call `monitor_doctor` (optionally with `machine_id`)
-2. Show the full report: status per check, recommended actions
-3. If any checks failed, summarize what to fix
-
-### Trigger cache cleanup
-**Trigger**: "clean caches", "clear dev caches", "free up disk", "cleanup npm/bun/pip cache"
-
-1. Find the `cache-cleaner` cron job: call `monitor_cron_jobs` with `action: "list"`
-2. Run it with `monitor_cron_jobs`
-3. Report what changed
-
-### List cron jobs
-**Trigger**: "show monitor jobs", "what cron jobs are set up?", "monitor schedule"
-
-1. Call `monitor_cron_jobs` with `action: "list"`
-2. Show a table: name, schedule, action type, enabled, last run
-3. Offer to enable/disable or run any job
-
-## Output style
-
-- Use tables for process lists and cron job lists
-- Lead with the summary and keep details below it
-- Always show the machine ID being queried (default: local)

package/skills/skill-monitor/package.json

@@ -1,33 +0,0 @@
-{
-  "name": "@hasnaxyz/skill-monitor",
-  "version": "0.1.0",
-  "description": "Instruction-set skill for operating the open-monitor MCP",
-  "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "skill-monitor": "src/index.ts"
-  },
-  "files": [
-    "src",
-    "SKILL.md",
-    "tsconfig.json"
-  ],
-  "publishConfig": {
-    "access": "restricted"
-  },
-  "keywords": [
-    "monitor",
-    "mcp",
-    "machine",
-    "ops",
-    "skill"
-  ],
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "typecheck": "tsc --noEmit"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  }
-}

package/skills/skill-monitor/src/index.ts

@@ -1,34 +0,0 @@
-#!/usr/bin/env bun
-
-const VERSION = "0.1.0";
-
-function printHelp(): void {
-  console.log(`skill-monitor - Instruction-set skill
-
-DESCRIPTION:
-  Guides an agent through common open-monitor MCP workflows:
-    - machine health and doctor checks
-    - process inspection and safe termination
-    - cron job inspection and execution
-    - cache cleanup and operational summaries
-
-USAGE:
-  skills docs monitor
-  skills install monitor --for claude
-`);
-}
-
-const args = process.argv.slice(2);
-
-if (args.includes("--version") || args.includes("-v")) {
-  console.log(VERSION);
-  process.exit(0);
-}
-
-if (args.includes("--help") || args.includes("-h") || args.length === 0) {
-  printHelp();
-  process.exit(0);
-}
-
-console.log("This is an instruction-set skill. Install it for an agent with:");
-console.log("  skills install monitor --for claude");

package/skills/skill-music/CLAUDE.md

@@ -1,9 +0,0 @@
-# skill-music
-
-AI music generation skill using Minimax Music-01.
-
-## Development
-
-- Runtime: Bun
-- Use `bun run dev` to run locally
-- Use `bun run typecheck` to check types

package/skills/skill-music/SKILL.md

@@ -1,35 +0,0 @@
----
-name: music
-version: 0.1.0
-description: Generate music tracks using AI models (Minimax Music-01)
-category: Content Generation
-tags:
-  - music
-  - generation
-  - ai
-  - minimax
----
-
-# Music
-
-Generate full music tracks from text descriptions using AI. Describe the genre, mood, tempo, and style — get a complete audio track. Supports lyrics, instrumental references, and fine-grained control over the output.
-
-## Features
-
-- **Text-to-Music**: Describe any style and get a full track
-- **Lyrics Support**: Provide lyrics for vocal tracks
-- **Genre & Mood Control**: Specify genre, mood, and tempo
-- **Duration Control**: Set desired track length
-
-## Usage
-
-```bash
-skill-music generate --prompt "upbeat jazz piano" --output ./jazz.mp3
-skill-music generate --prompt "rock anthem" --lyrics "We are the champions" --output ./rock.mp3
-skill-music generate --prompt "lo-fi beats" --mood calm --tempo 80 --output ./lofi.mp3
-```
-
-## Environment Variables
-
-- `MINIMAX_API_KEY` — API key for Minimax (required)
-- `MINIMAX_GROUP_ID` — Group ID for Minimax (optional)

package/skills/skill-music/package.json

@@ -1,27 +0,0 @@
-{
-  "name": "@hasnaxyz/skill-music",
-  "version": "0.1.0",
-  "description": "Generate music tracks using AI models (Minimax Music-01)",
-  "type": "module",
-  "bin": {
-    "skill-music": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "src",
-    "tsconfig.json"
-  ]
-}

package/skills/skill-music/src/index.ts

@@ -1,192 +0,0 @@
-#!/usr/bin/env bun
-
-import { writeFile, mkdir } from 'fs/promises';
-import { resolve, dirname } from 'path';
-import { handleInstallCommand } from '../../_common';
-
-const SKILL_META = {
-  name: 'skill-music',
-  description: 'Generate music tracks using AI (Minimax Music-01)',
-  version: '1.0.0',
-  commands: `Use: skill-music --help`,
-  requiredEnvVars: ['MINIMAX_API_KEY'],
-};
-
-if (await handleInstallCommand(SKILL_META, process.argv.slice(2))) {
-  process.exit(0);
-}
-
-type Provider = 'minimax';
-
-interface GenerateOptions {
-  provider: Provider;
-  prompt: string;
-  output: string;
-  lyrics?: string;
-  genre?: string;
-  mood?: string;
-  tempo?: number;
-  duration?: number;
-}
-
-function parseArgs(): GenerateOptions | null {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
-    printHelp();
-    return null;
-  }
-
-  if (args[0] !== 'generate') {
-    console.error(`Unknown command: ${args[0]}`);
-    process.exit(1);
-  }
-
-  const options: Partial<GenerateOptions> = { provider: 'minimax' };
-
-  for (let i = 1; i < args.length; i++) {
-    switch (args[i]) {
-      case '--provider': case '-p': options.provider = args[++i] as Provider; break;
-      case '--prompt': options.prompt = args[++i]; break;
-      case '--output': case '-o': options.output = args[++i]; break;
-      case '--lyrics': options.lyrics = args[++i]; break;
-      case '--genre': options.genre = args[++i]; break;
-      case '--mood': options.mood = args[++i]; break;
-      case '--tempo': options.tempo = parseInt(args[++i]); break;
-      case '--duration': options.duration = parseInt(args[++i]); break;
-      default: console.error(`Unknown option: ${args[i]}`); process.exit(1);
-    }
-  }
-
-  if (!options.prompt) { console.error('Error: --prompt is required'); process.exit(1); }
-  if (!options.output) { console.error('Error: --output is required'); process.exit(1); }
-
-  return options as GenerateOptions;
-}
-
-function printHelp() {
-  console.log(`
-Music Generation Skill
-
-Generate music using AI models (Minimax Music-01)
-
-USAGE:
-  skill-music generate [OPTIONS]
-
-OPTIONS:
-  --provider, -p <provider>   Provider (minimax) [default: minimax]
-  --prompt <text>             Description of the music to generate [required]
-  --output, -o <path>         Output file path [required]
-  --lyrics <text>             Song lyrics
-  --genre <genre>             Music genre (pop, rock, jazz, classical, electronic, etc.)
-  --mood <mood>               Desired mood (happy, sad, energetic, calm, etc.)
-  --tempo <bpm>               Tempo in BPM
-  --duration <seconds>        Duration in seconds
-
-EXAMPLES:
-  skill-music generate --prompt "upbeat jazz piano" --output ./jazz.mp3
-  skill-music generate --prompt "rock anthem" --lyrics "We are the champions" --output ./rock.mp3
-  skill-music generate --prompt "lo-fi beats" --mood calm --tempo 80 --output ./lofi.mp3
-
-ENVIRONMENT VARIABLES:
-  MINIMAX_API_KEY             API key for Minimax
-  MINIMAX_GROUP_ID            Group ID for Minimax (optional)
-`);
-}
-
-async function generateMinimax(options: GenerateOptions): Promise<Buffer> {
-  const apiKey = process.env.MINIMAX_API_KEY;
-  if (!apiKey) throw new Error('MINIMAX_API_KEY environment variable is required');
-
-  const groupId = process.env.MINIMAX_GROUP_ID;
-  const baseUrl = 'https://api.minimax.chat/v1';
-
-  console.log(`Generating music with Minimax Music-01...`);
-  console.log(`Prompt: ${options.prompt}`);
-
-  const body: Record<string, unknown> = {
-    model: 'music-01',
-    prompt: options.prompt,
-  };
-  if (options.lyrics) body.lyrics = options.lyrics;
-  if (options.genre) body.genre = options.genre;
-  if (options.mood) body.mood = options.mood;
-  if (options.tempo) body.tempo = options.tempo;
-  if (options.duration) body.duration = options.duration;
-
-  const headers: Record<string, string> = {
-    'Content-Type': 'application/json',
-    'Authorization': `Bearer ${apiKey}`,
-  };
-  if (groupId) headers['X-Group-Id'] = groupId;
-
-  const response = await fetch(`${baseUrl}/music_generation`, {
-    method: 'POST',
-    headers,
-    body: JSON.stringify(body),
-  });
-
-  if (!response.ok) {
-    const err = await response.text();
-    throw new Error(`Minimax API error: ${response.status} - ${err}`);
-  }
-
-  const data = await response.json() as { task_id: string };
-  console.log(`Task started: ${data.task_id}`);
-  console.log('Polling for completion...');
-
-  for (let i = 0; i < 120; i++) {
-    await new Promise(r => setTimeout(r, 5000));
-
-    const statusUrl = `${baseUrl}/query/music_generation?task_id=${data.task_id}`;
-    const statusRes = await fetch(statusUrl, { headers: { 'Authorization': `Bearer ${apiKey}` } });
-    const status = await statusRes.json() as {
-      status: string;
-      extra_info?: { audio_url?: string };
-      audio_file?: string;
-      base_resp?: { status_msg: string };
-    };
-
-    if (status.status === 'Success') {
-      const audioUrl = status.extra_info?.audio_url || status.audio_file;
-      if (!audioUrl) throw new Error('No audio URL in response');
-
-      console.log('Music generated. Downloading...');
-      const audioRes = await fetch(audioUrl);
-      if (!audioRes.ok) throw new Error(`Download failed: ${audioRes.status}`);
-      return Buffer.from(await audioRes.arrayBuffer());
-    }
-
-    if (status.status === 'Fail') {
-      throw new Error(`Music generation failed: ${status.base_resp?.status_msg || 'Unknown error'}`);
-    }
-
-    if (i % 6 === 0) console.log(`  Still processing... (${Math.round((i * 5) / 60)}m elapsed)`);
-  }
-
-  throw new Error('Music generation timed out');
-}
-
-async function main() {
-  const options = parseArgs();
-  if (!options) return;
-
-  try {
-    console.log('\n=== Music Generation ===\n');
-
-    const buffer = await generateMinimax(options);
-
-    const outputPath = resolve(options.output);
-    await mkdir(dirname(outputPath), { recursive: true });
-    await writeFile(outputPath, buffer);
-
-    console.log(`\nMusic saved to: ${outputPath}`);
-    console.log(`Size: ${(buffer.length / 1024).toFixed(1)} KB`);
-    console.log('\nDone!\n');
-  } catch (error) {
-    console.error('\nError:', error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-}
-
-main();

package/skills/skill-notion-manager/CLAUDE.md

@@ -1,19 +0,0 @@
-# skill-notion-manager
-
-Notion Manager skill.
-
-## Tech Stack
-
-- Runtime: Bun
-- Language: TypeScript
-- CLI: Commander.js
-
-## CLI
-
-```bash
-skill-notion-manager run
-```
-
-## Data Directory
-
-~/.skill/skill-notion-manager/

package/skills/skill-notion-manager/package.json

@@ -1,27 +0,0 @@
-{
-  "name": "@hasnaxyz/skill-notion-manager",
-  "version": "0.1.0",
-  "description": "Notion Manager skill",
-  "type": "module",
-  "bin": {
-    "skill-notion-manager": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run src/index.ts",
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "src",
-    "tsconfig.json"
-  ]
-}

package/skills/skill-notion-manager/src/index.ts

@@ -1,105 +0,0 @@
-#!/usr/bin/env bun
-import { Client } from "@notionhq/client";
-
-const args = process.argv.slice(2);
-
-if (args.includes("-h") || args.includes("--help")) {
-  console.log(`
-skill-notion-manager - Manage Notion pages and databases
-
-Usage:
-  skills run notion-manager -- action=<action> [options]
-
-Options:
-  -h, --help               Show this help message
-  action=<action>          Action to perform (required):
-                           - search: Search for pages and databases
-                           - read-page: Read a specific page
-                           - create-page: Create a new page
-  query=<text>             Search query (for search action)
-  pageId=<id>              Page ID (required for read-page)
-  parentId=<id>            Parent page ID (required for create-page)
-  title=<text>             Page title (required for create-page)
-
-Examples:
-  skills run notion-manager -- action=search query="meeting notes"
-  skills run notion-manager -- action=read-page pageId=abc123...
-  skills run notion-manager -- action=create-page parentId=xyz789... title="New Document"
-
-Requirements:
-  Requires Notion connector to be connected in skills.md.
-`);
-  process.exit(0);
-}
-
-const actionArg = args.find(a => a.startsWith("action="))?.split("=")[1];
-const queryArg = args.find(a => a.startsWith("query="))?.split("=")[1];
-const pageIdArg = args.find(a => a.startsWith("pageId="))?.split("=")[1];
-const parentIdArg = args.find(a => a.startsWith("parentId="))?.split("=")[1];
-const titleArg = args.find(a => a.startsWith("title="))?.split("=")[1];
-
-if (!process.env.NOTION_ACCESS_TOKEN) {
-  console.error("Error: Notion connector not connected. Please connect Notion in skills.md.");
-  process.exit(1);
-}
-
-const notion = new Client({
-  auth: process.env.NOTION_ACCESS_TOKEN,
-});
-
-async function main() {
-  try {
-    switch (actionArg) {
-      case "search":
-        const searchResponse = await notion.search({
-          query: queryArg,
-          page_size: 10,
-        });
-        console.log(JSON.stringify(searchResponse.results.map((r: any) => ({
-          id: r.id,
-          object: r.object,
-          title: r.properties?.title?.title?.[0]?.plain_text || r.properties?.Name?.title?.[0]?.plain_text || "Untitled",
-          url: r.url
-        })), null, 2));
-        break;
-
-      case "read-page":
-        if (!pageIdArg) {
-          console.error("Error: pageId is required for read-page");
-          process.exit(1);
-        }
-        const page = await notion.pages.retrieve({ page_id: pageIdArg });
-        // For content, we'd need blocks.children.list, but let's just return metadata for now
-        console.log(JSON.stringify(page, null, 2));
-        break;
-
-      case "create-page":
-        if (!parentIdArg || !titleArg) {
-          console.error("Error: parentId and title are required for create-page");
-          process.exit(1);
-        }
-        const newPage = await notion.pages.create({
-          parent: { page_id: parentIdArg },
-          properties: {
-            title: [
-              {
-                text: {
-                  content: titleArg,
-                },
-              },
-            ],
-          },
-        });
-        console.log(JSON.stringify(newPage, null, 2));
-        break;
-
-      default:
-        console.log("Usage: skills run notion-manager -- action=<search|read-page|create-page> [query=...] [pageId=...] [parentId=...] [title=...]");
-    }
-  } catch (error: any) {
-    console.error("Notion API Error:", error.message);
-    process.exit(1);
-  }
-}
-
-main();

package/skills/skill-npmpublish/CLAUDE.md

@@ -1,33 +0,0 @@
-# skill-npmpublish
-
-Publish npm packages with private access and patch version bumps by default.
-
-## Quick Reference
-
-```bash
-# Default: private, patch bump (0.0.1)
-bun run src/index.ts
-
-# Options
---bump <patch|minor|major>  # Version bump type (default: patch)
---public                    # Publish as public (default: private)
---dry-run                   # Preview without publishing
---dir <path>                # Package directory
-```
-
-## Project Structure
-
-- `src/index.ts` - CLI entry point
-- `SKILL.md` - Claude Code / Codex skill definition
-
-## Skill Installation
-
-For Claude Code:
-```bash
-ln -s $(pwd) ~/.claude/skills/npmpublish
-```
-
-For Codex:
-```bash
-ln -s $(pwd) ~/.codex/skills/npmpublish
-```

package/skills/skill-npmpublish/README.md

@@ -1,104 +0,0 @@
-# skill-npmpublish
-
-Publish npm packages with sensible defaults:
-- **Private by default** - Sets `publishConfig.access: restricted`
-- **Patch bump by default** - Increments version by 0.0.1 (not 0.1.0)
-
-Works as both a **Claude Code** skill and **OpenAI Codex** skill.
-
-## Installation
-
-```bash
-# Install globally
-bun add -g @hasnaxyz/skill-npmpublish
-
-# Or run directly
-bunx @hasnaxyz/skill-npmpublish
-```
-
-### Claude Code Skill
-
-Link to Claude Code skills directory:
-```bash
-ln -s ~/Workspace/dev/hasnaxyz/skill/skilldev/skill-npmpublish ~/.claude/skills/npmpublish
-```
-
-Or copy the SKILL.md:
-```bash
-mkdir -p ~/.claude/skills/npmpublish
-cp SKILL.md ~/.claude/skills/npmpublish/
-```
-
-Then invoke with `/npmpublish` in Claude Code.
-
-### OpenAI Codex Skill
-
-Link to Codex skills directory:
-```bash
-ln -s ~/Workspace/dev/hasnaxyz/skill/skilldev/skill-npmpublish ~/.codex/skills/npmpublish
-```
-
-Or for project-specific:
-```bash
-mkdir -p .codex/skills/npmpublish
-cp SKILL.md .codex/skills/npmpublish/
-```
-
-Then invoke with `/npmpublish` in Codex.
-
-## Usage
-
-```bash
-# Publish with defaults (private, patch bump)
-skill-npmpublish
-
-# Specify bump type
-skill-npmpublish --bump minor    # 0.1.0 increment
-skill-npmpublish --bump major    # 1.0.0 increment
-skill-npmpublish --bump patch    # 0.0.1 increment (default)
-
-# Publish as public (use carefully!)
-skill-npmpublish --public
-
-# Dry run (see what would happen)
-skill-npmpublish --dry-run
-
-# Publish from a different directory
-skill-npmpublish --dir /path/to/package
-```
-
-## Options
-
-| Option | Description | Default |
-|--------|-------------|---------|
-| `-b, --bump <type>` | Version bump: patch, minor, major | patch |
-| `--public` | Publish as public package | false (private) |
-| `--dry-run` | Preview without publishing | false |
-| `-d, --dir <path>` | Package directory | current dir |
-
-## Requirements
-
-- `NPM_TOKEN` in `~/.secrets` for npm authentication
-- Valid `package.json` in target directory
-- Bun runtime
-
-## What It Does
-
-1. Reads `package.json`
-2. Ensures `publishConfig.access: restricted` (unless --public)
-3. Bumps version by specified amount (default: patch/0.0.1)
-4. Updates `package.json`
-5. Runs `bun publish`
-6. Confirms private access on npm registry
-
-## Why Private by Default?
-
-Most internal tools, skills, and packages should be private. Making them public requires explicit intent with `--public`. This prevents accidental exposure of internal code.
-
-## Why Patch Bump by Default?
-
-Following semver, most publishes are bug fixes or small improvements (patch). Minor and major bumps should be intentional decisions, not defaults.
-
-## License
-
-MIT