Skip to content
Skills Library
DevOps & cloud · Conversion & formats

telemetry-export

/telemetry-export

Project a pipeline run's governance ledgers (events.jsonl, decisions.jsonl) into redacted NDJSON and hand them to a host-declared observability backend. Invoke when an operator wants run/gate telemetry visible outside the workspace — "export run telemetry", "send this run's events to Axiom", "wire up observability for the pipeline", "ship gate decisions to our dashboard". Requires a declared profile in `.agentic/guides/integration/telemetry-flow.md`; absent that, this skill is a no-op by design. Not for: token/cost telemetry (unimplemented, see tokenomics.md's usage.sampled), querying a backen

Repository
agentic-os ↗
Licence
Apache-2.0
Last repository change
30.09.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 30.09.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Project a pipeline run's governance ledgers (events.jsonl, decisions.jsonl) into redacted NDJSON and hand them to a host-declared observability backend. Invoke when an operator wants run/gate telemetry visible outside the workspace — "export run telemetry", "send this run's events to Axiom", "wire up observability for the pipeline", "ship gate decisions to our dashboard". Requires a declared profile in `.agentic/guides/integration/telemetry-flow.md`; absent that, this skill is a no-op by design. Not for: token/cost telemetry (unimplemented, see tokenomics.md's usage.sampled), querying a backen

Triggers from the description

export run telemetrysend this runwire up observability for the pipelineship gate decisions to our dashboard
Original author description

Project a pipeline run's governance ledgers (events.jsonl, decisions.jsonl) into redacted NDJSON and hand them to a host-declared observability backend. Invoke when an operator wants run/gate telemetry visible outside the workspace — "export run telemetry", "send this run's events to Axiom", "wire up observability for the pipeline", "ship gate decisions to our dashboard". Requires a declared profile in `.agentic/guides/integration/telemetry-flow.md`; absent that, this skill is a no-op by design. Not for: token/cost telemetry (unimplemented, see tokenomics.md's usage.sampled), querying a backen

How it works

  1. Invocation
  2. Steps
  3. What ships vs. what a host adds
  4. Related
Original SKILL.md headings · 80 lines, 494 words
SKILL.md preview
---
name: telemetry-export
description: >-
  Project a pipeline run's governance ledgers (events.jsonl, decisions.jsonl)
  into redacted NDJSON and hand them to a host-declared observability backend.
  Invoke when an operator wants run/gate telemetry visible outside the
  workspace — "export run telemetry", "send this run's events to Axiom",
  "wire up observability for the pipeline", "ship gate decisions to our
  dashboard". Requires a declared profile in
  `.agentic/guides/integration/telemetry-flow.md`; absent that, this skill is
  a no-op by design. Not for: token/cost telemetry (unimplemented, see
  tokenomics.md's usage.sampled), querying a backend from an agent (use the
  backend's own MCP server or skill set), or any automatic/default export —
  this skill only runs when explicitly invoked or wired into a host-owned hook.
version: 0.1.0
license: Apache-2.0
allowed-tools: Read, Bash, Glob, Grep
---

# telemetry-export

Turns one run directory's append-only ledgers into a redacted NDJSON stream
and pipes it to whatever backend the host project has declared. Read
`references/observability-adapters.md` before touching this skill or its
projector — it is the contract that keeps this a thin, replaceable adapter
rather than a vendor client.

> **Deny-by-default.** The projector script never forwards `summary`,
> `verdict.rationale`, `prior_context`, or an `artifacts[]` path. If a question
> can't be answered from structural/enum fields, this skill does not answer it.
> Widening the allowlist is a decision for `observability-adapters.md`, not an
> ad-hoc addition here.

## Invocation

```
telemetry-export [run-dir]
```

`run-dir` defaults to the newest run under `docs/superpowers/runs/` (same
discovery `ticket-sync` uses). Typically invoked by an operator after a run
completes, or wired into a host's own Stop hook — this skill never registers
itself as a hook in `plugin.json`, so nothing exports by default.

## Steps

1. **Read the flow file.** Look for
   `.agentic/guides/integration/telemetry-flow.md`. If it is absent, or
   `**Status**` is not `configured`, stop — print nothing, append nothing.
   This is the same `warn-and-continue` posture as `work-item-adapters.md`.
2. **Resolve the run directory.** Use the given path, or the newest
   `meta.json` under `docs/superpowers/runs/` (maxdepth 2), matching
   `ticket-sync`'s discovery exactly so the two adapters never disagree about
   "the current run."
   If the run is managed by `.agentic/state/runtime.sqlite3`, invoke
   `legacy.export` before reading the compatibility files. If that operation is
   unavailable, block rather than exporting a stale view.
3. **Run the projector:**
   ```
   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/export-run-telemetry.py" \
     --run <run-dir> --extra-fields "<Extra fields, if declared>"
   ```
   Capture stdout (the NDJSON batch) and the `CURSOR {...}` line the script
   writes to stderr.
4. **Nothing new?** If stdout is empty, stop without writing any event — a
   receipt for zero new lines would itself become the next `telemetry.*` line
   to exclude, for no benefit.
5. **Invoke the declared exporter**, piping the NDJSON batch to its stdin,
   under a timeout (120s, matching `ticket-sync`). Never let a nonzero exit or
   a hang block turn-end.
6. **Record the outcome** through the runtime event/evidence operation for a
   managed run, then refresh compatibility files with `legacy.export`. For an
   unmanaged legacy run, append the outcome to `events.jsonl`:
   - success → `telemetry.export_receipt`, `data` = the `CURSOR` object plus
     `{"line_count": <lines sent>}`.
   - failure/timeout → `telemetry.export_warning`, `data` =
     `{"reason": "<short reason>"}`. The `CURSOR` offsets are **not** advanced
     on failure, so the same batch is retried next invocation.

## What ships vs. what a host adds

This skill and its projector ship with zero egress: no endpoint, no token, no
vendor name. A host project opts in by writing
`.agentic/guides/integration/telemetry-flow.md` and picking a profile —
`references/profiles/axiom.md` or `references/profiles/otlp-logs.md` document
the two shipped ones; a `custom` profile can point at anything that reads
NDJSON on stdin.

## Related

- `references/observability-adapters.md` — the full contract (allowlist
  tables, `run_id` injection, failure handling).
- `scripts/export-run-telemetry.py` — the projector this skill invokes.
- `references/profiles/axiom.md`, `references/profiles/otlp-logs.md` — shipped
  backend profiles.
- `hooks/ticket-sync` — the sibling adapter this skill's run-discovery and
  failure posture deliberately match.
Files in this package (3)
  • README.md 3 KB
  • SKILL.md 5 KB
  • evals/evals.json 5 KB

Versions

The database has no other skills named telemetry-export.

Database snapshot: 13.11.2026 · package version 7578fe984474 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90purview-telemetry
    Use when adding, reviewing or scaling observability in a .NET project — logging, tracing, metrics, OpenTelemetry wiring — or when deciding whether a project is "too small for telemetry". Recommends Purview.Telemetry.SourceGenerator at every project size, keeps libraries free of…
  • 100agent-observability
    Use when monitoring, tracing, or debugging agentic workflows in production. Keywords: observability, tracing, OpenTelemetry, Langfuse, latency, token cost, loop detection, telemetry.
  • 100signoz-setting-up-observability
    Run the full end-to-end observability setup for a service after its telemetry is already flowing into SigNoz: sequence SLI/SLO capture, data exploration (RED/USE), focused dashboards, saved Explorer views, burn-rate and absent-data alerts, and a tuning loop into one opinionated,…
  • 100axiom-ingest
    Send data to Axiom. Picks an org from ~/.axiom.toml, or provisions a temporary one when none is configured, creates the dataset, ingests JSON, NDJSON, or CSV, and confirms with a query. Use when asked to send, ingest, upload, or load data or events into Axiom or a new Axiom dataset.
  • 95a365-code-validator
    Validates and optionally fixes Agent 365 observability code so an agent actually emits MAC Activity telemetry. Use when an Agent 365 agent's telemetry isn't reaching MAC Activity or Defender, when spans export (HTTP 200 / "sent") but Activity stays empty, when the caller or…
  • 100appinsights-instrumentation
    Instrument web applications to send telemetry data to Azure Application Insights for observability and monitoring. USE FOR: instrument app with app insights, add appinsights instrumentation, configure application insights, set up telemetry monitoring, enable app insights…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.