Agent skill

Unicli Claude Code

by olo-dot-io in olo-dot-io/Uni-CLI

Make Uni-CLI reliable when invoked from Claude Code. An agent skill from olo-dot-io/Uni-CLI.

Apache-2.0Auto-check passedProductivity & Automation

Install Unicli Claude Code

skills CLI
$ npx skills add olo-dot-io/Uni-CLI --skill unicli-claude-code -a claude-code

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

GitHub CLI
$ gh skill install olo-dot-io/Uni-CLI unicli-claude-code --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/olo-dot-io/Uni-CLI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/unicli-claude-code .claude/skills/unicli-claude-code && 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/

Facts

Skill name
unicli-claude-code
GitHub stars
274
Token cost
~1.5k tokens
SKILL.md length
489 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

Make Uni-CLI reliable when invoked from Claude Code. An agent skill from olo-dot-io/Uni-CLI.

  • Works in 3 steps: stdin-JSON (preferred for complex… → args-file (preferred when payload is… → shell args (only for trivial payloads)
  • Productivity & Automation work in your project
  • SKILL.md covers Why this skill exists, The decision rule, The three channels and Runtime introspection — unicli…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Unicli Claude Code is an agent skill from olo-dot-io/Uni-CLI. Make Uni-CLI reliable when invoked from Claude Code. MANDATES JSON-in channels (stdin / --args-file) for any payload containing quotes, emoji, newlines, or inline JSON — shell-quoted invocations hit TC0 circuit limits and drop to <50% success above ICS=4. Also covers --describe introspection and nextactions-driven navigation.

Its SKILL.md is about 1.5k 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. It works with Model Context Protocol. The repository describes itself as: One command for every interface—search, run, and inspect real software across APIs, browsers, desktops, local tools, and MCP. The licence is Apache-2.0.

When your agent uses it

  • Productivity & Automation work in your project

Example prompts

  • “/unicli-claude-code”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. stdin-JSON (preferred for complex payloads)
  2. args-file (preferred when payload is reused)
  3. shell args (only for trivial payloads)

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    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 and json).

    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 no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Unicli Claude Code loads about 1.5k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 489 words of instructions outside code blocks.

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

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 olo-dot-io/Uni-CLI at commit 9316f93, republished under its Apache-2.0 licence (© olo-dot-io). 489 words, ~1,518 tokens.

Download SKILL.mdSave it as .claude/skills/unicli-claude-code/SKILL.md (or your agent's skills folder).
name
unicli-claude-code
description
Make Uni-CLI reliable when invoked from Claude Code. MANDATES JSON-in channels (stdin / --args-file) for any payload containing quotes, emoji, newlines, or inline JSON — shell-quoted invocations hit TC0 circuit limits and drop to <50% success above ICS=4. Also covers --describe introspection and next_actions-driven navigation.
version
1.2.1
depends-on
human-writing
triggers
unicli, ics, args-file, stdin-json, quoted payload, emoji in query

Uni-CLI × Claude Code — Reliable Invocation

TL;DR — If the payload contains ANY of: quotes, emoji, newlines, JSON, non-ASCII, or is longer than ~60 chars, PIPE IT. Never inline.

Why this skill exists

Transformers live in TC0. Matching balanced " and ' pairs with arbitrary nesting is a mod-2 state-tracking problem that TC0 cannot solve in constant decode depth. Empirically, top LLMs land <43% on 0→1 CLI generation (CLI-Tool-Bench arXiv:2604.06742) and 62% of agent-tool bugs cluster at the tool-invocation / execution stages (arXiv:2603.20847).

Uni-CLI gives you THREE invocation channels. One of them (shell-args) inherits the TC0 bottleneck. The other two do not.

The decision rule

If the payload has …Use channel
Only ASCII, no quotes, <60 charsshell OK
Any quote or backslashstdin-JSON
Emoji / CJK / non-ASCIIstdin-JSON
Newlines or inline JSONstdin-JSON
Being reused across multiple invocations--args-file

When unsure → stdin-JSON. It never makes things worse.

The three channels

1 — stdin-JSON (preferred for complex payloads)
bash
echo '{"query": "she said \"hi\" 🎉", "limit": 10}' | unicli twitter search
  • Uni-CLI auto-detects non-TTY stdin whose body starts with {
  • Precedence: stdin-JSON > --args-file > shell flags > defaults
  • Works for EVERY command — no per-adapter opt-in needed
2 — --args-file (preferred when payload is reused)
bash
cat > /tmp/q.json <<'EOF'
{ "query": "machine learning", "limit": 20, "locale": "en_US" }
EOF
unicli arxiv search --args-file /tmp/q.json
  • Absolute paths recommended
  • JSON only (YAML and TOML deliberately not supported — minimize format ambiguity)
3 — shell args (only for trivial payloads)
bash
unicli hackernews top --limit 5

Fine when every value is ASCII, no quotes, no emoji.

Runtime introspection — unicli describe

Before invoking any unfamiliar command, run:

bash
unicli describe <site> <command>

You get back a JSON object containing:

  • args_schema — JSON Schema draft-2020-12 for the argument bag
  • example_stdin — a realistic JSON body you can modify and pipe
  • channels — the three invocation templates
  • next_actions — hints for what to run next

This replaces reading docs. The CLI is the documentation.

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

The response envelope (v2)

Every successful call returns:

json
{
  "ok": true,
  "schema_version": "2",
  "command": "twitter.search",
  "meta": { "duration_ms": 847, "count": 10, "surface": "web" },
  "data": [ ... ],
  "error": null,
  "next_actions": [
    { "command": "unicli describe twitter search", "description": "…" },
    { "command": "unicli twitter search --args-file <path.json>", "description": "…" }
  ]
}

Errors return ok: false with a structured error object (adapter_path, step, suggestion) and failure-classified next_actions. unicli repair appears only for established adapter-drift classes and verifies an edit; it never edits automatically. If you see invalid_input from the hardening layer, the arg bag tripped a safety check — read error.suggestion for the exact fix.

--dry-run — preview before committing

bash
echo '{"query": "🎉", "limit": 5}' | unicli twitter search --dry-run

Prints the resolved ArgBag, the source channel, and the pipeline step count without touching the network / filesystem. Use this whenever you want to confirm the agent built the payload correctly.

Common failure modes → fixes

SymptomRoot causeFix
invalid_input: control charactersEmbedded 0x01..0x1F in a string argStrip control chars; use \t \n \r only
invalid_input: path escapes CWD../ or absolute path outside $HOMEKeep outputs inside cwd or $HOME/.unicli
invalid_input: id contains URL punctuationYou pasted a full URL as a resource idStrip the ?, #, or %XX sequences
Command appears to run but gets wrong argsShell ate your quotesSwitch to stdin-JSON
Unexpected shell expansion ($HOME, `)Bash interpolated your payloadSingle-quote, or better, use stdin-JSON

Recipes

Search with a complex query
bash
printf '%s\n' '{"query": "large language models \"emergent\" behaviour", "limit": 25}' \
  | unicli arxiv search
Multi-arg desktop command
bash
cat > /tmp/render.json <<'EOF'
{ "scene": "/Users/me/project/main.blend", "output_dir": "~/renders", "frame_start": 1, "frame_end": 240 }
EOF
unicli blender render --args-file /tmp/render.json
Debug-first workflow
bash
unicli describe youtube transcript         # 1. understand the contract
echo '{"url": "https://…"}' | unicli youtube transcript --dry-run   # 2. preview
echo '{"url": "https://…"}' | unicli youtube transcript             # 3. run

Version contract

  • v0.214.0+ required for stdin-JSON auto-detect, --describe, and consistent MCP tool discovery metadata
  • v0.213.1 or earlier agents should fall back to unicli schema <site> <cmd> and explicit -- flag args

© olo-dot-io, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/unicli-claude-code of olo-dot-io/Uni-CLI.

Open the folder on GitHubat commit 9316f93

Compare with similar skills

Unicli Claude Code 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.

Unicli Claude Code compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Unicli Claude Code this skillolo-dot-io/Uni-CLI274—~1.5kAutomated safety check: PassApache-2.0
N8n Docs Assistantn8n-io/n8n207k—~550Automated safety check: PassCustom licence
Planningn8n-io/n8n207k—~2.5kAutomated safety check: PassCustom licence
AgentRQ Workspace Agentagentrq/agentrq1.1k—~1.9kAutomated safety check: PassAGPL-3.0
Suggest Automationsn8n-io/n8n207k—~2kAutomated safety check: PassCustom licence
Webctlcosinusalpha/webctl419—~1.7kAutomated safety check: PassNone

Similar skills

  • Official

    Answers n8n product, setup, credential, node, hosting, API, and usage questions from current n8n docs.

    207k GitHub stars~550 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Planning

    n8n-io/n8n

    Official

    ONLY for coordinated multi-artifact work: multiple workflows with dependencies, shared data-table schema/migration across tasks, or the user explicitly asked to review a plan first.

    207k GitHub stars~2.5k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Guides a workspace agent through executing assigned tasks, replying to a remote human operator, and creating sub-tasks, memory and events inside an AgentRQ workspace.

    1.1k GitHub stars~1.9k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Official

    Offer the three most common automations for a user as a single-choice card, from your own knowledge of their team and their apps, then build the one they choose once they confirm, or offer more.

    207k GitHub stars~2k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Webctl

    cosinusalpha/webctl

    Browser automation via CLI. An agent skill from cosinusalpha/webctl.

    419 GitHub stars~1.7k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Huge AI Search

    wangwingzero/huge-ai-search

    Searches the live web through Google AI Mode via Huge AI Search (MCP or CLI).

    144 GitHub stars~563 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed

More from olo-dot-io/Uni-CLI

All 11 skills in this repo
  • Unicli

    olo-dot-io/Uni-CLI

    Comprehensive guide to Uni-CLI — the open Agent-Computer Interface runtime for real software.

    274 GitHub stars~3.8k tokensUpdated 4 days ago
    Auto-check: notes
  • Unicli Repair

    olo-dot-io/Uni-CLI

    Evidence-driven repair workflow for a broken Uni-CLI adapter.

    274 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check: notes
  • Unicli Explorer

    olo-dot-io/Uni-CLI

    Create new Uni-CLI adapters by exploring websites and APIs. An agent skill from olo-dot-io/Uni-CLI.

    274 GitHub stars~659 tokensUpdated 4 days ago
    Auto-check: notes
  • Human Writing

    olo-dot-io/Uni-CLI

    通用中文创作与改稿 Skill。用于知乎回答、论坛长帖、公众号文章、博客、评论、人物故事、历史叙事、新闻与行业解读、科普、教程、评测、个人叙事、小说、故事、对白、口播和演讲稿。默认写成一个见过事、查过材料、愿意把来龙去脉讲清楚的人在说话,重点保留中文互联网长回答与长帖的活人感和自然中文韵律,避免空泛的机构腔、喊口号式演说腔、营销腔和模型腔。非虚构长文先检查材料够不够,材料不足时研究、追问或缩短,…

    274 GitHub starsUsed in 2 repos~1.7k tokens
    Auto-check passed
  • Unicli Hermes

    olo-dot-io/Uni-CLI

    Use Uni-CLI to interact with the current website, desktop-app, and system-tool catalog.

    274 GitHub stars~653 tokensUpdated 4 days ago
    Auto-check passed
  • Unicli Smart Search

    olo-dot-io/Uni-CLI

    Route search queries to the best platform via unicli. An agent skill from olo-dot-io/Uni-CLI.

    274 GitHub stars~1.9k tokensUpdated 4 days ago
    Auto-check: notes

Questions about Unicli Claude Code

What does Unicli Claude Code do?

Make Uni-CLI reliable when invoked from Claude Code. An agent skill from olo-dot-io/Uni-CLI. Unicli Claude Code is an agent skill from olo-dot-io/Uni-CLI. Make Uni-CLI reliable when invoked from Claude Code.

When should I use Unicli Claude Code?

Unicli Claude Code fits situations like: productivity & Automation work in your project.

How do I install Unicli Claude Code in Claude Code?

Run `npx skills add olo-dot-io/Uni-CLI --skill unicli-claude-code -a claude-code`. Or copy the skill folder (skills/unicli-claude-code in olo-dot-io/Uni-CLI) into .claude/skills/unicli-claude-code in your project. Claude Code loads it when a task matches its description.

How do I install Unicli Claude Code in Codex?

Run `npx skills add olo-dot-io/Uni-CLI --skill unicli-claude-code -a codex`. Or copy the skill folder (skills/unicli-claude-code in olo-dot-io/Uni-CLI) into .agents/skills/unicli-claude-code in your project. Codex loads it when a task matches its description.

Can I use Unicli Claude Code 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 olo-dot-io/Uni-CLI --skill unicli-claude-code -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/unicli-claude-code, .gemini/skills/unicli-claude-code, .github/skills/unicli-claude-code and .opencode/skills/unicli-claude-code in your project.

What does Unicli Claude Code need to run?

SKILL.md names no scripts, command-line tools or credentials: Unicli Claude Code is instructions for the agent only.

Does Unicli Claude Code 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 Unicli Claude Code 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 Unicli Claude Code use?

Unicli Claude Code is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Unicli Claude Code use?

About 1.5k tokens (SKILL.md is roughly 6.1k 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 Unicli Claude Code?

Skills that share tags, products or a category with Unicli Claude Code: N8n Docs Assistant (n8n-io/n8n, 207k stars), Planning (n8n-io/n8n, 207k stars), AgentRQ Workspace Agent (agentrq/agentrq, 1.1k stars) and Suggest Automations (n8n-io/n8n, 207k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unicli Claude Code?

olo-dot-io (a GitHub organization) maintains it in olo-dot-io/Uni-CLI, which has 274 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 4, 2026.

Source: olo-dot-io/Uni-CLI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.