Agent skill

DeepChat CLI

by ThinkInAIXYZ in ThinkInAIXYZ/deepchat

Lets an agent drive DeepChat's bundled CLI for model calls, media generation, transcription, OCR, artifacts, configuration, Skills and MCP operations, within strict command rules.

Apache-2.0Auto-check passedAI & LLM Engineering

Install DeepChat CLI

skills CLI
$ npx skills add ThinkInAIXYZ/deepchat --skill deepchat-cli -a claude-code

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

GitHub CLI
$ gh skill install ThinkInAIXYZ/deepchat deepchat-cli --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/ThinkInAIXYZ/deepchat.git skills-src && mkdir -p .claude/skills && cp -r skills-src/resources/skills/deepchat-cli .claude/skills/deepchat-cli && 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
deepchat-cli
GitHub stars
6.4k
Used in
1 other repo
Token cost
~1.5k tokens
SKILL.md length
579 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
Apache-2.0

At a glance

Lets an agent drive DeepChat's bundled CLI for model calls, media generation, transcription, OCR, artifacts, configuration, Skills and MCP operations, within strict command rules.

  • Calling a DeepChat model, image, video or speech capability that has no dedicated tool
  • SKILL.md covers Command rules, Agent file and recursion…, Discovery and model calls and Media, transcription, and OCR, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Comparing models or running a benchmark through DeepChat

What it does

The skill covers the `deepchat` command, which asks the running DeepChat main process to carry out supported operations; the main process stays the only owner of providers, credentials, Skills, MCP servers, artifacts, agent runs and approvals. Uses include model inference and comparison, benchmarks, image, video and speech generation, transcription, OCR, inspecting artifacts and runtime state, reading public configuration and managing Skills and MCP servers.

Command rules are strict. Each call starts with `deepchat` followed by a domain and verb, runs as one standalone command with no pipes, redirection or shell wrappers, and quotes user text. `--json` is preferred for one result and `--jsonl` for streaming. Agents may use artifacts by ID and describe them, but may not upload or download artifact bytes, choose output paths, or start or wait on agent runs, since that could recurse or deadlock. They discover provider and model IDs with `system` commands instead of guessing, never inspect authentication variables, and wait for any approval prompt.

When your agent uses it

  • Calling a DeepChat model, image, video or speech capability that has no dedicated tool
  • Comparing models or running a benchmark through DeepChat
  • Inspecting DeepChat status, capabilities or artifacts
  • Managing DeepChat Skills or MCP servers from the command line

Example prompts

  • “Run the DeepChat system doctor and tell me what is misconfigured.”
  • “Compare two of my DeepChat models on the same prompt and give me the results as JSON.”
  • “Describe the DeepChat artifact I just generated.”

Requirements

  • DeepChat running, with its bundled deepchat command available

What it can do on your machine

Read from SKILL.md and the folder at commit f873e78. 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.

    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

DeepChat CLI loads about 1.5k tokens when it runs. Until then it costs about 102 tokens; SKILL.md has 579 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~102
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 ThinkInAIXYZ/deepchat at commit f873e78, republished under its Apache-2.0 licence (© ThinkInAIXYZ). 579 words, ~1,462 tokens.

Download SKILL.mdSave it as .claude/skills/deepchat-cli/SKILL.md (or your agent's skills folder).
name
deepchat-cli
description
Use DeepChat's bundled CLI control plane for model inference, image/video/speech generation, transcription, OCR, artifact inspection, public configuration, Skills, and MCP operations. Activate when a user asks to invoke DeepChat capabilities that are not already exposed as a more specific tool, compare models, run a benchmark, inspect DeepChat runtime state, or manage DeepChat through the CLI.

DeepChat CLI

Use the bundled deepchat command to ask the running DeepChat main process to perform supported operations. The main process remains the sole owner of providers, credentials, Skills, MCP servers, artifacts, Agent runs, and approvals.

Command rules

  • Every command must begin exactly with deepchat <domain> <verb>. Put --json, --jsonl, --timeout, and all domain options after the domain and verb.
  • Execute one standalone command per exec call. Do not use pipes, redirection, command separators, command substitution, environment assignments, or shell wrappers around deepchat.
  • Quote every user-controlled argument for the current shell. Never interpolate untrusted text into an unquoted command.
  • Prefer --json for one result and --jsonl for streaming or benchmark collection. Use text mode only when its output will be returned directly to the user.
  • Do not inspect authentication environment variables or DeepChat's local descriptor. Authorization is injected only after the command has passed the normal shell permission check.
  • A shell approval authorizes command execution. Sensitive mutations can additionally pause for a renderer approval; wait for that decision and never attempt to manufacture confirmation data.
  • Use deepchat help or deepchat <domain> <verb> --help only when the options below are insufficient. Do not probe undocumented routes.

Agent file and recursion boundaries

  • Agent callers may consume a DeepChat-owned artifact with --artifact <id> and inspect metadata with artifact describe.
  • Do not use --file, --out, --overwrite, artifact get, or artifact delete. Agent callers cannot upload arbitrary local bytes, download artifact bytes, or choose output paths.
  • Do not call agent run or run watch. An Agent cannot recursively create a detached Agent run, and waiting on its own currently executing run would deadlock it. Use run get for a nonblocking snapshot or run cancel to request cancellation.
  • Generated media remains in DeepChat's artifact spool. Return the artifact metadata or ID so the application can render or reuse it.

Discovery and model calls

text
deepchat system status --json
deepchat system capabilities --json
deepchat system doctor --json
deepchat provider list --enabled-only --json
deepchat model list --provider <provider-id> --json
deepchat model config-get --provider <provider-id> --model <model-id> --json
deepchat model invoke --provider <provider-id> --model <model-id> --prompt <quoted-text> --jsonl

Always discover provider and model IDs rather than guessing them. model invoke is a raw provider call: it does not create a chat session, run tools, or start an Agent loop.

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

Media, transcription, and OCR

text
deepchat image generate --provider <provider-id> --model <model-id> --prompt <quoted-text> --jsonl
deepchat video generate --provider <provider-id> --model <model-id> --prompt <quoted-text> --jsonl
deepchat audio speak --provider <provider-id> --model <model-id> --text <quoted-text> --jsonl
deepchat audio transcribe --provider <provider-id> --model <model-id> --artifact <artifact-id> --json
deepchat ocr status --json
deepchat ocr extract --artifact <artifact-id> --json
deepchat artifact describe --id <artifact-id> --json

Use the provider/model lists to choose a compatible runtime. OCR is local and does not require a provider. OCR text is returned inline and is not written to the artifact spool.

Public configuration and management

Read-only operations:

text
deepchat settings get --json
deepchat skill list --json
deepchat mcp list --json

Agent callers may request renderer approval for preference-only settings, query-free HTTPS Skill installation, and adding a new disabled HTTPS remote MCP configuration. Only perform one when it directly satisfies the user's request:

text
deepchat settings set --key <public-key> --value <json-scalar> --json
deepchat skill install --url <https-url> --json
deepchat mcp add --name <server-name> --stdin --json

The Agent setting allowlist is limited to presentation preferences such as font size/family, artifact effects, auto-scroll, notifications, and copy-with-reasoning. Agent Skill URLs cannot carry credentials, query parameters, or fragments. The main process classifies MCP input before approval and rejects stdio commands, non-HTTPS endpoints, headers, authorization bindings, or configurations too large to review safely. Provider/model configuration, credential writes, local Skill archives, Skill enable/disable/removal, MCP update/runtime control/removal, and every destructive operation require the DeepChat UI or a human terminal.

Benchmark discipline

  • Pin provider/model IDs and pass per-invocation options; do not mutate global defaults to prepare a benchmark.
  • Record structured output, exit status, wall time, and errors. Preserve failed samples.
  • For OCR, distinguish cache hit, cache miss with warm runtime, cold runtime after app restart, and offline availability. ocr clear-cache initializes the resource graph but does not start the OCR helper, so classify the next extraction from its reported pre-extraction runtime state.
  • Run samples sequentially unless the benchmark explicitly measures concurrency; Agent compute is rate-limited and bounded by the main process.

© ThinkInAIXYZ, 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 resources/skills/deepchat-cli of ThinkInAIXYZ/deepchat.

Open the folder on GitHubat commit f873e78

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in ThinkInAIXYZ/deepchat, which our catalogue first saw on October 7, 2026.

Compare with similar skills

DeepChat CLI 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.

DeepChat CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
DeepChat CLI this skillThinkInAIXYZ/deepchat6.4k1 repos~1.5kAutomated safety check: PassApache-2.0
Aliyun Model Studio CLImodelstudioai/cli542—~4.2kAutomated safety check: PassApache-2.0
Openmaopenma-ai/open-managed-agents315—~854Automated safety check: PassApache-2.0
Openai Knowledgeopenai/openai-agents-python30k1 repos~408Automated safety check: PassMIT
Ollama MCP Tool for NanoClawnanocoai/nanoclaw31k1 repos~3kAutomated safety check: NotesMIT
Copilot SDKgithub/awesome-copilot40k5 repos~6.3kAutomated safety check: PassMIT

Similar skills

  • Aliyun Model Studio CLI

    modelstudioai/cli

    Hub for the bl CLI of Alibaba Cloud Model Studio (Bailian): app calls, knowledge bases, model catalog, usage and quota, workspaces, MCP market, auth and skill installs.

    542 GitHub stars~4.2k tokensUpdated 8 days ago
    AI & LLM EngineeringAuto-check passed
  • Openma

    openma-ai/open-managed-agents

    Use the openma platform to build, deploy, and manage AI agents.

    315 GitHub stars~854 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Openai Knowledge

    openai/openai-agents-python

    Official

    Retrieve authoritative OpenAI API and platform documentation when an integration or claim needs current external evidence.

    30k GitHub starsUsed in 1 repo~408 tokens
    AI & LLM EngineeringAuto-check passed
  • Adds an MCP server so the NanoClaw container agent can send prompts to local Ollama models, with optional tools to manage the model library.

    31k GitHub starsUsed in 1 repo~3k tokens
    AI & LLM EngineeringAuto-check: notes
  • Copilot SDK

    github/awesome-copilot

    Official

    Build agentic applications with GitHub Copilot SDK. An agent skill from github/awesome-copilot.

    40k GitHub starsUsed in 5 repos~6.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Installs Codex as an agent provider for NanoClaw groups, with streaming, MCP tools, server-side history and vault-only credentials, next to or instead of Claude.

    31k GitHub stars~2.3k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check: notes

More from ThinkInAIXYZ/deepchat

All 15 skills in this repo
  • DeepChat Provider Integration

    ThinkInAIXYZ/deepchat

    Guides adding an LLM provider to DeepChat through explicit source changes: collect the provider details, pick a transport path and add registry entries and tests.

    6.4k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • DeepChat Release Process

    ThinkInAIXYZ/deepchat

    Runs the DeepChat repository's release flow: prepares bilingual release notes and a version bump on dev, cuts or updates a release branch, then fast-forwards main and tags the version.

    6.4k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • DeepChat Settings

    ThinkInAIXYZ/deepchat

    Changes DeepChat's own application settings, such as theme, language, font size and sound, through a fixed set of settings tools, and points to the right screen for anything else.

    6.4k GitHub stars~786 tokensUpdated today
    Auto-check passed
  • DeepChat Data Import Helper

    ThinkInAIXYZ/deepchat

    Guides building a third-party importer for DeepChat's local SQLite data, covering schema, encryption and safe read-only access patterns.

    6.4k GitHub stars~738 tokensUpdated today
    Auto-check passed
  • DeepChat Desktop Control

    ThinkInAIXYZ/deepchat

    Operates native desktop apps through DeepChat's built-in Computer Use tools, following a snapshot-then-act loop with session setup, app launch and window inspection.

    6.4k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • AntV Infographic Syntax Creator

    ThinkInAIXYZ/deepchat

    Turns user content into AntV Infographic syntax, choosing a matching template and structuring the data into a single infographic code block.

    6.4k GitHub stars~278 tokensUpdated today
    Auto-check passed

Questions about DeepChat CLI

What does DeepChat CLI do?

Lets an agent drive DeepChat's bundled CLI for model calls, media generation, transcription, OCR, artifacts, configuration, Skills and MCP operations, within strict command rules. The skill covers the `deepchat` command, which asks the running DeepChat main process to carry out supported operations; the main process stays the only owner of providers, credentials, Skills, MCP servers, artifacts, agent runs and approvals. Uses include model inference and comparison, benchmarks, image, video and speech generation, transcription, OCR, inspecting artifacts and runtime state, reading public configuration and managing Skills and MCP servers.

When should I use DeepChat CLI?

DeepChat CLI fits situations like: calling a DeepChat model, image, video or speech capability that has no dedicated tool; comparing models or running a benchmark through DeepChat; inspecting DeepChat status, capabilities or artifacts; managing DeepChat Skills or MCP servers from the command line.

How do I install DeepChat CLI in Claude Code?

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

How do I install DeepChat CLI in Codex?

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

Can I use DeepChat CLI 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 ThinkInAIXYZ/deepchat --skill deepchat-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deepchat-cli, .gemini/skills/deepchat-cli, .github/skills/deepchat-cli and .opencode/skills/deepchat-cli in your project.

What does DeepChat CLI need to run?

SKILL.md names no scripts, command-line tools or credentials: DeepChat CLI is instructions for the agent only. Our summary lists: DeepChat running, with its bundled deepchat command available.

Does DeepChat CLI 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 DeepChat CLI 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 DeepChat CLI use?

DeepChat CLI 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 DeepChat CLI use?

About 1.5k tokens (SKILL.md is roughly 5.8k 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 DeepChat CLI?

Skills that share tags, products or a category with DeepChat CLI: Aliyun Model Studio CLI (modelstudioai/cli, 542 stars), Openma (openma-ai/open-managed-agents, 315 stars), Openai Knowledge (openai/openai-agents-python, 30k stars) and Ollama MCP Tool for NanoClaw (nanocoai/nanoclaw, 31k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains DeepChat CLI?

ThinkInAIXYZ (a GitHub organization) maintains it in ThinkInAIXYZ/deepchat, which has 6,359 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 8, 2026.

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