---
name: Observal Ops
slug: observal-ops
category: Data
description: Observal Ops inspects Observal traces, sessions, rankings, feedback, telemetry health, logs, and Agent insight reports. Use it when you need operational evidence, telemetry diagnosis, ratings, report generation, regression analysis, or recommendations grounded in Agent usage.
github: "https://github.com/Observal/Observal/tree/main/observal_cli/skills/observal-ops"
language: Python
stars: 2364
forks: 472
install: "npx degit https://github.com/Observal/Observal/tree/main/observal_cli/skills/observal-ops ~/.claude/skills/observal-ops"
installs_to: ~/.claude/skills/observal-ops
source_path: observal_cli/skills/observal-ops/SKILL.md
collection_size: 10
category_size: 668
collection_url: "https://dirskills.com/collections/Observal/Observal"
added: 2026-08-18T06:58:07.313Z
last_synced: 2026-08-18T06:58:07.313Z
canonical_url: "https://dirskills.com/skills/observal-ops"
---

# Observal Ops

Observal Ops inspects Observal traces, sessions, rankings, feedback, telemetry health, logs, and Agent insight reports. Use it when you need operational evidence, telemetry diagnosis, ratings, report generation, regression analysis, or recommendations grounded in Agent usage.

**Install:**

```bash
npx degit https://github.com/Observal/Observal/tree/main/observal_cli/skills/observal-ops ~/.claude/skills/observal-ops
```

## README

# Observing Observal

## Execution contract

1. Execute commands with a 60 second timeout. Use a longer timeout only for report generation or an intentional stream.
2. **Use machine output by default:** add `--output json` whenever supported. Parse list envelopes, finite objects, and JSON Lines separately.
3. Run `--help` before acting when a path or flag is uncertain.
4. Start with the narrowest read that answers the question. Do not generate a new report when a completed report already suffices.
5. Ground every conclusion in returned fields, report period, and sample size. Distinguish missing data from healthy data.
6. Verify rating mutations and report generation results.
7. Never repeat secrets or sensitive trace and log content unless the user explicitly requests the specific data and is authorized.
8. After an uncertain rating or report-generation failure, read current state before retrying.

## Choose the workflow

| User intent | Read |
| --- | --- |
| Sessions, traces, rankings, ratings, telemetry, or logs | [Operational workflows](references/operational-workflows.md) |
| Agent health, friction, costs, versions, regressions, or suggestions | [Insight reports](references/insight-reports.md) |

Read the selected reference completely before executing.

## Analysis rules

- A zero exit status from telemetry diagnosis can still contain issues or warnings. Read the JSON health fields.
- No events is not automatically a hook problem. Check authentication, server reachability, local outbox, and hook state in that order.
- Quote report evidence accurately and say when session count is thin.
- Only `component_ref` proves an insight suggestion maps to a Registry component. Never reconstruct a component identity from prose.
- Lead with reuse suggestions before create-new suggestions.
- For logs and traces, summarize the minimum sensitive content needed to answer the question.

## Completion

Report the time range, filters, counts, health state, strongest evidence, uncertainty, and concrete next action. Do not present popularity fallback or sparse reports as personalized certainty.