> ## 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 prerequisites and how it relates to CLI / MCP

## What it is

[`starcat-skill`](https://github.com/starcat-app/starcat-skill) describes Starcat CLI capabilities as an Agent-loadable Skill for Claude Code, Codex, and similar environments:

* Search Stars / knowledge base, view stats
* Read context / README / summary
* Change notes, tags, and status under dry-run and authorization

## Prerequisites (all required)

1. Install the [CLI](/cli/installation)
2. Starcat app running, [MCP](/settings/mcp) enabled, and `starcat pair` completed
3. Understand `--apply` and app-side write permissions for mutations

The Skill **cannot** bypass the app and talk to the database directly.

## Install

Follow the Skill repo README — copy into the skills directory for your Agent (Claude vs Codex paths differ).

## vs in-app Agent

|         | Skill + CLI                            | App Agent workspace               |
| ------- | -------------------------------------- | --------------------------------- |
| Runs in | External Agent terminal / session      | Starcat window                    |
| Status  | Tracks CLI / MCP shipping capabilities | [Beta](/agent-workspace/overview) |

## Related

* [CLI usage](/cli/usage)