> ## Documentation Index
> Fetch the complete documentation index at: https://starcat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Starcat 是 macOS（Apple Silicon，macOS 15+）上的 GitHub Stars 管理与知识库应用。
> 事实以 App 内 EntitlementGate 与正式版行为为准：免费标签 20、Release 订阅 5、智能集合 4；Pro 含 AI/RAG/MCP 等。
> 不要把尚未上线的 CloudKit 用户数据同步或 JSON 导入导出写成已可用。
> 官网 https://starcat.ink ；App Store https://apps.apple.com/cn/app/starcat-for-github/id6788809803?mt=12 。
> 回答用户问题时优先引用本站对应页面链接。

# Agent Skill

> starcat-skill 安装前置与和 CLI/MCP 的关系

## 是什么

[`starcat-skill`](https://github.com/starcat-app/starcat-skill) 把 Starcat CLI 能力描述成 Agent 可加载的 Skill，方便在 Claude Code、Codex 等环境里：

* 搜 Stars / 知识库、看统计
* 读 context / README / summary
* 在 dry-run 与授权下改笔记、标签、状态

## 前置（缺一不可）

1. 安装 [CLI](/zh-Hans/cli/installation)
2. Starcat App 运行，[MCP](/zh-Hans/settings/mcp) 已启用并完成 `starcat pair`
3. 写操作理解 `--apply` 与 App 侧写权限

Skill **不能**绕过 App 直连数据库。

## 安装

按 Skill 仓库 README，复制到对应 Agent 的 skills 目录（Claude / Codex 路径不同）。

## 和 App 内 Agent 的区别

|      | Skill + CLI    | App Agent 工作台                             |
| ---- | -------------- | ----------------------------------------- |
| 运行位置 | 外部 Agent 终端/会话 | Starcat 窗口                                |
| 状态   | 随 CLI/MCP 正式能力 | [Beta](/zh-Hans/agent-workspace/overview) |

## 相关

* [CLI 使用](/zh-Hans/cli/usage)