Sorin Skill

Pre-flight Dependencies (auto-injected by Plugin Store CI)

Run once per session before first use. These checks ensure required tools are installed.

Version check (auto-injected)

AI Agent Instruction: Run this version check before executing any commands from this skill. The check is a read-only fetch from raw.githubusercontent.com — it does not install anything. If it reports Update available, you MUST stop, surface the message to the user verbatim, and obtain explicit confirmation before running the suggested npx skills add … command. Do not run the update silently. After a confirmed update completes, re-read this SKILL.md before proceeding.

# Check for skill updates (1-hour cache).
# Network scope: this block calls raw.githubusercontent.com for the version probe only.
# It does NOT install anything; install requires user-confirmed `npx skills add` below.
UPDATE_CACHE="$HOME/.plugin-store/update-cache/sorin-skill"
CACHE_MAX=3600
LOCAL_VER="1.0.1"
DO_CHECK=true

if [ -f "$UPDATE_CACHE" ]; then
  CACHE_MOD=$(stat -f %m "$UPDATE_CACHE" 2>/dev/null || stat -c %Y "$UPDATE_CACHE" 2>/dev/null || echo 0)
  NOW=$(date +%s)
  AGE=$(( NOW - CACHE_MOD ))
  [ "$AGE" -lt "$CACHE_MAX" ] && DO_CHECK=false
fi

if [ "$DO_CHECK" = true ]; then
  REMOTE_VER=$(curl -sf --max-time 3 "https://raw.githubusercontent.com/okx/plugin-store/main/skills/sorin-skill/plugin.yaml" | grep '^version' | head -1 | tr -d '"' | awk '{print $2}')
  if [ -n "$REMOTE_VER" ]; then
    mkdir -p "$HOME/.plugin-store/update-cache"
    echo "$REMOTE_VER" > "$UPDATE_CACHE"
  fi
fi

REMOTE_VER=$(cat "$UPDATE_CACHE" 2>/dev/null || echo "$LOCAL_VER")
if [ "$REMOTE_VER" != "$LOCAL_VER" ]; then
  echo "Update available: sorin-skill v$LOCAL_VER -> v$REMOTE_VER."
  echo "ACTION REQUIRED: ask the user to confirm before running:"
  echo "  npx skills add okx/plugin-store --skill sorin-skill --global"
  echo "(This contacts the npm registry and github.com/okx/plugin-store and overwrites this skill. Do NOT auto-run.)"
fi

---

Sorin Skill

Overview

Sorin Skill helps answer crypto-related questions about tokens, pools, chains, protocols, and projects through Sahara's Sorin DeFi AI Services Gateway. It identifies the user's intent, selects the most relevant gateway endpoint, and returns concise, data-backed analysis with assumptions and risks.

Gateway

• Base URL: https://defi-tools-proxy.saharaa.info
• API key env var: DEFI_TOOLS_API_KEY
• Auth header: Authorization: Bearer ${DEFI_TOOLS_API_KEY}
• Accept header: accept: text/plain

Default request template:

GET https://defi-tools-proxy.saharaa.info/<path>?<query>
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

Pool analysis example:

GET https://defi-tools-proxy.saharaa.info/pool/analysis?chain=Ethereum
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

Quick Start

1. Run sorin-skill quickstart. 2. Verify DEFI_TOOLS_API_KEY is set in the agent runtime. 3. Check gateway connectivity using the pool analysis example. 4. If successful, confirm Sorin Skill is ready and suggest a token, pool, chain, protocol, or project analysis prompt. 5. If failed, return the gateway status and exact error message.

Intention Routing

1. Detect user intention from natural language. 2. Select exactly one primary API first (add secondary APIs only when needed). 3. Validate required inputs. If missing, ask only the minimum follow-up question. 4. Call API and parse success, data, error.

Intention -> API Mapping

1) Token fundamentals / price / holders / technicals

• API: tokenTool
• Use when: user asks token market analysis (macro liquidity + micro market structure).
• Input:
• token_symbol (required): token symbol, e.g. BTC, ETH
• quote_currency (optional, default USDT): quote currency for the pair
• Request:

GET https://defi-tools-proxy.saharaa.info/token/analysis?token_symbol=ETH&quote_currency=USDT
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

2) Yield/staking pool discovery and scoring

• API: poolTool
• Use when: user asks where to stake, best APY pools, pool comparison, TVL/APY trends.
• Input (all optional filters):
• chain (optional): chain id string, e.g. 1, 56
• project (optional): project slug, e.g. lido, aave-v3
• protocol (e.g. lido, aave-v3)
• token_symbol (e.g. ETH, USDC)
• pool_id (optional): unique pool identifier
• pool_category (optional): pool category filter
• Request:

GET https://defi-tools-proxy.saharaa.info/pool/analysis?chain=Ethereum&protocol=lido&token_symbol=ETH
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

3) Chain-level DEX and TVL landscape

• API: chainTool
• Use when: user asks chain DEX volume trends, TVL changes, protocol dominance on a chain.
• Input (optional, provide one when possible):
• chainId (integer): chain id, e.g. 1
• chainName (string): chain name, e.g. Ethereum
• Request:

GET https://defi-tools-proxy.saharaa.info/chain/analysis?chainName=Ethereum
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

4) Protocol-level financial analysis

• API: protocolTool
• Use when: user asks protocol TVL/fees/revenue/capital flow and comprehensive metrics.
• Request:

GET https://defi-tools-proxy.saharaa.info/protocol/analysis?protocol=aave
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

5) Prediction market and project outlook

• API: projectTool
• Use when: user asks project odds, FDV expectations, short/long-term target prices, market sentiment for a project.
• Input:
• projectName (required): project name, e.g. berachain
• Request:

GET https://defi-tools-proxy.saharaa.info/project/analysis?projectName=berachain
Headers:
accept: text/plain
Authorization: Bearer ${DEFI_TOOLS_API_KEY}

Output Style for End Users

Use this response structure:

1. What I queried: API name and key parameters. 2. Key findings: 3-5 bullets with metrics. 3. Interpretation: trend/risk/opportunity in plain language. 4. Actionable next step: one concrete follow-up. 5. Confidence and caveats: missing fields, stale windows, low liquidity effects.

Decision Heuristics

• If question is asset-specific, start with tokenTool.
• If question is yield-focused, start with poolTool.
• If question is chain ecosystem-focused, use chainTool.
• If question is protocol financial health-focused, use protocolTool.
• If question is project narrative or valuation-focused, use projectTool.

Safety Rules

• Never invent prices, holders, APY, TVL, or tx outcomes.
• If API returns failure, surface the exact reason and suggest one retry path.
• Ask follow-up questions only for missing required parameters.
• Keep chain IDs explicit when ambiguity exists.

<p align="center"> <img src="./assets/sorin-skill-banner.png" alt="Sorin Skill banner" width="1100" /> </p>

Sorin Skill

Run your agent with Sorin.

sorin-skill helps an agent answer DeFi questions about tokens, pools, chains, protocols, and projects using Sahara's DeFi AI Services Gateway. It detects user intent, calls the most relevant endpoint, and returns concise, data-backed analysis.

Quick Start

1. Get a Sorin API key

The easiest path is the Sorin setup page:

https://tools.saharaai.com/sorin-skills/

2. Install the skill

   npx skills add https://github.com/SaharaLabsAI/skills/tree/main/sorin-skill

3. Expose your API key to the runtime

Add DEFI_TOOLS_API_KEY to the environment used by your agent runtime.

   # zsh (macOS default)
   echo 'export DEFI_TOOLS_API_KEY="your_api_key_here"' >> ~/.zshrc
   source ~/.zshrc

   # bash
   echo 'export DEFI_TOOLS_API_KEY="your_api_key_here"' >> ~/.bashrc
   source ~/.bashrc

4. Restart your agent service

To make sure your agent picks up the new skill & environment variable.

OpenClaw Setup

If you manage environment variables through OpenClaw instead of your shell:

1. Open Config from the left sidebar. 2. Switch to the Environment tab. 3. Add DEFI_TOOLS_API_KEY with your Sorin API key as the value. 4. Save and restart the service.

What This Skill Covers

• Token analysis: fundamentals, price structure, holders, and market context
• Pool analysis: yield discovery, staking opportunities, and pool comparison
• Chain analysis: DEX volume trends, TVL changes, and protocol dominance
• Protocol analysis: TVL, fees, revenue, and capital flow
• Project analysis: market outlook, valuation narrative, and sentiment

Example Prompts

• "Analyze this token's current risk and opportunity profile."
• "Compare the yield and risk of these two pools."
• "What are the key metrics for this protocol on Arbitrum?"
• "Which ETH staking pools look strongest right now?"
• "How has Ethereum DEX activity changed recently?"

Troubleshooting

• 401 or auth errors: confirm DEFI_TOOLS_API_KEY is set in the same environment as the runtime.
• The skill does not pick up the key: restart the agent service after adding the environment variable.
• You lost the API key value: generate a new one, since the original is only shown once.

Overview

Sorin Skill routes DeFi questions about tokens, pools, chains, protocols, and projects to Sahara's Sorin DeFi AI Services Gateway. It helps agents choose the right analysis endpoint, call it with explicit parameters, and summarize the returned data with assumptions and risks.

Prerequisites

• DEFI_TOOLS_API_KEY set in the environment.
• Network access to https://defi-tools-proxy.saharaa.info.
• Required user inputs such as token symbol, protocol name, project name, chain name, or pool filters.

Quick Start

1. Run sorin-skill quickstart to verify DEFI_TOOLS_API_KEY is set and the gateway is reachable. 2. Ask a token question using a symbol such as ETH or BTC. 3. For yield or staking analysis, provide a chain, protocol, token symbol, or pool ID when available. 4. For protocol or project analysis, provide the protocol or project name. 5. Review the returned findings, assumptions, risks, next steps, and caveats.