@hasna/skills 0.1.59 → 0.1.61

package/skills/music/SKILL.md

@@ -1,33 +0,0 @@
----
-name: music
-description: Generate music using Minimax or Gemini Lyria through the hosted Skills runtime with provider-cost pricing.
----
-
-# Music Generation Skill
-
-Generate songs, stems, or short music clips from prompts and lyrics using provider-backed music models. This skill routes through the hosted Skills runtime so billing can reserve the selected provider/model cost before execution.
-
-## Supported Providers
-
-- `minimax`: `Music-2.6`, `Music-2.0`
-- `gemini`: `lyria-3-clip-preview`, `lyria-3-pro-preview`
-
-## Usage
-
-```bash
-music generate --provider minimax --prompt "upbeat synth pop intro" --lyrics ./lyrics.txt --output ./song.mp3
-music generate --provider gemini --model lyria-3-clip-preview --prompt "30 second ambient ident" --output ./clip.wav
-```
-
-## Options
-
-- `--provider`: `minimax` or `gemini`
-- `--model`: provider model override
-- `--prompt`: musical direction
-- `--lyrics`: lyrics text or file path
-- `--duration`: requested duration in seconds
-- `--output`: output file path
-
-## Environment
-
-- `SKILLS_API_KEY`: required for hosted runtime execution

package/skills/music/package.json

@@ -1,11 +0,0 @@
-{
-  "name": "music",
-  "version": "1.0.0",
-  "private": true,
-  "description": "Generate music using provider-cost AI backends",
-  "type": "module",
-  "skills": {
-    "runtime": "hosted",
-    "source": "remote"
-  }
-}

package/skills/music-album/SKILL.md

@@ -1,37 +0,0 @@
----
-name: music-album
-description: Generate hosted music album packages with 7, 14, or 21 songs
----
-
-# Music Album
-
-Create a hosted premium album package from a concept, genre, mood, or campaign brief. The hosted runtime generates a cohesive album plan, 7, 14, or 21 songs, cover art direction, track metadata, manifests, receipts, and downloadable artifacts.
-
-## Usage
-
-```bash
-skills run music-album "ambient synth album for deep work" --songs 7
-skills run music-album "high-energy product launch soundtrack" --songs 14 --genre "electro pop"
-skills run music-album "cinematic fantasy travel album" --songs 21 --lyrics-mode instrumental
-```
-
-## Options
-
-- `--songs <7|14|21>`: Album size.
-- `--genre <text>`: Genre or style lane.
-- `--lyrics-mode <instrumental|vocal|mixed>`: Lyric direction.
-- `--cover-style <text>`: Cover art direction.
-- `--reference <path-or-url>`: Optional brand, mood, or story reference.
-
-## Output
-
-- `album/track-*.mp3` or provider-native audio files
-- `album/cover.png`
-- `album/tracklist.json`
-- `album/manifest.json`
-- `album/receipt.json`
-
-## Requirements
-
-Hosted premium execution requires `SKILLS_API_KEY` or `skills auth login`.
-Provider keys stay server-side.

package/skills/music-album/package.json

@@ -1,11 +0,0 @@
-{
-  "name": "music-album",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Hosted premium music album package generator",
-  "type": "module",
-  "skills": {
-    "runtime": "hosted",
-    "source": "remote"
-  }
-}

package/skills/notion-manager/CLAUDE.md

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

package/skills/notion-manager/package.json

@@ -1,29 +0,0 @@
-{
-  "name": "notion-manager",
-  "version": "0.1.0",
-  "description": "Notion Manager skill",
-  "type": "module",
-  "bin": {
-    "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": {
-    "@notionhq/client": "^5.4.0"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "restricted",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "src",
-    "tsconfig.json"
-  ]
-}

package/skills/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(`
-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/notion-manager/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist"
-  },
-  "include": [
-    "src/**/*",
-    "bin/**/*"
-  ]
-}

package/skills/npmpublish/CLAUDE.md

@@ -1,30 +0,0 @@
-# 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` - bundled skill instructions served through Skills CLI/MCP
-
-## Agent Integration
-
-Do not copy or symlink this skill into agent-native skill folders. Register the
-root Skills MCP server instead:
-
-```bash
-skills mcp --register all
-```

package/skills/npmpublish/README.md

@@ -1,83 +0,0 @@
-# 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)
-
-Use it directly as a CLI, or expose it to agents through the root Skills MCP server.
-
-## Installation
-
-```bash
-# Install globally
-bun add -g @hasnaxyz/npmpublish
-
-# Or run directly
-bunx @hasnaxyz/npmpublish
-```
-
-### Agent Integration
-
-Do not symlink, copy, or install this skill into agent-native skill folders.
-Register the shared Skills MCP server instead:
-
-```bash
-skills mcp --register all
-```
-
-## Usage
-
-```bash
-# Publish with defaults (private, patch bump)
-npmpublish
-
-# Specify bump type
-npmpublish --bump minor    # 0.1.0 increment
-npmpublish --bump major    # 1.0.0 increment
-npmpublish --bump patch    # 0.0.1 increment (default)
-
-# Publish as public (use carefully!)
-npmpublish --public
-
-# Dry run (see what would happen)
-npmpublish --dry-run
-
-# Publish from a different directory
-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

package/skills/npmpublish/SKILL.md

@@ -1,70 +0,0 @@
----
-name: npmpublish
-description: Publish npm packages with sensible defaults. Automatically sets private access and bumps patch version (0.0.1). Use when publishing packages to npm, especially for internal/private packages.
----
-
-# npm Publish
-
-Publish npm packages to the npm registry with sensible defaults:
-- **Private by default** - Sets `publishConfig.access: restricted`
-- **Patch bump by default** - Increments version by 0.0.1
-
-## Usage
-
-```bash
-# Publish with defaults (private, patch bump)
-npmpublish
-
-# Specify bump type
-npmpublish --bump minor    # 0.1.0
-npmpublish --bump major    # 1.0.0
-npmpublish --bump patch    # 0.0.1 (default)
-
-# Publish as public (use carefully!)
-npmpublish --public
-
-# Dry run (see what would happen)
-npmpublish --dry-run
-
-# Publish from a different directory
-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 authentication
-- Valid `package.json` in target directory
-
-## 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
-
-## Examples
-
-```bash
-# Standard publish for internal package
-npmpublish
-
-# Release new feature version
-npmpublish --bump minor
-
-# Breaking change release
-npmpublish --bump major
-
-# Check what would be published
-npmpublish --dry-run
-```

package/skills/npmpublish/package.json

@@ -1,41 +0,0 @@
-{
-  "name": "npmpublish",
-  "version": "0.1.3",
-  "description": "Publish npm packages with sensible defaults: private access, patch version bumps",
-  "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "npmpublish": "src/index.ts"
-  },
-  "files": [
-    "src",
-    "README.md",
-    "SKILL.md"
-  ],
-  "publishConfig": {
-    "access": "restricted"
-  },
-  "keywords": [
-    "npm",
-    "publish",
-    "cli",
-    "skill",
-    "claude",
-    "codex"
-  ],
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "ora": "^8.0.1",
-    "semver": "^7.6.0"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "@types/semver": "^7.5.0",
-    "typescript": "^5.7.0"
-  }
-}

package/skills/npmpublish/src/index.ts

@@ -1,192 +0,0 @@
-#!/usr/bin/env bun
-
-import { program } from "commander";
-import { readFile, writeFile } from "fs/promises";
-import { join } from "path";
-import { execSync } from "child_process";
-import chalk from "chalk";
-import ora from "ora";
-import semver from "semver";
-
-interface PackageJson {
-  name: string;
-  version: string;
-  publishConfig?: {
-    access?: string;
-  };
-  private?: boolean;
-  [key: string]: unknown;
-}
-
-type BumpType = "patch" | "minor" | "major";
-
-// ============================================================================
-// Publish Command
-// ============================================================================
-
-async function readPackageJson(dir: string): Promise<PackageJson> {
-  const pkgPath = join(dir, "package.json");
-  const content = await readFile(pkgPath, "utf-8");
-  return JSON.parse(content) as PackageJson;
-}
-
-async function writePackageJson(dir: string, pkg: PackageJson): Promise<void> {
-  const pkgPath = join(dir, "package.json");
-  await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
-}
-
-function bumpVersion(version: string, type: BumpType): string {
-  const newVersion = semver.inc(version, type);
-  if (!newVersion) {
-    throw new Error(`Invalid version: ${version}`);
-  }
-  return newVersion;
-}
-
-function ensurePrivate(pkg: PackageJson): boolean {
-  let modified = false;
-  if (!pkg.publishConfig) {
-    pkg.publishConfig = { access: "restricted" };
-    modified = true;
-  } else if (pkg.publishConfig.access !== "restricted") {
-    pkg.publishConfig.access = "restricted";
-    modified = true;
-  }
-  return modified;
-}
-
-async function publish(options: {
-  bump: BumpType;
-  public: boolean;
-  dryRun: boolean;
-  dir: string;
-}): Promise<void> {
-  const spinner = ora();
-  const dir = options.dir;
-
-  try {
-    spinner.start("Reading package.json...");
-    const pkg = await readPackageJson(dir);
-    spinner.succeed(`Package: ${chalk.cyan(pkg.name)} v${pkg.version}`);
-
-    if (!options.public) {
-      spinner.start("Ensuring private access...");
-      const wasModified = ensurePrivate(pkg);
-      if (wasModified) {
-        spinner.succeed("Set publishConfig.access to restricted");
-      } else {
-        spinner.succeed("Already configured for private access");
-      }
-    } else {
-      spinner.info(chalk.yellow("Publishing as PUBLIC package"));
-      if (pkg.publishConfig) {
-        pkg.publishConfig.access = "public";
-      } else {
-        pkg.publishConfig = { access: "public" };
-      }
-    }
-
-    spinner.start(`Bumping version (${options.bump})...`);
-    const oldVersion = pkg.version;
-    const newVersion = bumpVersion(oldVersion, options.bump);
-    pkg.version = newVersion;
-    spinner.succeed(`Version: ${chalk.dim(oldVersion)} → ${chalk.green(newVersion)}`);
-
-    spinner.start("Updating package.json...");
-    await writePackageJson(dir, pkg);
-    spinner.succeed("package.json updated");
-
-    if (options.dryRun) {
-      console.log();
-      console.log(chalk.yellow("DRY RUN - would publish:"));
-      console.log(`  Package: ${pkg.name}`);
-      console.log(`  Version: ${newVersion}`);
-      console.log(`  Access: ${pkg.publishConfig?.access || "default"}`);
-      return;
-    }
-
-    spinner.start("Publishing to npm...");
-    const accessFlag = options.public ? "--access public" : "--access restricted";
-    execSync(`bun publish ${accessFlag}`, {
-      cwd: dir,
-      stdio: "pipe",
-      env: { ...process.env },
-    });
-    spinner.succeed(`Published ${chalk.cyan(pkg.name)}@${chalk.green(newVersion)}`);
-
-    if (!options.public) {
-      spinner.start("Confirming private access on npm...");
-      try {
-        execSync(`npm access set status=private ${pkg.name}`, {
-          cwd: dir,
-          stdio: "pipe",
-          env: { ...process.env },
-        });
-        spinner.succeed("Confirmed private access");
-      } catch {
-        spinner.info("Access already configured");
-      }
-    }
-
-    console.log();
-    console.log(chalk.green("✓"), `Successfully published ${pkg.name}@${newVersion}`);
-    console.log(chalk.dim(`  Install: bun add ${pkg.name}`));
-
-  } catch (error) {
-    spinner.fail("Publish failed");
-    if (error instanceof Error) {
-      console.error(chalk.red(error.message));
-      if (error.message.includes("ENEEDAUTH") || error.message.includes("auth")) {
-        console.error(chalk.dim("Make sure NPM_TOKEN is set in ~/.secrets"));
-      }
-    }
-    process.exit(1);
-  }
-}
-
-// ============================================================================
-// CLI Setup
-// ============================================================================
-
-program
-  .name("npmpublish")
-  .description("Publish npm packages with sensible defaults: private access, patch bumps")
-  .version("0.1.1");
-
-// Default publish command (when no subcommand given)
-program
-  .option("-b, --bump <type>", "Version bump type: patch, minor, major", "patch")
-  .option("--public", "Publish as public package (default: private)")
-  .option("--dry-run", "Show what would be published without publishing")
-  .option("-d, --dir <path>", "Directory containing package.json", process.cwd())
-  .action(async (options) => {
-    const validBumps: BumpType[] = ["patch", "minor", "major"];
-    if (!validBumps.includes(options.bump as BumpType)) {
-      console.error(chalk.red(`Invalid bump type: ${options.bump}`));
-      console.error(`Valid types: ${validBumps.join(", ")}`);
-      process.exit(1);
-    }
-
-    await publish({
-      bump: options.bump as BumpType,
-      public: options.public || false,
-      dryRun: options.dryRun || false,
-      dir: options.dir,
-    });
-  });
-
-// Install subcommand
-program
-  .command("install")
-  .description("Disabled: register the root Skills MCP server instead")
-  .option("--claude", "Show Claude Code MCP registration guidance")
-  .option("--codex", "Show Codex MCP registration guidance")
-  .option("--local", "Ignored; per-skill local folders are disabled")
-  .action(async (options) => {
-    const target = options.claude ? "claude" : options.codex ? "codex" : "all";
-    console.error(chalk.red("Direct per-skill installs are disabled."));
-    console.error(`Use: skills mcp --register ${target}`);
-    process.exit(1);
-  });
-
-program.parse();