moon-iq-skills 0.1.0

package/README.md

@@ -0,0 +1,35 @@
+# moon-iq-skills
+
+A small skills pack for Moon IQ / MoonIQ CLI workflows.
+
+This package ships a set of Anthropic-style skill folders (each containing a `SKILL.md`) prefixed with `mooniq-`.
+
+## Install
+
+```bash
+npm i -g moon-iq-skills
+```
+
+## List skills
+
+```bash
+moon-iq-skills list
+```
+
+## Install skills into a project
+
+Copy bundled skills into your repo/workspace `./skills` directory:
+
+```bash
+moon-iq-skills install --to ./skills
+```
+
+Overwrite existing:
+
+```bash
+moon-iq-skills install --to ./skills --force
+```
+
+## Notes
+- The skills are intended to be discovered by agents that scan a `skills/` directory.
+- The primary MoonIQ CLI package is published separately (install via `npm i -g moon-iq`).

package/dist/index.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import path from "path";
+import fs from "fs/promises";
+import { fileURLToPath } from "url";
+async function pathExists(p) {
+  try {
+    await fs.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function listSkillDirs(rootDir) {
+  const entries = await fs.readdir(rootDir, { withFileTypes: true });
+  return entries.filter((e) => e.isDirectory() && e.name.startsWith("mooniq-")).map((e) => e.name).sort();
+}
+async function copyDir(src, dest) {
+  await fs.mkdir(dest, { recursive: true });
+  const entries = await fs.readdir(src, { withFileTypes: true });
+  for (const e of entries) {
+    const s = path.join(src, e.name);
+    const d = path.join(dest, e.name);
+    if (e.isDirectory()) {
+      await copyDir(s, d);
+    } else if (e.isFile()) {
+      await fs.copyFile(s, d);
+    }
+  }
+}
+var program = new Command();
+program.name("moon-iq-skills").description(
+  "Moon IQ skills pack (Anthropic-style SKILL.md folders) for Clawdbot/Cursor-style agents."
+).version("0.1.0");
+function getPackageRoot() {
+  const __filename = fileURLToPath(import.meta.url);
+  const __dirname = path.dirname(__filename);
+  return path.resolve(__dirname, "..");
+}
+program.command("list").description("List bundled skill directories").action(async () => {
+  const rootDir = getPackageRoot();
+  const dirs = await listSkillDirs(rootDir);
+  for (const d of dirs) console.log(d);
+});
+program.command("install").description(
+  "Copy bundled skills into a target skills directory (e.g. ./skills)."
+).requiredOption(
+  "--to <dir>",
+  "Destination directory (will create). Example: --to ./skills"
+).option("--force", "Overwrite existing skill directories", false).action(async (opts) => {
+  const rootDir = getPackageRoot();
+  const dirs = await listSkillDirs(rootDir);
+  const destRoot = path.resolve(process.cwd(), opts.to);
+  await fs.mkdir(destRoot, { recursive: true });
+  for (const dir of dirs) {
+    const srcDir = path.join(rootDir, dir);
+    const destDir = path.join(destRoot, dir);
+    if (await pathExists(destDir) && !opts.force) {
+      console.error(
+        `Skip ${dir}: already exists at ${destDir} (use --force to overwrite)`
+      );
+      continue;
+    }
+    if (opts.force && await pathExists(destDir)) {
+      await fs.rm(destDir, { recursive: true, force: true });
+    }
+    await copyDir(srcDir, destDir);
+    console.log(`Installed ${dir} -> ${destDir}`);
+  }
+  console.log(`
+Done. Installed ${dirs.length} skills into: ${destRoot}`);
+});
+program.parseAsync(process.argv).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport path from \"node:path\";\nimport fs from \"node:fs/promises\";\nimport { fileURLToPath } from \"node:url\";\n\nasync function pathExists(p: string) {\n  try {\n    await fs.access(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function listSkillDirs(rootDir: string) {\n  const entries = await fs.readdir(rootDir, { withFileTypes: true });\n  return entries\n    .filter((e) => e.isDirectory() && e.name.startsWith(\"mooniq-\"))\n    .map((e) => e.name)\n    .sort();\n}\n\nasync function copyDir(src: string, dest: string) {\n  await fs.mkdir(dest, { recursive: true });\n  const entries = await fs.readdir(src, { withFileTypes: true });\n  for (const e of entries) {\n    const s = path.join(src, e.name);\n    const d = path.join(dest, e.name);\n    if (e.isDirectory()) {\n      await copyDir(s, d);\n    } else if (e.isFile()) {\n      await fs.copyFile(s, d);\n    }\n  }\n}\n\nconst program = new Command();\n\nprogram\n  .name(\"moon-iq-skills\")\n  .description(\n    \"Moon IQ skills pack (Anthropic-style SKILL.md folders) for Clawdbot/Cursor-style agents.\"\n  )\n  .version(\"0.1.0\");\n\nfunction getPackageRoot() {\n  const __filename = fileURLToPath(import.meta.url);\n  const __dirname = path.dirname(__filename);\n  // dist/index.js -> package root\n  return path.resolve(__dirname, \"..\");\n}\n\nprogram\n  .command(\"list\")\n  .description(\"List bundled skill directories\")\n  .action(async () => {\n    const rootDir = getPackageRoot();\n    const dirs = await listSkillDirs(rootDir);\n    for (const d of dirs) console.log(d);\n  });\n\nprogram\n  .command(\"install\")\n  .description(\n    \"Copy bundled skills into a target skills directory (e.g. ./skills).\"\n  )\n  .requiredOption(\n    \"--to <dir>\",\n    \"Destination directory (will create). Example: --to ./skills\"\n  )\n  .option(\"--force\", \"Overwrite existing skill directories\", false)\n  .action(async (opts: { to: string; force: boolean }) => {\n    const rootDir = getPackageRoot();\n    const dirs = await listSkillDirs(rootDir);\n    const destRoot = path.resolve(process.cwd(), opts.to);\n\n    await fs.mkdir(destRoot, { recursive: true });\n\n    for (const dir of dirs) {\n      const srcDir = path.join(rootDir, dir);\n      const destDir = path.join(destRoot, dir);\n\n      if ((await pathExists(destDir)) && !opts.force) {\n        console.error(\n          `Skip ${dir}: already exists at ${destDir} (use --force to overwrite)`\n        );\n        continue;\n      }\n\n      if (opts.force && (await pathExists(destDir))) {\n        await fs.rm(destDir, { recursive: true, force: true });\n      }\n\n      await copyDir(srcDir, destDir);\n      console.log(`Installed ${dir} -> ${destDir}`);\n    }\n\n    console.log(`\\nDone. Installed ${dirs.length} skills into: ${destRoot}`);\n  });\n\nprogram.parseAsync(process.argv).catch((err) => {\n  console.error(err);\n  process.exit(1);\n});\n"],"mappings":";;;AAAA,SAAS,eAAe;AACxB,OAAO,UAAU;AACjB,OAAO,QAAQ;AACf,SAAS,qBAAqB;AAE9B,eAAe,WAAW,GAAW;AACnC,MAAI;AACF,UAAM,GAAG,OAAO,CAAC;AACjB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAe,cAAc,SAAiB;AAC5C,QAAM,UAAU,MAAM,GAAG,QAAQ,SAAS,EAAE,eAAe,KAAK,CAAC;AACjE,SAAO,QACJ,OAAO,CAAC,MAAM,EAAE,YAAY,KAAK,EAAE,KAAK,WAAW,SAAS,CAAC,EAC7D,IAAI,CAAC,MAAM,EAAE,IAAI,EACjB,KAAK;AACV;AAEA,eAAe,QAAQ,KAAa,MAAc;AAChD,QAAM,GAAG,MAAM,MAAM,EAAE,WAAW,KAAK,CAAC;AACxC,QAAM,UAAU,MAAM,GAAG,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;AAC7D,aAAW,KAAK,SAAS;AACvB,UAAM,IAAI,KAAK,KAAK,KAAK,EAAE,IAAI;AAC/B,UAAM,IAAI,KAAK,KAAK,MAAM,EAAE,IAAI;AAChC,QAAI,EAAE,YAAY,GAAG;AACnB,YAAM,QAAQ,GAAG,CAAC;AAAA,IACpB,WAAW,EAAE,OAAO,GAAG;AACrB,YAAM,GAAG,SAAS,GAAG,CAAC;AAAA,IACxB;AAAA,EACF;AACF;AAEA,IAAM,UAAU,IAAI,QAAQ;AAE5B,QACG,KAAK,gBAAgB,EACrB;AAAA,EACC;AACF,EACC,QAAQ,OAAO;AAElB,SAAS,iBAAiB;AACxB,QAAM,aAAa,cAAc,YAAY,GAAG;AAChD,QAAM,YAAY,KAAK,QAAQ,UAAU;AAEzC,SAAO,KAAK,QAAQ,WAAW,IAAI;AACrC;AAEA,QACG,QAAQ,MAAM,EACd,YAAY,gCAAgC,EAC5C,OAAO,YAAY;AAClB,QAAM,UAAU,eAAe;AAC/B,QAAM,OAAO,MAAM,cAAc,OAAO;AACxC,aAAW,KAAK,KAAM,SAAQ,IAAI,CAAC;AACrC,CAAC;AAEH,QACG,QAAQ,SAAS,EACjB;AAAA,EACC;AACF,EACC;AAAA,EACC;AAAA,EACA;AACF,EACC,OAAO,WAAW,wCAAwC,KAAK,EAC/D,OAAO,OAAO,SAAyC;AACtD,QAAM,UAAU,eAAe;AAC/B,QAAM,OAAO,MAAM,cAAc,OAAO;AACxC,QAAM,WAAW,KAAK,QAAQ,QAAQ,IAAI,GAAG,KAAK,EAAE;AAEpD,QAAM,GAAG,MAAM,UAAU,EAAE,WAAW,KAAK,CAAC;AAE5C,aAAW,OAAO,MAAM;AACtB,UAAM,SAAS,KAAK,KAAK,SAAS,GAAG;AACrC,UAAM,UAAU,KAAK,KAAK,UAAU,GAAG;AAEvC,QAAK,MAAM,WAAW,OAAO,KAAM,CAAC,KAAK,OAAO;AAC9C,cAAQ;AAAA,QACN,QAAQ,GAAG,uBAAuB,OAAO;AAAA,MAC3C;AACA;AAAA,IACF;AAEA,QAAI,KAAK,SAAU,MAAM,WAAW,OAAO,GAAI;AAC7C,YAAM,GAAG,GAAG,SAAS,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAAA,IACvD;AAEA,UAAM,QAAQ,QAAQ,OAAO;AAC7B,YAAQ,IAAI,aAAa,GAAG,OAAO,OAAO,EAAE;AAAA,EAC9C;AAEA,UAAQ,IAAI;AAAA,kBAAqB,KAAK,MAAM,iBAAiB,QAAQ,EAAE;AACzE,CAAC;AAEH,QAAQ,WAAW,QAAQ,IAAI,EAAE,MAAM,CAAC,QAAQ;AAC9C,UAAQ,MAAM,GAAG;AACjB,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/mooniq-auth/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: mooniq-auth
+description: Authenticate and troubleshoot Moon IQ CLI (mooniq). Use when you need to log in, check auth state, fix 401s, or switch accounts before running Moon IQ tools.
+---
+
+# MoonIQ auth (CLI)
+
+## Commands
+- Login: `mooniq login`
+- Who am I: `mooniq whoami`
+- Logout: `mooniq logout`
+
+## Workflow (recommended)
+1) Run `mooniq whoami`.
+2) If it fails with 401 or no session, run `mooniq login` (opens browser).
+3) Re-run `mooniq whoami`.
+
+## Notes
+- Prefer running `mooniq run <tool> --input '<json>'` only after `whoami` succeeds.

package/mooniq-buy-crypto/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: mooniq-buy-crypto
+description: Buy crypto using Moon IQ CLI (typically USDC -> token) via token_buy. Use when the user wants to buy a token, get a quote, then execute.
+---
+
+# Buy crypto (MoonIQ CLI)
+
+## Tool schema (source of truth)
+- `src/tools/token/buy/schema.ts`
+- Tool: `token_buy`
+- Required input fields:
+  - `simulation` (boolean)
+  - `token` (string; token mint/address)
+  - `amount` (number; USDC amount; coerced)
+
+## Safety workflow (default)
+1) Run a **simulation** first and show the quote.
+2) Ask for explicit confirmation.
+3) Execute with `simulation:false`.
+
+## CLI commands
+- Preferred (scriptable + full params):
+  - `mooniq run token_buy --input '<json>'`
+
+- Convenience command (currently limited):
+  - `mooniq token buy`
+  - Per `mooniq token buy --help`, it only supports `--base-url` (no `--token/--amount/--simulation`).
+  - Use `mooniq run` for real buys.
+
+## Command templates (recommended: mooniq run)
+```bash
+# Quote
+mooniq run token_buy --input '{
+  "simulation": true,
+  "token": "<mint-or-address>",
+  "amount": 100
+}'
+
+# Execute (only after CONFIRM)
+mooniq run token_buy --input '{
+  "simulation": false,
+  "token": "<mint-or-address>",
+  "amount": 100
+}'
+```
+
+## Notes
+- If the user only provides a symbol/name, call `token_search` first to find the correct address.

package/mooniq-check-wallet/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: mooniq-check-wallet
+description: Check wallet balances and holdings using Moon IQ CLI. Use for questions like "what's in my wallet", portfolio breakdown, token balances, and USD value on Solana/EVM.
+---
+
+# Check wallet (MoonIQ CLI)
+
+## Primary tools
+- `token_balance_list` — list token balances + USD value
+- `token_balance_retrieve` — (if needed) drill into a specific token balance
+
+## CLI commands
+- Preferred:
+  - `mooniq run token_balance_list --input '<json>'`
+
+- Convenience grouping:
+  - There is a `mooniq token balance` command group, but availability/flags may vary.
+  - If it doesn’t accept the needed args, use `mooniq run token_balance_list`.
+
+## Common commands (recommended: mooniq run)
+List holdings:
+```bash
+mooniq run token_balance_list --input '{"wallet":"<address>","chain":"solana"}'
+mooniq run token_balance_list --input '{"wallet":"0x...","chain":"ethereum"}'
+```
+
+## Output handling
+- Summarize top holdings by USD value.
+- Call out small dust balances separately.
+- If user asks for totals, sum `balance.value` across items.
+
+## If auth fails
+Use the `mooniq-auth` skill and run `mooniq login`.

package/mooniq-discover-tokens/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: mooniq-discover-tokens
+description: Discover and research tokens using Moon IQ CLI. Use to search by name/symbol/address, view trending tokens, and retrieve token metadata/market data before trading.
+---
+
+# Discover tokens (MoonIQ CLI)
+
+## Tool schemas (source of truth)
+- `src/tools/token/search/schema.ts` (`token_search`)
+- `src/tools/token/trending/list/schema.ts` (`token_trending_list`)
+- `src/tools/token/retrieve/schema.ts` (`token_retrieve`)
+
+## CLI commands
+- Preferred:
+  - `mooniq run token_search|token_trending_list|token_retrieve --input '<json>'`
+- Convenience grouping:
+  - `mooniq token search --query "SOL" --chain solana [--limit 5]` (usable)
+  - `mooniq token swap recommend --query "swap 100 USDC for SOL"` (useful helper)
+  - `mooniq token trending list` (currently limited; per `--help` it only supports `--base-url`)
+  - `mooniq token retrieve` (not currently exposed with flags; prefer `mooniq run token_retrieve`)
+
+## token_search
+Required input fields:
+- `query` (string)
+- `chain` (string enum; e.g. solana/ethereum/base)
+- `limit` (number | null) — required; use `null` to default to 5
+
+Command template:
+```bash
+mooniq run token_search --input '{
+  "query": "SOL",
+  "chain": "solana",
+  "limit": null
+}'
+```
+
+## token_trending_list
+Required input fields:
+- `chain` (string enum)
+- `sort` ("rank" | "volume" | "liquidity")
+- `order` ("asc" | "desc")
+- `limit` (number)
+- `page` (number)
+
+Command template:
+```bash
+mooniq run token_trending_list --input '{
+  "chain": "solana",
+  "sort": "rank",
+  "order": "asc",
+  "limit": 5,
+  "page": 1
+}'
+```
+
+## token_retrieve
+Required input fields:
+- `token` (string; mint/address)
+- `chain` (string enum)
+
+Command template:
+```bash
+mooniq run token_retrieve --input '{
+  "token": "<mint-or-address>",
+  "chain": "solana"
+}'
+```
+
+## Workflow
+1) Resolve addresses with `token_search`.
+2) Use `token_retrieve` for detailed market data.
+3) Only then proceed to buy/sell/swap skills.

package/mooniq-lending/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: mooniq-lending
+description: Use Moon IQ CLI lending tools (lending_*). Use when depositing/withdrawing, retrieving lending account status, rates, or getting lending recommendations.
+---
+
+# Lending (MoonIQ CLI)
+
+## Tool schemas (source of truth)
+- `src/tools/lending/deposit/schema.ts` (`lending_deposit`)
+- `src/tools/lending/withdraw/schema.ts` (`lending_withdraw`)
+- `src/tools/lending/account/retrieve/schema.ts` (`lending_account_retrieve`)
+- `src/tools/lending/rate/retrieve/schema.ts` (`lending_rate_retrieve`)
+
+## CLI commands
+- Preferred:
+  - `mooniq run lending_* --input '<json>'`
+- Convenience grouping:
+  - `mooniq lending ...`
+
+## Read-only calls
+```bash
+mooniq run lending_account_retrieve --input '{"userId":"<user_id>"}'
+mooniq run lending_rate_retrieve --input '{"chain":"solana"}'
+```
+(If validation errors occur, inspect the schema files above for required fields.)
+
+## lending_deposit
+Required input fields:
+- `simulation` (boolean)
+- `amount` (number; USDC)
+
+```bash
+# Quote
+mooniq run lending_deposit --input '{"simulation": true, "amount": 100}'
+
+# Execute (only after CONFIRM)
+mooniq run lending_deposit --input '{"simulation": false, "amount": 100}'
+```
+
+## lending_withdraw
+Required input fields:
+- `simulation` (boolean)
+- `amount` (number; USDC)
+
+```bash
+# Quote
+mooniq run lending_withdraw --input '{"simulation": true, "amount": 100}'
+
+# Execute (only after CONFIRM)
+mooniq run lending_withdraw --input '{"simulation": false, "amount": 100}'
+```
+
+## Notes
+- Treat deposits/withdrawals as sensitive; confirm amount before `simulation:false`.

package/mooniq-limit-orders/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: mooniq-limit-orders
+description: Create, list, and manage limit orders using Moon IQ CLI (token_limit_* tools). Use when the user wants conditional buys/sells at a target price.
+---
+
+# Limit orders (MoonIQ CLI)
+
+## Tool schemas (source of truth)
+- `src/tools/token/limit/buy/schema.ts` (`token_limit_buy`)
+- `src/tools/token/limit/sell/schema.ts` (`token_limit_sell`)
+- `src/tools/token/limit/order/list/schema.ts` (`token_limit_order_list`)
+
+## CLI commands
+- Preferred (scriptable + full params):
+  - `mooniq run token_limit_buy|token_limit_sell|token_limit_order_list --input '<json>'`
+
+- Convenience grouping:
+  - `mooniq token limit ...`
+  - If the convenience commands don’t expose required flags, fall back to `mooniq run`.
+
+## token_limit_buy
+Required input fields:
+- `simulation` (boolean)
+- `token` (string)
+- `amount` (number; USDC)
+- `price` (number; USD/USDC)
+
+```bash
+# Quote
+mooniq run token_limit_buy --input '{
+  "simulation": true,
+  "token": "<mint-or-address>",
+  "amount": 100,
+  "price": 0.25
+}'
+
+# Execute (only after CONFIRM)
+mooniq run token_limit_buy --input '{
+  "simulation": false,
+  "token": "<mint-or-address>",
+  "amount": 100,
+  "price": 0.25
+}'
+```
+
+## token_limit_sell
+Required input fields:
+- `simulation` (boolean)
+- `token` (string)
+- `amount` (number; token units)
+- `price` (number; USD/USDC)
+
+```bash
+# Quote
+mooniq run token_limit_sell --input '{
+  "simulation": true,
+  "token": "<mint-or-address>",
+  "amount": 123.45,
+  "price": 0.25
+}'
+
+# Execute (only after CONFIRM)
+mooniq run token_limit_sell --input '{
+  "simulation": false,
+  "token": "<mint-or-address>",
+  "amount": 123.45,
+  "price": 0.25
+}'
+```
+
+## Notes
+- Use `token_search` to resolve the correct token address.

package/mooniq-onramp-offramp/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: mooniq-onramp-offramp
+description: Use Moon IQ CLI Iron onramp/offramp tools (iron_*). Use when creating/listing/retrieving onramps or offramps and initiating an offramp.
+---
+
+# Onramp / Offramp (MoonIQ CLI)
+
+## Tool schemas (source of truth)
+- `src/tools/iron/onramp/create/schema.ts` (`iron_onramp_create`)
+- `src/tools/iron/offramp/create/schema.ts` (`iron_offramp_create`)
+- `src/tools/iron/offramp/initiate/schema.ts` (`iron_offramp_initiate`)
+
+## CLI commands
+- Preferred:
+  - `mooniq run iron_* --input '<json>'`
+- Convenience grouping:
+  - `mooniq iron ...`
+
+## Create onramp
+Required input fields:
+- `name` (string)
+- `fiat` (object; see `src/tools/iron/models.ts`)
+- `stablecoin` (object; see `src/tools/iron/models.ts`)
+
+```bash
+mooniq run iron_onramp_create --input '{
+  "name": "<friendly name>",
+  "fiat": {"currency":"USD"},
+  "stablecoin": {"chain":"solana","symbol":"USDC"}
+}'
+```
+(If validation errors occur, inspect the schema files above; these nested shapes are strict.)
+
+## Create offramp
+Required input fields:
+- `name` (string)
+- `fiat` (object)
+- `stablecoin` (object)
+
+```bash
+mooniq run iron_offramp_create --input '{
+  "name": "<friendly name>",
+  "fiat": {"currency":"USD"},
+  "stablecoin": {"chain":"solana","symbol":"USDC"}
+}'
+```
+
+## Initiate offramp (money movement)
+Required input fields:
+- `simulation` (boolean)
+- `offrampId` (string)
+- `amount` (number)
+
+```bash
+# Quote
+mooniq run iron_offramp_initiate --input '{
+  "simulation": true,
+  "offrampId": "<offramp_id>",
+  "amount": 100
+}'
+
+# Execute (only after CONFIRM)
+mooniq run iron_offramp_initiate --input '{
+  "simulation": false,
+  "offrampId": "<offramp_id>",
+  "amount": 100
+}'
+```
+
+## Notes
+- For onramp/offramp create inputs (`fiat`/`stablecoin`), use the exact schemas in `src/tools/iron/models.ts` / `src/tools/iron/*/models.ts`.
+- Treat initiate as sensitive; require explicit confirmation.

package/mooniq-recurring-orders/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: mooniq-recurring-orders
+description: Create and manage recurring (DCA) orders using Moon IQ CLI (token_recurring_* tools). Use for scheduling periodic buys/sells.
+---
+
+# Recurring orders (MoonIQ CLI)
+
+## Tool schemas (source of truth)
+- `src/tools/token/recurring/buy/schema.ts` (`token_recurring_buy`)
+- `src/tools/token/recurring/sell/schema.ts` (`token_recurring_sell`)
+- `src/tools/token/recurring/models.ts` (`interval` enum)
+
+## CLI commands
+- Preferred (scriptable + full params):
+  - `mooniq run token_recurring_buy|token_recurring_sell|token_recurring_order_list --input '<json>'`
+
+- Convenience grouping:
+  - `mooniq token recurring ...`
+  - If the convenience commands don’t expose required flags, fall back to `mooniq run`.
+
+Interval values:
+- `hour` | `day` | `week` | `month`
+
+## token_recurring_buy
+Required input fields:
+- `simulation` (boolean)
+- `token` (string)
+- `amount` (number; USDC per order; min 50)
+- `interval` (string enum)
+- `numberOfOrders` (number; min 2)
+
+```bash
+# Quote
+mooniq run token_recurring_buy --input '{
+  "simulation": true,
+  "token": "<mint-or-address>",
+  "amount": 50,
+  "interval": "week",
+  "numberOfOrders": 4
+}'
+
+# Execute (only after CONFIRM)
+mooniq run token_recurring_buy --input '{
+  "simulation": false,
+  "token": "<mint-or-address>",
+  "amount": 50,
+  "interval": "week",
+  "numberOfOrders": 4
+}'
+```
+
+## token_recurring_sell
+Required input fields:
+- `simulation` (boolean)
+- `token` (string)
+- `amount` (number; token units)
+- `interval` (string enum)
+- `numberOfOrders` (number)
+
+```bash
+# Quote
+mooniq run token_recurring_sell --input '{
+  "simulation": true,
+  "token": "<mint-or-address>",
+  "amount": 10,
+  "interval": "week",
+  "numberOfOrders": 4
+}'
+
+# Execute (only after CONFIRM)
+mooniq run token_recurring_sell --input '{
+  "simulation": false,
+  "token": "<mint-or-address>",
+  "amount": 10,
+  "interval": "week",
+  "numberOfOrders": 4
+}'
+```
+
+## Notes
+- Use `token_search` to resolve token addresses.

package/mooniq-sell-crypto/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: mooniq-sell-crypto
+description: Sell crypto using Moon IQ CLI (token -> USDC) via token_sell. Use when the user wants to sell a token balance (partial or all), quote first, then execute.
+---
+
+# Sell crypto (MoonIQ CLI)
+
+## Tool schema (source of truth)
+- `src/tools/token/sell/schema.ts`
+- Tool: `token_sell`
+- Required input fields:
+  - `simulation` (boolean)
+  - `token` (string; token mint/address)
+  - `amount` (number; token amount; coerced)
+
+## Safety workflow (default)
+1) Run a **simulation** first and show the quote.
+2) Ask for explicit confirmation (token + amount).
+3) Execute with `simulation:false`.
+
+## CLI commands
+- Preferred (scriptable + full params):
+  - `mooniq run token_sell --input '<json>'`
+
+- Convenience command (currently limited):
+  - `mooniq token sell`
+  - Per `mooniq token sell --help`, it only supports `--base-url` (no `--token/--amount/--simulation`).
+  - Use `mooniq run` for real sells.
+
+## Command templates (recommended: mooniq run)
+```bash
+# Quote
+mooniq run token_sell --input '{
+  "simulation": true,
+  "token": "<mint-or-address>",
+  "amount": 123.45
+}'
+
+# Execute (only after CONFIRM)
+mooniq run token_sell --input '{
+  "simulation": false,
+  "token": "<mint-or-address>",
+  "amount": 123.45
+}'
+```
+
+## Selling “all”
+1) Get current balance:
+```bash
+mooniq run token_balance_list --input '{"wallet":"<wallet>","chain":"solana"}'
+```
+2) Use the returned `balance.amount` as `amount` for `token_sell`.
+
+## Notes
+- If the user only provides a symbol/name, call `token_search` first to find the correct address.

package/mooniq-swap-tokens/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: mooniq-swap-tokens
+description: Swap tokens using Moon IQ CLI via token_swap. Use when the user requests a token A -> token B swap (not just buy/sell vs USDC).
+---
+
+# Swap tokens (MoonIQ CLI)
+
+## Tool schema (source of truth)
+- `src/tools/token/swap/schema.ts`
+- Tool: `token_swap`
+- Required input fields:
+  - `simulation` (boolean)
+  - `input` (string; input token mint/address)
+  - `output` (string; output token mint/address)
+  - `amount` (number; amount of input token)
+
+## Safety workflow (default)
+1) Run a **simulation** first and show the quote.
+2) Ask for explicit confirmation.
+3) Execute with `simulation:false`.
+
+## CLI commands
+- Preferred (scriptable + full params):
+  - `mooniq run token_swap --input '<json>'`
+
+- Convenience commands:
+  - `mooniq token swap`
+    - Per `--help`, the top-level command mostly exposes `--base-url`.
+  - `mooniq token swap recommend --query "swap 100 USDC for SOL"`
+    - This one is useful: it parses natural language into structured swap params.
+    - After you get the params, execute via `mooniq run token_swap --input ...`.
+
+## Command templates (recommended: mooniq run)
+```bash
+# Quote
+mooniq run token_swap --input '{
+  "simulation": true,
+  "input": "<input-mint-or-address>",
+  "output": "<output-mint-or-address>",
+  "amount": 1.23
+}'
+
+# Execute (only after CONFIRM)
+mooniq run token_swap --input '{
+  "simulation": false,
+  "input": "<input-mint-or-address>",
+  "output": "<output-mint-or-address>",
+  "amount": 1.23
+}'
+```
+
+## Notes
+- If the user only provides names/symbols, call `token_search` to resolve addresses.

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "moon-iq-skills",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "moon-iq-skills": "dist/index.js"
+  },
+  "files": [
+    "dist/**",
+    "mooniq-*/SKILL.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5"
+  }
+}