Agent skill

Cherry Studio Product Guide

by CherryHQ in CherryHQ/cherry-studio

Answers questions about Cherry Studio's features, routes, shortcuts and providers from the installed build's manifest, and diagnoses runtime problems.

AGPL-3.0Auto-check passedSales & Support

SKILL.md written in Chinese; this summary is our English description.

Install Cherry Studio Product Guide

skills CLI
$ npx skills add CherryHQ/cherry-studio --skill cherry-assistant-guide -a claude-code

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

GitHub CLI
$ gh skill install CherryHQ/cherry-studio cherry-assistant-guide --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/CherryHQ/cherry-studio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/resources/builtin-agents/cherry-assistant/.claude/skills/cherry-assistant-guide .claude/skills/cherry-assistant-guide && 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
cherry-assistant-guide
GitHub stars
52k
Token cost
~494 tokens
SKILL.md length
63 words
Files
2
Skills in repo
30
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Answers questions about Cherry Studio's features, routes, shortcuts and providers from the installed build's manifest, and diagnoses runtime problems.

  • Works in 5 steps: 只把返回清单中存在的内容表述为当前版本事实。 → routes.primary 是主导航入口;routes.all… → providers 表示随包支持的… → …
  • Asking what a Cherry Studio feature, shortcut or provider does in the current version
  • SKILL.md covers 原则, 当前安装包, 导航与诊断 and 信息优先级
  • Calls pnpm

What it does

The skill forbids answering Cherry Studio product questions from training data or memory. For each question the agent reads one section of the current installation's product manifest through the `mcp__assistant__product_info` tool, such as routes, commands (shortcuts) or providers, starting from a compact index when it is unsure which section applies. Only items present in the manifest may be stated as facts about the current version, and anything missing must be reported as not provided before the official docs are consulted.

Questions about where to find or configure a feature are answered by also calling `mcp__assistant__navigate` in the same turn, so you get a clickable entry point ahead of the manual steps, and the agent must not claim a page was opened. For errors, connection failures or odd configuration, `mcp__assistant__diagnose` looks at error summaries, logs, MCP status, provider connectivity or settings, with a permission prompt per call because that data comes from your device.

When your agent uses it

  • Asking what a Cherry Studio feature, shortcut or provider does in the current version
  • Finding where a setting lives in Cherry Studio
  • Diagnosing a Cherry Studio error, failed connection or configuration problem

Example prompts

  • “Which providers does my installed Cherry Studio support?”
  • “Where do I configure scheduled tasks in Cherry Studio?”
  • “Cherry Studio cannot connect to my provider, so run a diagnosis.”

Requirements

  • Cherry Studio's built-in assistant tools for product info, navigation and diagnosis

Workflow steps

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

  1. 只把返回清单中存在的内容表述为当前版本事实。
  2. routes.primary 是主导航入口;routes.all 还可能包含内部页、参数路由或兼容跳转,不能无条件推荐。
  3. providers 表示随包支持的 Provider;用户实际配置或启用状态应另用 mcpassistantdiagnose 的 Provider 诊断能力查询。
  4. 默认快捷键来自当前包定义,不代表用户没有自定义覆盖。
  5. 清单未暴露的能力必须明确说“当前包清单未提供该信息”,再按需查官方文档;不得补写旧版本经验。

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    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

Cherry Studio Product Guide loads about 494 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 63 words of instructions outside code blocks.

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

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 CherryHQ/cherry-studio at commit c97c23c, republished under its AGPL-3.0 licence (© CherryHQ). 63 words, ~494 tokens.

Download SKILL.mdSave it as .claude/skills/cherry-assistant-guide/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
cherry-assistant-guide
description
从当前安装包查询 Cherry Studio 产品信息并排查运行问题。当用户询问功能、路由、快捷键、Provider、语言、Agent、频道、定时任务、Code CLI、当前版本,或报告运行错误、连接失败、配置异常并需要诊断时触发。

Cherry Studio 产品信息查询

<!--
This file is GENERATED from skill-zh-cn-template.md by
scripts/generate-cherry-assistant-knowledge. Do not edit the output (SKILL.md)
directly; edit the template instead, then run `pnpm build:builtin-knowledge`.
-->

原则

不要凭训练数据、记忆或本文件中的旧描述回答 Cherry Studio 产品问题。每个独立的产品问题都先读取当前安装包信息。

当前安装包

按问题直接读取一个 section:

text
路由 / 页面入口:mcp__assistant__product_info({ source: "manifest", section: "routes" })
快捷键:mcp__assistant__product_info({ source: "manifest", section: "commands" })
Provider:mcp__assistant__product_info({ source: "manifest", section: "providers" })
语言:mcp__assistant__product_info({ source: "manifest", section: "locales" })
Agent / 频道 / 定时任务 / Code CLI:mcp__assistant__product_info({ source: "manifest", section: "agents" })

不知道该查哪个 section 时,先调用紧凑索引:

text
mcp__assistant__product_info({ source: "manifest" })

索引只返回当前版本和可用 section 名称;再读取相关 section。只有一个问题确实横跨多个 section 时才使用 section: "all",不要为省一次调用把整份清单放进上下文。

返回值来自随当前构建生成并打包的 product-manifest.json,不是手写版本知识。

回答时遵守以下规则:

  1. 只把返回清单中存在的内容表述为当前版本事实。
  2. routes.primary 是主导航入口;routes.all 还可能包含内部页、参数路由或兼容跳转,不能无条件推荐。
  3. providers 表示随包支持的 Provider;用户实际配置或启用状态应另用 mcp__assistant__diagnose 的 Provider 诊断能力查询。
  4. 默认快捷键来自当前包定义,不代表用户没有自定义覆盖。
  5. 清单未暴露的能力必须明确说“当前包清单未提供该信息”,再按需查官方文档;不得补写旧版本经验。

导航与诊断

凡是回答“去哪里找、打开、配置或使用某个 Cherry Studio 页面或功能”,都视为需要跳转;“我去哪里配置”“找不到入口”等含蓄问法也包括在内。先从当前包清单选择有效路径,必须在同一轮调用 mcp__assistant__navigate,并把生成的可点击入口放在手动操作步骤之前,不能等用户再次提醒。

只有导航工具成功后,才能告诉用户点击生成的入口。navigate 只生成等待用户点击的入口,不会自动打开页面;工具未调用或失败时,不得声称已经生成入口或已经打开页面。

用户报告运行错误时使用 mcp__assistant__diagnose。先看错误摘要,再按问题选择日志、MCP 状态、Provider 连通性或配置;这些数据来自用户设备,调用前保留逐次授权。

信息优先级

  1. 当前安装包清单:当前版本具备什么、入口在哪里、默认值是什么。
  2. Cherry Studio 官方文档:清单未覆盖的详细用法和版本变化。

发生冲突时,当前安装包清单优先于旧文档和模型记忆。清单不包含版本历史;无法从官方资料核实时,不得编造更新内容。

© CherryHQ, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in resources/builtin-agents/cherry-assistant/.claude/skills/cherry-assistant-guide of CherryHQ/cherry-studio.

  • SKILL.md
  • skill-zh-cn-template.md

Open the folder on GitHubat commit c97c23c

Compare with similar skills

Cherry Studio Product Guide 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.

Cherry Studio Product Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cherry Studio Product Guide this skillCherryHQ/cherry-studio52k—~494Automated safety check: PassAGPL-3.0
Support Ticket Triagezapier/gtm-cheat-codes342—~670Automated safety check: PassMIT
Experience Portal Createforcedotcom/sf-skills1.1k—~7.2kAutomated safety check: NotesApache-2.0
Setup Open IndexDrDroidLab/open-index112—~855Automated safety check: PassMIT
Miniprogram DevelopmentTencentCloudBase/CloudBase-AI-Toolkit1.1k1 repos~3.7kAutomated safety check: PassMIT
Triaging Warehouse Sync TicketsPostHog/posthog40k—~6.3kAutomated safety check: WarnCustom licence

Similar skills

  • Support Ticket Triage

    zapier/gtm-cheat-codes

    Official

    Triage support tickets by pulling helpdesk context, searching issue trackers and knowledge bases in parallel, classifying the issue, and giving reps a recommended next action.

    342 GitHub stars~670 tokensUpdated 2 mo ago
    Sales & SupportAuto-check passed
  • Experience Portal Create

    forcedotcom/sf-skills

    Create / provision / set up a NEW Digital Experience (Communities) / Experience Cloud site — employee service, IT support, help desk, HR, customer, and partner portals — via the headless-360 MCP…

    1.1k GitHub stars~7.2k tokensUpdated today
    Sales & SupportAuto-check: notes
  • Setup Open Index

    DrDroidLab/open-index

    Install and configure Open Index as the read/write context layer for a domain-specialized agent.

    112 GitHub stars~855 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Miniprogram Development

    TencentCloudBase/CloudBase-AI-Toolkit

    WeChat Mini Program development skill for building, debugging, previewing, testing, publishing, and optimizing mini program projects (小程序开发、调试、预览、发布).

    1.1k GitHub starsUsed in 1 repo~3.7k tokens
    Frontend & DesignAuto-check passed
  • Official

    Debug a customer's data warehouse source, schema, or table from a support ticket, using PostHog's own production data.

    40k GitHub stars~6.3k tokensUpdated today
    DatabasesAuto-check: warnings
  • Zsxq

    unnoo/zsxq-skill

    知识星球 CLI(zsxq-cli)与底层接口完整操作指南,涵盖星球和内容管理、Skill Pay 微信支付场景。当用户提到知识星球、zsxq、小密圈、星球、登录/认证、发帖、评论、回答、编辑、删除主题、定时发布/定时任务/定时回答、投票、问答主题、markdown 正文、AI…

    304 GitHub stars~3.8k tokensUpdated 17 days ago
    Sales & SupportAuto-check passed

More from CherryHQ/cherry-studio

All 30 skills in this repo
  • Office File Transform

    CherryHQ/cherry-studio

    Derives new files from a selected part of a spreadsheet, Word document, PDF or slide deck, such as a cell range, paragraph, page or slide, without ever modifying the source file.

    52k GitHub stars~4.7k tokensUpdated today
    Auto-check passed
  • GitHub Issue Creator

    CherryHQ/cherry-studio

    Creates GitHub issues for the current repository by choosing the matching issue template and following its format, with a permission check for engineering tasks.

    52k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Kimi Code Delegation

    CherryHQ/cherry-studio

    Delegates one bounded repository task to Kimi Code in non-interactive prompt mode and reads back the final result from its JSON event stream.

    52k GitHub starsUsed in 1 repo~504 tokens
    Auto-check passed
  • Cherry Studio PR Review

    CherryHQ/cherry-studio

    Reviews Cherry Studio branches, pull requests, commits, files and docs against the project's own architecture, naming, API-boundary and UI rules, report-only by default.

    52k GitHub stars~3.9k tokensUpdated today
    Auto-check passed
  • Cherry Studio Regression Tests

    CherryHQ/cherry-studio

    Runs Cherry Studio's critical-path regression suite as deterministic Playwright E2E tests through a GitHub workflow on macOS and Windows runners.

    52k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Antigravity CLI Runner

    CherryHQ/cherry-studio

    Runs the Antigravity CLI headlessly with the agy command to analyze a repository or carry out a coding task, then checks its JSON result and the diff.

    52k GitHub stars~531 tokensUpdated today
    Auto-check passed

Categories

Questions about Cherry Studio Product Guide

What does Cherry Studio Product Guide do?

Answers questions about Cherry Studio's features, routes, shortcuts and providers from the installed build's manifest, and diagnoses runtime problems. The skill forbids answering Cherry Studio product questions from training data or memory. For each question the agent reads one section of the current installation's product manifest through the `mcp__assistant__product_info` tool, such as routes, commands (shortcuts) or providers, starting from a compact index when it is unsure which section applies.

When should I use Cherry Studio Product Guide?

Cherry Studio Product Guide fits situations like: asking what a Cherry Studio feature, shortcut or provider does in the current version; finding where a setting lives in Cherry Studio; diagnosing a Cherry Studio error, failed connection or configuration problem.

How do I install Cherry Studio Product Guide in Claude Code?

Run `npx skills add CherryHQ/cherry-studio --skill cherry-assistant-guide -a claude-code`. Or copy the skill folder (resources/builtin-agents/cherry-assistant/.claude/skills/cherry-assistant-guide in CherryHQ/cherry-studio) into .claude/skills/cherry-assistant-guide in your project. Claude Code loads it when a task matches its description.

How do I install Cherry Studio Product Guide in Codex?

Run `npx skills add CherryHQ/cherry-studio --skill cherry-assistant-guide -a codex`. Or copy the skill folder (resources/builtin-agents/cherry-assistant/.claude/skills/cherry-assistant-guide in CherryHQ/cherry-studio) into .agents/skills/cherry-assistant-guide in your project. Codex loads it when a task matches its description.

Can I use Cherry Studio Product Guide 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 CherryHQ/cherry-studio --skill cherry-assistant-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cherry-assistant-guide, .gemini/skills/cherry-assistant-guide, .github/skills/cherry-assistant-guide and .opencode/skills/cherry-assistant-guide in your project.

What does Cherry Studio Product Guide need to run?

Going by SKILL.md and its folder, Cherry Studio Product Guide needs the command-line tools its instructions call (pnpm). Our summary lists: Cherry Studio's built-in assistant tools for product info, navigation and diagnosis.

Does Cherry Studio Product Guide 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 Cherry Studio Product Guide 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 Cherry Studio Product Guide use?

Cherry Studio Product Guide is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cherry Studio Product Guide use?

About 494 tokens (SKILL.md is roughly 2k 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 Cherry Studio Product Guide?

Skills that share tags, products or a category with Cherry Studio Product Guide: Support Ticket Triage (zapier/gtm-cheat-codes, 342 stars), Experience Portal Create (forcedotcom/sf-skills, 1.1k stars), Setup Open Index (DrDroidLab/open-index, 112 stars) and Miniprogram Development (TencentCloudBase/CloudBase-AI-Toolkit, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cherry Studio Product Guide?

CherryHQ (a GitHub organization) maintains it in CherryHQ/cherry-studio, which has 52,431 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 8, 2026.

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