# alibabacloud-starops-chat

alibabacloud-starops-chat queries Alibaba Cloud STAROps via OpenAPI to diagnose service failures, trace APM errors, and run root cause analysis directly from your AI coding assistant.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 145 installs · ★ 300 repo stars
- Author: aliyun
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aliyun/alibabacloud-aiops-skills/tree/HEAD/skills/middleware/starops/alibabacloud-starops-chat/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/alibabacloud-starops-chat

## What it does

This skill communicates with the Alibaba Cloud STAROps Agent to fetch streaming diagnostics for cloud workloads. It lets your assistant inspect workspace topologies, investigate error rates, and trace request latency without leaving the terminal.

Behind the scenes, the Python script `scripts/call_starops_agent.py` processes event streams. It requires dependencies from `scripts/requirements.txt` and must be invoked with the mandatory `--pipe` flag to output delimited text blocks and session identifiers. Related follow-up queries reuse the thread flag to preserve context.

The script aborts immediately if `employeeId`, `workspace`, or `uid` are missing from environment variables or `~/.starops/config.json`. Authentication relies on standard Alibaba Cloud credential chains rather than custom skill-specific tokens.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-starops-chat -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/alibabacloud-starops-chat/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/alibabacloud-starops-chat/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-starops-chat -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/alibabacloud-starops-chat/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-starops-chat -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/alibabacloud-starops-chat/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aliyun/alibabacloud-aiops-skills skills/middleware/starops/alibabacloud-starops-chat
```

2. **Manually: put the files in place**
- File: `.github/skills/alibabacloud-starops-chat/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-starops-chat -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aliyun/alibabacloud-aiops-skills --path skills/middleware/starops/alibabacloud-starops-chat
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/alibabacloud-starops-chat/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-starops-chat -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aliyun/alibabacloud-aiops-skills/tree/HEAD/skills/middleware/starops/alibabacloud-starops-chat/SKILL.md

## When to use it
- pinpoint the root cause of backend service failures
- inspect workspace service topologies and health metrics
- trace latency bottlenecks using APM telemetry
- investigate alerts within an ongoing incident thread

## Example prompts
- Run a STAROps root cause analysis on the top error services
- Check APM latency and trace exceptions for the billing service
- Investigate recent alert spikes using the active STAROps thread

## Similar
- [app-observability](https://affpapa.org/en/nevibecode/skills/app-observability.md) — skill · 4800 installs
- [cx-service-catalog](https://affpapa.org/en/nevibecode/skills/cx-service-catalog.md) — skill · 3700 installs
- [dd-apm](https://affpapa.org/en/nevibecode/skills/dd-apm.md) — skill · 2200 installs
- [observability-sre-triage](https://affpapa.org/en/nevibecode/skills/observability-sre-triage.md) — skill · 1500 installs
- [service-remapping](https://affpapa.org/en/nevibecode/skills/service-remapping.md) — skill · 563 installs
- [exploring-apm-traces](https://affpapa.org/en/nevibecode/skills/exploring-apm-traces.md) — skill · 387 installs

From the same set: [aliyun/alibabacloud-aiops-skills](https://affpapa.org/en/nevibecode/by/aliyun/alibabacloud-aiops-skills.md) — 66 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
