@rubix0270/arboris 1.0.2 → 1.0.4

package/prisma/skills/evm-token-decimals/SKILL.md

@@ -1,131 +0,0 @@
----
-name: evm-token-decimals
-description: Prevent silent decimal mismatch bugs across EVM chains. Covers runtime decimal lookup, chain-aware caching, bridged-token precision drift, and safe normalization for bots, dashboards, and DeFi tools.
-metadata:
-  origin: ECC direct-port adaptation
-version: "1.0.0"
----
-
-# EVM Token Decimals
-
-Silent decimal mismatches are one of the easiest ways to ship balances or USD values that are off by orders of magnitude without throwing an error.
-
-## When to Use
-
-- Reading ERC-20 balances in Python, TypeScript, or Solidity
-- Calculating fiat values from on-chain balances
-- Comparing token amounts across multiple EVM chains
-- Handling bridged assets
-- Building portfolio trackers, bots, or aggregators
-
-## How It Works
-
-Never assume stablecoins use the same decimals everywhere. Query `decimals()` at runtime, cache by `(chain_id, token_address)`, and use decimal-safe math for value calculations.
-
-## Examples
-
-### Query decimals at runtime
-
-```python
-from decimal import Decimal
-from web3 import Web3
-
-ERC20_ABI = [
-    {"name": "decimals", "type": "function", "inputs": [],
-     "outputs": [{"type": "uint8"}], "stateMutability": "view"},
-    {"name": "balanceOf", "type": "function",
-     "inputs": [{"name": "account", "type": "address"}],
-     "outputs": [{"type": "uint256"}], "stateMutability": "view"},
-]
-
-def get_token_balance(w3: Web3, token_address: str, wallet: str) -> Decimal:
-    contract = w3.eth.contract(
-        address=Web3.to_checksum_address(token_address),
-        abi=ERC20_ABI,
-    )
-    decimals = contract.functions.decimals().call()
-    raw = contract.functions.balanceOf(Web3.to_checksum_address(wallet)).call()
-    return Decimal(raw) / Decimal(10 ** decimals)
-```
-
-Do not hardcode `1_000_000` because a symbol usually has 6 decimals somewhere else.
-
-### Cache by chain and token
-
-```python
-from functools import lru_cache
-
-@lru_cache(maxsize=512)
-def get_decimals(chain_id: int, token_address: str) -> int:
-    w3 = get_web3_for_chain(chain_id)
-    contract = w3.eth.contract(
-        address=Web3.to_checksum_address(token_address),
-        abi=ERC20_ABI,
-    )
-    return contract.functions.decimals().call()
-```
-
-### Handle odd tokens defensively
-
-```python
-try:
-    decimals = contract.functions.decimals().call()
-except Exception:
-    logging.warning(
-        "decimals() reverted on %s (chain %s), defaulting to 18",
-        token_address,
-        chain_id,
-    )
-    decimals = 18
-```
-
-Log the fallback and keep it visible. Old or non-standard tokens still exist.
-
-### Normalize to 18-decimal WAD in Solidity
-
-```solidity
-interface IERC20Metadata {
-    function decimals() external view returns (uint8);
-}
-
-function normalizeToWad(address token, uint256 amount) internal view returns (uint256) {
-    uint8 d = IERC20Metadata(token).decimals();
-    if (d == 18) return amount;
-    if (d < 18) return amount * 10 ** (18 - d);
-    return amount / 10 ** (d - 18);
-}
-```
-
-### TypeScript with ethers
-
-```typescript
-import { Contract, formatUnits } from 'ethers';
-
-const ERC20_ABI = [
-  'function decimals() view returns (uint8)',
-  'function balanceOf(address) view returns (uint256)',
-];
-
-async function getBalance(provider: any, tokenAddress: string, wallet: string): Promise<string> {
-  const token = new Contract(tokenAddress, ERC20_ABI, provider);
-  const [decimals, raw] = await Promise.all([
-    token.decimals(),
-    token.balanceOf(wallet),
-  ]);
-  return formatUnits(raw, decimals);
-}
-```
-
-### Quick on-chain check
-
-```bash
-cast call <token_address> "decimals()(uint8)" --rpc-url <rpc>
-```
-
-## Rules
-
-- Always query `decimals()` at runtime
-- Cache by chain plus token address, not symbol
-- Use `Decimal`, `BigInt`, or equivalent exact math, not float
-- Re-query decimals after bridging or wrapper changes
-- Normalize internal accounting consistently before comparison or pricing

package/prisma/skills/exa-search/SKILL.md

@@ -1,108 +0,0 @@
----
-name: exa-search
-description: Neural search via Exa MCP for web, code, and company research. Use when the user needs web search, code examples, company intel, people lookup, or AI-powered deep research with Exa's neural search engine.
-metadata:
-  origin: ECC
----
-
-# Exa Search
-
-> **Drift-prone skill.** Exa MCP tool names, parameters, and account limits can
-> change. Confirm the exposed tool surface and current Exa docs before relying
-> on a specific search mode, category, or livecrawl behavior.
-
-Neural search for web content, code, companies, and people via the Exa MCP server.
-
-## When to Activate
-
-- User needs current web information or news
-- Searching for code examples, API docs, or technical references
-- Researching companies, competitors, or market players
-- Finding professional profiles or people in a domain
-- Running background research for any development task
-- User says "search for", "look up", "find", or "what's the latest on"
-
-## MCP Requirement
-
-Exa MCP server must be configured. Add to `~/.claude.json`:
-
-```json
-"exa-web-search": {
-  "command": "npx",
-  "args": ["-y", "exa-mcp-server"],
-  "env": { "EXA_API_KEY": "YOUR_EXA_API_KEY_HERE" }
-}
-```
-
-Get an API key at [exa.ai](https://exa.ai).
-This repo's current Exa setup documents the tool surface exposed here: `web_search_exa` and `get_code_context_exa`.
-If your Exa server exposes additional tools, verify their exact names before depending on them in docs or prompts.
-
-## Core Tools
-
-### web_search_exa
-General web search for current information, news, or facts.
-
-```
-web_search_exa(query: "latest AI developments 2026", numResults: 5)
-```
-
-**Parameters:**
-
-| Param | Type | Default | Notes |
-|-------|------|---------|-------|
-| `query` | string | required | Search query |
-| `numResults` | number | 8 | Number of results |
-| `type` | string | `auto` | Search mode |
-| `livecrawl` | string | `fallback` | Prefer live crawling when needed |
-| `category` | string | none | Optional focus such as `company` or `research paper` |
-
-### get_code_context_exa
-Find code examples and documentation from GitHub, Stack Overflow, and docs sites.
-
-```
-get_code_context_exa(query: "Python asyncio patterns", tokensNum: 3000)
-```
-
-**Parameters:**
-
-| Param | Type | Default | Notes |
-|-------|------|---------|-------|
-| `query` | string | required | Code or API search query |
-| `tokensNum` | number | 5000 | Content tokens (1000-50000) |
-
-## Usage Patterns
-
-### Quick Lookup
-```
-web_search_exa(query: "Node.js 22 new features", numResults: 3)
-```
-
-### Code Research
-```
-get_code_context_exa(query: "Rust error handling patterns Result type", tokensNum: 3000)
-```
-
-### Company or People Research
-```
-web_search_exa(query: "Vercel funding valuation 2026", numResults: 3, category: "company")
-web_search_exa(query: "site:linkedin.com/in AI safety researchers Anthropic", numResults: 5)
-```
-
-### Technical Deep Dive
-```
-web_search_exa(query: "WebAssembly component model status and adoption", numResults: 5)
-get_code_context_exa(query: "WebAssembly component model examples", tokensNum: 4000)
-```
-
-## Tips
-
-- Use `web_search_exa` for current information, company lookups, and broad discovery
-- Use search operators like `site:`, quoted phrases, and `intitle:` to narrow results
-- Lower `tokensNum` (1000-2000) for focused code snippets, higher (5000+) for comprehensive context
-- Use `get_code_context_exa` when you need API usage or code examples rather than general web pages
-
-## Related Skills
-
-- `deep-research` — Full research workflow using firecrawl + exa together
-- `market-research` — Business-oriented research with decision frameworks

package/prisma/skills/fal-ai-media/SKILL.md

@@ -1,289 +0,0 @@
----
-name: fal-ai-media
-description: Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.
-metadata:
-  origin: ECC
----
-
-# fal.ai Media Generation
-
-> **Drift-prone skill.** fal.ai model IDs, pricing, inputs, and MCP tool names
-> change quickly. Search or fetch the current model metadata before promising a
-> specific model, parameter, output format, or cost.
-
-Generate images, videos, and audio using fal.ai models via MCP.
-
-## When to Activate
-
-- User wants to generate images from text prompts
-- Creating videos from text or images
-- Generating speech, music, or sound effects
-- Any media generation task
-- User says "generate image", "create video", "text to speech", "make a thumbnail", or similar
-
-## MCP Requirement
-
-fal.ai MCP server must be configured. Add to `~/.claude.json`:
-
-```json
-"fal-ai": {
-  "command": "npx",
-  "args": ["-y", "fal-ai-mcp-server"],
-  "env": { "FAL_KEY": "YOUR_FAL_KEY_HERE" }
-}
-```
-
-Get an API key at [fal.ai](https://fal.ai).
-
-## MCP Tools
-
-The fal.ai MCP provides these tools:
-- `search` — Find available models by keyword
-- `find` — Get model details and parameters
-- `generate` — Run a model with parameters
-- `result` — Check async generation status
-- `status` — Check job status
-- `cancel` — Cancel a running job
-- `estimate_cost` — Estimate generation cost
-- `models` — List popular models
-- `upload` — Upload files for use as inputs
-
----
-
-## Image Generation
-
-### Nano Banana 2 (Fast)
-Best for: quick iterations, drafts, text-to-image, image editing.
-
-```
-generate(
-  app_id: "fal-ai/nano-banana-2",
-  input_data: {
-    "prompt": "a futuristic cityscape at sunset, cyberpunk style",
-    "image_size": "landscape_16_9",
-    "num_images": 1,
-    "seed": 42
-  }
-)
-```
-
-### Nano Banana Pro (High Fidelity)
-Best for: production images, realism, typography, detailed prompts.
-
-```
-generate(
-  app_id: "fal-ai/nano-banana-pro",
-  input_data: {
-    "prompt": "professional product photo of wireless headphones on marble surface, studio lighting",
-    "image_size": "square",
-    "num_images": 1,
-    "guidance_scale": 7.5
-  }
-)
-```
-
-### Common Image Parameters
-
-| Param | Type | Options | Notes |
-|-------|------|---------|-------|
-| `prompt` | string | required | Describe what you want |
-| `image_size` | string | `square`, `portrait_4_3`, `landscape_16_9`, `portrait_16_9`, `landscape_4_3` | Aspect ratio |
-| `num_images` | number | 1-4 | How many to generate |
-| `seed` | number | any integer | Reproducibility |
-| `guidance_scale` | number | 1-20 | How closely to follow the prompt (higher = more literal) |
-
-### Image Editing
-Use Nano Banana 2 with an input image for inpainting, outpainting, or style transfer:
-
-```
-# First upload the source image
-upload(file_path: "/path/to/image.png")
-
-# Then generate with image input
-generate(
-  app_id: "fal-ai/nano-banana-2",
-  input_data: {
-    "prompt": "same scene but in watercolor style",
-    "image_url": "<uploaded_url>",
-    "image_size": "landscape_16_9"
-  }
-)
-```
-
----
-
-## Video Generation
-
-### Seedance 1.0 Pro (ByteDance)
-Best for: text-to-video, image-to-video with high motion quality.
-
-```
-generate(
-  app_id: "fal-ai/seedance-1-0-pro",
-  input_data: {
-    "prompt": "a drone flyover of a mountain lake at golden hour, cinematic",
-    "duration": "5s",
-    "aspect_ratio": "16:9",
-    "seed": 42
-  }
-)
-```
-
-### Kling Video v3 Pro
-Best for: text/image-to-video with native audio generation.
-
-```
-generate(
-  app_id: "fal-ai/kling-video/v3/pro",
-  input_data: {
-    "prompt": "ocean waves crashing on a rocky coast, dramatic clouds",
-    "duration": "5s",
-    "aspect_ratio": "16:9"
-  }
-)
-```
-
-### Veo 3 (Google DeepMind)
-Best for: video with generated sound, high visual quality.
-
-```
-generate(
-  app_id: "fal-ai/veo-3",
-  input_data: {
-    "prompt": "a bustling Tokyo street market at night, neon signs, crowd noise",
-    "aspect_ratio": "16:9"
-  }
-)
-```
-
-### Image-to-Video
-Start from an existing image:
-
-```
-generate(
-  app_id: "fal-ai/seedance-1-0-pro",
-  input_data: {
-    "prompt": "camera slowly zooms out, gentle wind moves the trees",
-    "image_url": "<uploaded_image_url>",
-    "duration": "5s"
-  }
-)
-```
-
-### Video Parameters
-
-| Param | Type | Options | Notes |
-|-------|------|---------|-------|
-| `prompt` | string | required | Describe the video |
-| `duration` | string | `"5s"`, `"10s"` | Video length |
-| `aspect_ratio` | string | `"16:9"`, `"9:16"`, `"1:1"` | Frame ratio |
-| `seed` | number | any integer | Reproducibility |
-| `image_url` | string | URL | Source image for image-to-video |
-
----
-
-## Audio Generation
-
-### CSM-1B (Conversational Speech)
-Text-to-speech with natural, conversational quality.
-
-```
-generate(
-  app_id: "fal-ai/csm-1b",
-  input_data: {
-    "text": "Hello, welcome to the demo. Let me show you how this works.",
-    "speaker_id": 0
-  }
-)
-```
-
-### ThinkSound (Video-to-Audio)
-Generate matching audio from video content.
-
-```
-generate(
-  app_id: "fal-ai/thinksound",
-  input_data: {
-    "video_url": "<video_url>",
-    "prompt": "ambient forest sounds with birds chirping"
-  }
-)
-```
-
-### ElevenLabs (via API, no MCP)
-For professional voice synthesis, use ElevenLabs directly:
-
-```python
-import os
-import requests
-
-resp = requests.post(
-    "https://api.elevenlabs.io/v1/text-to-speech/<voice_id>",
-    headers={
-        "xi-api-key": os.environ["ELEVENLABS_API_KEY"],
-        "Content-Type": "application/json"
-    },
-    json={
-        "text": "Your text here",
-        "model_id": "eleven_turbo_v2_5",
-        "voice_settings": {"stability": 0.5, "similarity_boost": 0.75}
-    }
-)
-with open("output.mp3", "wb") as f:
-    f.write(resp.content)
-```
-
-### VideoDB Generative Audio
-If VideoDB is configured, use its generative audio:
-
-```python
-# Voice generation
-audio = coll.generate_voice(text="Your narration here", voice="alloy")
-
-# Music generation
-music = coll.generate_music(prompt="upbeat electronic background music", duration=30)
-
-# Sound effects
-sfx = coll.generate_sound_effect(prompt="thunder crack followed by rain")
-```
-
----
-
-## Cost Estimation
-
-Before generating, check estimated cost:
-
-```
-estimate_cost(
-  estimate_type: "unit_price",
-  endpoints: {
-    "fal-ai/nano-banana-pro": {
-      "unit_quantity": 1
-    }
-  }
-)
-```
-
-## Model Discovery
-
-Find models for specific tasks:
-
-```
-search(query: "text to video")
-find(endpoint_ids: ["fal-ai/seedance-1-0-pro"])
-models()
-```
-
-## Tips
-
-- Use `seed` for reproducible results when iterating on prompts
-- Start with lower-cost models (Nano Banana 2) for prompt iteration, then switch to Pro for finals
-- For video, keep prompts descriptive but concise — focus on motion and scene
-- Image-to-video produces more controlled results than pure text-to-video
-- Check `estimate_cost` before running expensive video generations
-
-## Related Skills
-
-- `videodb` — Video processing, editing, and streaming
-- `video-editing` — AI-powered video editing workflows
-- `content-engine` — Content creation for social platforms