Agent Skills

An Agent Skill is a folder with a SKILL.md file (plus any helper scripts) that tells an agent what a task needs, which AIsa APIs to call, and how to call them. Agents load only each skill’s name and description at session start, then read the full instructions when a task matches. Skills work in any agentskills.io-compatible harness, including Claude Code, Codex, Cursor, Gemini CLI, OpenClaw, and others. The general-purpose aisa skill teaches your agent to find and call any AIsa tool; start with it in Install the Agent Skill. The specialized skills below package ready-made workflows for specific tasks. All of them live in AIsa-team/agent-skills.

Install a skill

npx skills add AIsa-team/agent-skills --skill <name>

npm install -g @aisa-one/cli
aisa skills install <name>

Both commands find the skill by name, regardless of which category folder it is in. With npx skills, add --agent <agent> and --global to choose where it is installed (see Install the Agent Skill). Start a new agent session afterward so the skill loads. Most skills call AIsa APIs with your AISA_API_KEY; calls are billed per request to your AIsa balance. Each skill page lists its own requirements.

Which skill should I pick?

Several skills deliberately overlap: broad skills pair with narrower, single-purpose entry points that handle one part of the same job. Pick the narrowest skill that covers your task; it gives the agent shorter, more focused instructions.

Financial & Markets

Skill	Best for	Pick it when
market	Stocks and crypto in one skill: prices, statements, metrics, filings, analyst ratings, insider trades, institutional holdings, news, and interest rates	You want one data skill that covers equities and crypto together
marketpulse	Equity data, including screening, segmented revenue, earnings press releases, and macro rates	The task is equities only and needs screening or deeper fundamentals
crypto-market-data	CoinGecko data: prices, OHLC, charts, contract-address lookup, exchanges, categories, trending tokens, and news	The task is crypto-specific, such as token lookup or exchange tickers
us-stock-analyst	Full US stock reports combining financials, news, social sentiment, and multi-model AI	You want a written research report, not raw data
stock-analysis	8-dimension scoring with BUY/HOLD/SELL signals, entry/target/stop prices, and risk flags	You want a scored signal for one or more tickers
stock-hot	Trending movers: gainers, losers, most active, crypto highlights, and catalysts	The question is “what’s moving right now?“
stock-rumors	Early signals: M&A rumors, insider activity, analyst changes, and regulatory news	You are hunting for catalysts before they are priced in
stock-dividend	Read-only dividend metrics: yield, payout, growth, safety score, and Aristocrat/King status	The question is about income or dividend safety
stock-portfolio	Portfolio positions with live P&L, stored locally between sessions	You want to track holdings over time
stock-watchlist	Watchlist with price-target and stop-loss alerts, stored locally	You want alerts on tickers you don’t own yet
prediction-market-data	Polymarket and Kalshi market and event discovery; live prices, order books, and candles come from each venue’s own API	You need to find and compare prediction markets
prediction-market-arbitrage	Shortlists likely-equivalent Polymarket and Kalshi markets; verify prices and depth on each venue before trading	You are researching arbitrage candidates, not just odds
trend-forecast	One trend score combining prediction-market odds, X sentiment, news velocity, and market data	You want a forecast that weighs several signal types

Chinese-language editions are documented in the Chinese docs: prediction-market-data-zh and prediction-market-arbitrage-zh.

Search & Research

Skill	Best for	Pick it when
multi-source-search	Every search mode in one skill: web, scholar, hybrid, Tavily search/extract/crawl/map, the Perplexity Sonar family, and parallel retrieval	You want one install that covers all search needs
multi-search	Parallel web, scholar, smart, and Tavily search with a confidence score and optional AI synthesis	You need cross-source validation of one question
web-search	Structured web results: titles, URLs, and snippets	A quick general web lookup is enough
scholar-search	Academic papers with year-range filters	You only need scholarly sources
smart-search	Web and academic results in one hybrid call	You want both kinds of sources without running two searches
tavily-search	Tavily search with depth, topic (general/news/finance), time range, domain filters, and an optional answer	You need fine control over a web search (Python client)
tavily-extract	Clean, readable text from one or more URLs	You already have the URLs and need their content
aisa-tavily	Tavily search and URL extraction together, via Node.js scripts	Your runtime has Node.js rather than Python, or you want search and extract in one small skill
perplexity-search	Perplexity Sonar, Sonar Pro, Sonar Reasoning Pro, and Sonar Deep Research, one command each, with an optional system prompt	You specifically want Perplexity answers and to choose the model yourself
perplexity-research	Citation-backed research answers from Sonar models, from fast to exhaustive	The task is a research question and you want a synthesized, cited answer
last30days	A ranked, clustered brief of the last 30 days across Reddit, X, YouTube, TikTok, Instagram, Hacker News, Polymarket, GitHub, and web	You need recent social evidence: launch reactions, trend scans, competitor or person profiles

A Chinese-language edition, last30days-zh, is documented in the Chinese docs. All six Twitter/X skills read through the AIsa relay with your AISA_API_KEY and never ask for passwords or cookies. Posting and engagement require a one-time OAuth approval in the browser. They differ in their write capabilities and instruction length:

Skill	Best for	Pick it when
aisa-twitter-api	Flagship read skill with watchlist-style monitoring, plus OAuth posting of text, images, or video	You mainly research and monitor X and post occasionally
aisa-twitter-command-center	Search profiles, tweets, trends, lists, communities, and Spaces, plus OAuth posting	You want read + post in a compact skill, without likes or follows
twitter-command-center-search-post	The same read + post surface with a full endpoint reference in the skill	You want read + post and the agent to see every endpoint and parameter
aisa-twitter-post-engage	Read + post + like/unlike and follow/unfollow	You need engagement actions as well as posting
x-intelligence-automation	The same read + post + engage surface in the shortest instructions	You want engagement actions with minimal context cost
twitter-autopilot	The full read + post + engage surface with detailed command and workflow references	You want one complete X skill and don’t mind longer instructions

For YouTube, all three skills call the same AIsa YouTube search endpoint:

Skill	Best for	Pick it when
youtube-serp	Ranked results via a Python client with `search`, `top-videos`, and `competitor` commands	You do content research or competitor tracking on YouTube
youtube-search	A full API reference with curl, Python, and JavaScript examples, pagination, and error handling	You want the agent to call the endpoint directly from its own code
aisa-youtube-search	A minimal curl-only skill with guardrails	You want the lightest install, with no Python

AI Models

Skill	Best for	Pick it when
llm-router	One OpenAI-compatible API for GPT, Claude, Gemini, Qwen, DeepSeek, Grok, and more	You want to route between model families with one key
cn-llm	Chinese models (Qwen, DeepSeek, GLM, and others) through one OpenAI-compatible interface	Your workload is Chinese-language or needs Chinese models specifically
aisa-provider	Configuring AIsa as a model provider in OpenClaw	You run OpenClaw and want AIsa models inside it

Marketing

Skill	Best for	Pick it when
seo-keyword-research	Keyword discovery, intent clusters, competitor gaps, and page ideas from DataForSEO	You are planning what to write or which pages to build
article-seo-geo-review	A scored SEO + GEO review of one draft or URL, with competitor gaps and AI-citation checks	You already have an article and want to improve it
use-similarweb	Website traffic, channels, audience, technologies, and search footprint, quoted before every call	The question is about a website’s traffic or audience
kol-creator-discovery	Creator emails and similar YouTube/TikTok creators from one profile, as an outreach table	You need a contact list of similar creators
creator-marketing	End-to-end partnership planning: shortlist, deal model, pilot budget, brief, outreach, and measurement	You are designing a creator or UGC program, not just finding names
product-selection	What to sell, where, and at what price, using live evidence over MCP and offline pricing helpers	You are choosing products, markets, or prices as a seller

Creative

Skill	Best for	Pick it when
media-gen	Image and video generation with one client that routes each model to the right endpoint	You want an agent to generate images, text-to-video, or image-to-video

Where the AIsa CLI installs skills

aisa skills install writes the skill into every supported agent it detects on your machine (or all of them if none is detected). Use --agent <name> to target one, or --agent all.

Agent	`--agent`	Directory
Claude Code	`claude`	`~/.claude/skills/`
Cursor	`cursor`	`~/.cursor/skills/`
GitHub Copilot	`copilot`	`~/.github/skills/`
Windsurf	`windsurf`	`~/.codeium/windsurf/skills/`
Codex	`codex`	`~/.agents/skills/`
Gemini CLI	`gemini`	`~/.gemini/skills/`
OpenClaw	`openclaw`	`~/.openclaw/skills/`

Learn more

Standards

How to structure a SKILL.md and publish your own skill to the registry.

Skills or direct APIs?

When to use a ready-made skill vs. calling APIs directly.

Get support

Questions? Reach out to the team at developer@aisa.one.

Overview

Financial & Markets

Search & Research

Social Media

AI Models

Marketing

Creative

Agent Skills

Install a skill

Which skill should I pick?

Financial & Markets

Search & Research

AI Models

Marketing

Creative

Where the AIsa CLI installs skills

Learn more

Standards

Skills or direct APIs?

Get support

​Install a skill

​Which skill should I pick?

​Financial & Markets

​Search & Research

​Social Media

​AI Models

​Marketing

​Creative

​Where the AIsa CLI installs skills

​Learn more

Standards

Skills or direct APIs?

Get support

Install a skill

Which skill should I pick?

Financial & Markets

Search & Research

Social Media

AI Models

Marketing

Creative

Where the AIsa CLI installs skills

Learn more