# Crater CLI Admin Read

> Crater CLI Admin Read is an Agent Skill for apps & automation published in the raids-lab/crater repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Crater CLI 管理员只读域：指导 AI Agent 通过 crater admin ... 查看平台级只读信息。仅当用户明确要求管理员或平台级资源时使用。

- Skill name: `crater-cli-admin-read`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/raids-lab/crater/blob/HEAD/cli/skills/crater-cli-admin-read/SKILL.md
- Repository: raids-lab/crater (542 GitHub stars when collected)

## SKILL.md

# Crater CLI 管理员读取

**CRITICAL — 开始前 MUST 先读取 `crater-cli-shared`（可能路径：[`../crater-cli-shared/SKILL.md`](../crater-cli-shared/SKILL.md)），其中包含全局选项、非交互调用、错误处理和敏感信息规则。**

本 Skill 仅用于管理员视图。普通用户可见数据请使用 `crater-cli-read`，不要为了“多拿一点数据”擅自切换到 `crater admin ...`。

## 适用场景

- 用户明确要求查看管理员或平台级账户、资源、数据集、下载、审批单、用户、计费数据。
- 用户明确要求查看系统配置、队列配额、GPU 分析记录、操作日志、定时任务或白名单。
- 用户具备管理员权限，并希望以 `--json --no-interactive` 供脚本或 Agent 消费。

## 安全原则

- 本 Skill 只覆盖只读命令，不执行 update/delete/reconcile 等写操作。
- 管理员命令统一使用 `crater admin ...` 前缀；不要使用普通命令加 `--admin`。
- 如果 API 返回 403/401，向用户说明需要管理员权限或刷新登录态，不要尝试绕过权限。

## 常用范例

```bash
crater admin account ls --json
crater admin account get 1 --json
crater admin account members 1 --json
crater admin resource networks 1 --json
crater admin dataset ls --json
crater admin model-download ls --json
crater admin billing status --json
crater admin billing jobs --days 7 --json
crater admin order ls --json
crater admin user ls --json
crater admin user billing summary --json
crater admin system-config llm --json
crater admin operation-logs --page 1 --limit 20 --json
```

## 排查顺序

1. 先用 `crater auth ls --json` 确认 active credentials，并检查 role 是否具备管理员权限。
2. 需要机器解析时加 `--json --no-interactive`。
3. API 失败时根据 stderr JSON 的 `category`、`code`、`context.http_status` 判断是未登录、无权限、资源不存在还是服务端错误。

---

Source: https://www.openparable.com/skill/apps-automation/crater-cli-admin-read (OpenParable). Cite the canonical URL above.
