Skip to main content
Skills are specialized tools built by the community or connected via APIs. They extend Zark’s capabilities into domains that core tools don’t cover — blockchain analytics, social media data, sports statistics, financial feeds, and more.

How Discovery Works

You don’t browse or install skills manually. When you ask a question that core tools can’t answer, Zark searches the Marketplace automatically and finds the best matching skill for your query. The Marketplace matches by meaning, not just keywords. Asking “show me whale wallet activity” matches a blockchain analytics skill even if the skill description doesn’t contain the word “whale.”

Via the API

Let Zark discover skills automatically, or force a Marketplace search:
import requests

response = requests.post(
    "https://api.zarkai.xyz/v1/chat",
    headers={
        "x-api-key": "your_api_key",
        "Content-Type": "application/json",
    },
    json={
        "messages": [
            {"role": "user", "content": "What tools do you have for social media analytics?"}
        ],
        "workspace_id": "wks-xxxxx",
        "tools": ["marketplace"],
        "tool_choice": "marketplace",
    },
)

data = response.json()
print(data["response"])

Automatic Execution

In most cases, discovery and execution happen in a single request. You ask a question, Zark finds the right skill, runs it, and returns the answer:
{
  "messages": [
    {"role": "user", "content": "What's the 24h trading volume on Uniswap?"}
  ],
  "workspace_id": "wks-xxxxx",
  "tool_choice": "auto"
}
Zark discovers a DeFi analytics skill, executes it, and returns the results — all in one request.

Types of Skills

TypeDescriptionExamples
Provider groupsA collection of related endpoints from a single providerDeFi analytics suite, social media toolkit
Individual endpointsA specific API query with defined parameters and outputToken price lookup, wallet risk score
Shared datasetsCurated data tables published by community membersHistorical market data, geographic datasets

Follow-Up Questions

Once a skill has been used in a conversation, it stays available for follow-up questions. You don’t need to re-discover it:
// First message — discovers and uses a DeFi analytics skill
"Show me Uniswap V3 volume"

// Follow-up — uses the same skill directly
"Now compare that to SushiSwap"

Examples

What's the trading volume for Uniswap V3 today?
Show me the risk score for this wallet address
What tools do you have for sports analytics?
Pull social engagement metrics for this account