Agent skill

Kagi Usage

Search the web, extract or summarize a page, translate it, or check the news with the kagi CLI instead of WebSearch or WebFetch.

MITAuto-check passedProductivity & Automation

Install Kagi Usage

skills CLI

$ npx skills add Microck/kagi-cli --skill kagi-usage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install Microck/kagi-cli kagi-usage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/Microck/kagi-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/kagi-usage .claude/skills/kagi-usage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "kagi-usage" agent skill from https://github.com/Microck/kagi-cli/tree/main/skills/kagi-usage into .claude/skills/kagi-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kagi-usage", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Microck/kagi-cli/tree/main/skills/kagi-usage

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Microck/kagi-cli --skill kagi-usage -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Microck/kagi-cli kagi-usage --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Microck/kagi-cli.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/kagi-usage .agents/skills/kagi-usage && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "kagi-usage" agent skill from https://github.com/Microck/kagi-cli/tree/main/skills/kagi-usage into .agents/skills/kagi-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kagi-usage", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Microck/kagi-cli --skill kagi-usage -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Microck/kagi-cli kagi-usage --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Microck/kagi-cli.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/kagi-usage .cursor/skills/kagi-usage && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "kagi-usage" agent skill from https://github.com/Microck/kagi-cli/tree/main/skills/kagi-usage into .cursor/skills/kagi-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kagi-usage", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Microck/kagi-cli.git --path skills/kagi-usage

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Microck/kagi-cli --skill kagi-usage -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Microck/kagi-cli kagi-usage --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Microck/kagi-cli.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/kagi-usage .gemini/skills/kagi-usage && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "kagi-usage" agent skill from https://github.com/Microck/kagi-cli/tree/main/skills/kagi-usage into .gemini/skills/kagi-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kagi-usage", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Microck/kagi-cli kagi-usage

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Microck/kagi-cli --skill kagi-usage -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Microck/kagi-cli.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/kagi-usage .github/skills/kagi-usage && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "kagi-usage" agent skill from https://github.com/Microck/kagi-cli/tree/main/skills/kagi-usage into .github/skills/kagi-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kagi-usage", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Microck/kagi-cli --skill kagi-usage -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Microck/kagi-cli kagi-usage --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Microck/kagi-cli.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/kagi-usage .opencode/skills/kagi-usage && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "kagi-usage" agent skill from https://github.com/Microck/kagi-cli/tree/main/skills/kagi-usage into .opencode/skills/kagi-usage/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kagi-usage", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: kagi-usage
GitHub stars: 178
Token cost: ~1.9k tokens
SKILL.md length: 773 words
Files: 1
Skills in repo: 5
Repo updated: Oct 6, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Search the web, extract or summarize a page, translate it, or check the news with the kagi CLI instead of WebSearch or WebFetch.

Works in 6 steps: Define the claim or question that needs… → Start with one broad search, or quick… → Split the topic into distinct queries… → …
Tasks that involve Web search
SKILL.md covers Route the task, Search the web, Work with one page and Shared rules, plus 2 more sections
Needs KAGI_API_KEY and KAGI_API_TOKEN

What it does

Kagi Usage is an agent skill from Microck/kagi-cli. Search the web, extract or summarize a page, translate it, or check the news with the kagi CLI instead of WebSearch or WebFetch. Load this first for any Kagi task: it covers search and page content, and routes Assistant, automation, and account work to the right skill.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Web search. The repository describes itself as: terminal CLI for Kagi that gives you command-line access to search, lenses, assistant, summarization, feeds, and paid API commands. The licence is MIT.

When your agent uses it

Tasks that involve Web search

Example prompts

“/kagi-usage”

Requirements

A credential in KAGI_API_KEY
A credential in KAGI_API_TOKEN
Pre-approved tools (allowed-tools): Bash(kagi:*), Skill(kagi:*)

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

Define the claim or question that needs evidence.
Start with one broad search, or quick for a bounded factual question.
Split the topic into distinct queries when one query cannot cover it.
Prefer primary sources and direct evidence.
Use --follow only when the user needs the top result pages summarized.
Report source disagreement instead of flattening it.

What it can do on your machine

Read from SKILL.md and the folder at commit 99ce2be. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash(kagi:*)
- Skill(kagi:*)
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- KAGI_API_KEY
- KAGI_API_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kagi Usage loads about 1.9k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 773 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~70
When it runs · the whole SKILL.md, loaded when a task matches: ~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Microck/kagi-cli at commit 99ce2be, republished under its MIT licence (© Microck). 773 words, ~1,852 tokens.

Download SKILL.mdSave it as .claude/skills/kagi-usage/SKILL.md (or your agent's skills folder).

name: kagi-usage
description: Search the web, extract or summarize a page, translate it, or check the news with the kagi CLI instead of WebSearch or WebFetch. Load this first for any Kagi task: it covers search and page content, and routes Assistant, automation, and account work to the right skill.
allowed-tools: Bash(kagi:*), Skill(kagi:*)

Kagi CLI

Search the web and read pages with kagi. Route every other Kagi task to the skill named below.

Route the task

User intent	Where
Find, compare, or verify information from the web	Search the web (below)
Read, summarize, question, or translate a known page	Work with one page (below)
Use paid AI for reasoning, coding, research, or files	`kagi-ai`
Continue a conversation or manage Assistant state	`kagi-assistant`
Run searches in bulk or monitor changes over time	`kagi-monitoring`
Configure credentials or account search behavior	`kagi-account-config`
Search or read mail	`kagi mail` (below)

Load the skill when it appears in the available skills listing. Otherwise run kagi skills get <name> for the same guidance.

bash

kagi skills list
kagi skills get kagi-assistant

Search the web

Discover sources, narrow the question, and return evidence that matches the depth the user asked for.

Need	Command
Direct answer with references	`kagi quick`
Ranked web results	`kagi search`
Search and summarize top pages	`kagi search --follow N`
Current news stories	`kagi news` or `kagi search --news`
Independent personal sites	`kagi smallweb`
Several independent queries	`kagi batch`

quick, session-only search controls, and the subscriber search path require session auth. The current Search API uses KAGI_API_KEY. Public news and smallweb need no credentials.

Define the claim or question that needs evidence.
Start with one broad search, or quick for a bounded factual question.
Split the topic into distinct queries when one query cannot cover it.
Prefer primary sources and direct evidence.
Use --follow only when the user needs the top result pages summarized.
Report source disagreement instead of flattening it.

bash

kagi search "rust async cancellation" --format toon --limit 5
kagi quick "what is the current Kagi Search API endpoint?" --format markdown

Search controls

bash

kagi search "query" --region us --format toon --limit 10
kagi search "query" --time month --order recency --format json
kagi search "query" --snap reddit --format toon
kagi search "query" --lens 2 --format toon
kagi search "query" --follow 3 --format markdown

Session-only controls include --lens, --time, --order, --verbatim, personalization flags, and News vertical search. Use --local-cache only when stale results are acceptable.

Query design

Quote exact error messages or disputed phrases.
Add official domains with site: when a primary source is known.
Use native-language query terms for regional or multilingual research.
Separate discovery, counterevidence, and recency into different queries.
Use --region as a result bias, never as a language guarantee.

bash

kagi batch \
  "topic official documentation" \
  "topic limitations" \
  "topic independent review" \
  --format toon --limit 5

News and discovery

bash

kagi news --category tech --limit 10
kagi news --list-categories
kagi news --chaos
kagi search "open source ai" --news --format toon
kagi smallweb

Use news for the public Kagi News feed. Use search --news when the query must filter the News vertical.

Work with one page

Work from the source the user supplied. Search the web only when the task needs evidence that page cannot give.

Outcome	Command	Credential
Full readable page markdown	`kagi extract`	`KAGI_API_KEY`
Summary of a URL or text	`kagi summarize`	session or legacy API token
Answer about one page	`kagi ask-page`	session token
Translation	`kagi translate`	session token

Extract a page

Use extract when downstream work needs the article body rather than a summary. Prefer extract over browser scraping for readable main content. It requires the current KAGI_API_KEY, never the legacy KAGI_API_TOKEN.

bash

kagi extract "https://example.com/article"

Show full SKILL.md (324 more words)Show less

Summarize

Prefer subscriber mode when a session token is available.

bash

kagi summarize --subscriber --url "https://example.com/article"
kagi summarize --subscriber --text "long text"
kagi summarize --subscriber \
  --url "https://example.com/article" \
  --summary-type keypoints

Use the public API mode only when the legacy API token is configured or the task needs its engine controls.

bash

kagi summarize --url "https://example.com/article"
kagi summarize --text "long text" --engine cecil

Never summarize content that must be quoted or checked precisely. Extract it and inspect the relevant passage instead.

Ask one page

Use ask-page for a focused question whose evidence should come from one URL.

bash

kagi ask-page \
  "https://example.com/article" \
  "what evidence supports the main claim?" \
  --format markdown

When the question needs outside evidence or comparison, search the web instead.

Translate

bash

kagi translate \
  --text "Bonjour tout le monde" \
  --target-language EN

Preserve code, URLs, product names, and other text that must stay untranslated. State the target language explicitly.

Shared rules

Run kagi auth status before treating a command as unavailable.
Choose the narrowest command that produces the requested outcome.
Use --format json for programmatic parsing.
Use --format toon for compact LLM context.
Use --format markdown for prose that a person will read.
Run kagi auth check when credentials exist but a request fails.
Never print credential values.

bash

kagi auth status
kagi auth check

Completion criteria

Web research is complete when:

the answer addresses the exact question;
important claims trace to source URLs;
source quality and recency match the claim;
disagreement and uncertainty appear in the output; and
the output uses the requested format and depth.

Page work is complete when:

the command matches the requested transformation;
the output stays grounded in the supplied URL or text;
quotes remain distinguishable from summaries;
the output keeps the requested language and format; and
you report a source-access failure instead of guessing past it.

Mail

Mail uses separate OAuth credentials and private connection settings. Run kagi mail login after configuring [mail].endpoint and [mail].client_id. Search API keys and session tokens do not grant mail access.

bash

kagi mail boxes
kagi mail search --mailbox Inbox --unread --limit 10
kagi mail search "contract renewal" --semantic --format toon
kagi mail read MESSAGE_ID --format pretty
kagi mail read --thread THREAD_ID --new-text-only

Use exact search for known words, senders, subjects, or dates. Add --semantic for a topic described in natural language. Use returned IDs to read messages. The MCP exposes no send, delete, mark-read, or attachment-download operation. Mail content stays out of the CLI's local history and response cache.

Files

Just SKILL.md in skills/kagi-usage of Microck/kagi-cli.

Open the folder on GitHubat commit 99ce2be

Compare with similar skills

Kagi Usage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kagi Usage compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Kagi Usage this skillMicrock/kagi-cli	178	—	~1.9k	Automated safety check: Pass	MIT	yesterday
WeChat Article Searchzjp1997720/wechat-article-search	268	1 repos	~730	Automated safety check: Notes	MIT	2 mo ago
Felo SearchFelo-Inc/felo-skills	248	—	~1.6k	Automated safety check: Pass	MIT	2 mo ago
Nimble Web SearchLeoYeAI/openclaw-master-skills	2.2k	—	~5.1k	Automated safety check: Pass	MIT	2 mo ago
DaydreamerLeoYeAI/openclaw-master-skills	2.2k	—	~4.4k	Automated safety check: Pass	MIT	2 mo ago
Aqua Evaluationoracle/accelerated-data-science	125	—	~1.6k	Automated safety check: Pass	UPL-1.0	1 mo ago

Similar skills

WeChat Article Search
zjp1997720/wechat-article-search
Searches WeChat public account articles by keyword through Sogou WeChat Search and returns titles, summaries, dates, source accounts and links.
268 GitHub starsUsed in 1 repo~730 tokens
Productivity & AutomationAuto-check: notes
Felo Search
Felo-Inc/felo-skills
Felo AI real-time web search for questions requiring current/live information.
248 GitHub stars~1.6k tokensUpdated 2 mo ago
Productivity & AutomationAuto-check passed
Nimble Web Search
LeoYeAI/openclaw-master-skills
Real-time web intelligence powered by Nimble Search API. An agent skill from LeoYeAI/openclaw-master-skills.
2.2k GitHub stars~5.1k tokensUpdated 2 mo ago
Productivity & AutomationAuto-check passed
Daydreamer
LeoYeAI/openclaw-master-skills
A skill your agent uses when the user says "daydream", "start daydreaming", "force a daydream", "run daydream cycles", or when a scheduled daydream is triggered.
2.2k GitHub stars~4.4k tokensUpdated 2 mo ago
Productivity & AutomationAuto-check passed
Aqua Evaluation
oracle/accelerated-data-science
Official
Evaluate LLM model quality using BERTScore, ROUGE, Perplexity, and Text Readability metrics on OCI AI Quick Actions (AQUA).
125 GitHub stars~1.6k tokensUpdated 1 mo ago
Writing & ContentAuto-check passed
Web Importer
wpsnote/wpsnote-skills
将网页内容高质量导入到 WPS 笔记，保留原文颜色、粗体、标题格式，图片按原文位置插入. An agent skill from wpsnote/wpsnote-skills.
179 GitHub stars~964 tokensUpdated 4 mo ago
Writing & ContentAuto-check passed

Questions about Kagi Usage

What does Kagi Usage do?

Search the web, extract or summarize a page, translate it, or check the news with the kagi CLI instead of WebSearch or WebFetch. Kagi Usage is an agent skill from Microck/kagi-cli. Search the web, extract or summarize a page, translate it, or check the news with the kagi CLI instead of WebSearch or WebFetch.

When should I use Kagi Usage?

Kagi Usage fits situations like: tasks that involve Web search.

How do I install Kagi Usage in Claude Code?

Run `npx skills add Microck/kagi-cli --skill kagi-usage -a claude-code`. Or copy the skill folder (skills/kagi-usage in Microck/kagi-cli) into .claude/skills/kagi-usage in your project. Claude Code loads it when a task matches its description.

How do I install Kagi Usage in Codex?

Run `npx skills add Microck/kagi-cli --skill kagi-usage -a codex`. Or copy the skill folder (skills/kagi-usage in Microck/kagi-cli) into .agents/skills/kagi-usage in your project. Codex loads it when a task matches its description.

Can I use Kagi Usage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Microck/kagi-cli --skill kagi-usage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kagi-usage, .gemini/skills/kagi-usage, .github/skills/kagi-usage and .opencode/skills/kagi-usage in your project.

What does Kagi Usage need to run?

Going by SKILL.md and its folder, Kagi Usage needs credentials named KAGI_API_KEY and KAGI_API_TOKEN. Our summary lists: A credential in KAGI_API_KEY; A credential in KAGI_API_TOKEN. Its frontmatter pre-approves these tools: Bash(kagi:*), Skill(kagi:*).

Does Kagi Usage access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kagi Usage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kagi Usage use?

Kagi Usage is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kagi Usage use?

About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kagi Usage?

Skills that share tags, products or a category with Kagi Usage: WeChat Article Search (zjp1997720/wechat-article-search, 268 stars), Felo Search (Felo-Inc/felo-skills, 248 stars), Nimble Web Search (LeoYeAI/openclaw-master-skills, 2.2k stars) and Daydreamer (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kagi Usage?

Microck (a GitHub user) maintains it in Microck/kagi-cli, which has 178 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 6, 2026.

Source: Microck/kagi-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Kagi Usage

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Kagi CLI

Route the task

Search the web

Search controls

Query design

News and discovery

Work with one page

Extract a page

Summarize

Ask one page

Translate

Shared rules

Completion criteria

Mail

Files

Compare with similar skills

Similar skills

More from Microck/kagi-cli

Related

Questions about Kagi Usage