← ClaudeAtlas

create-otel-instrumentation-reportlisted

Persist an OpenTelemetry instrumentation investigation report into the investigated repository at .odd/otel-instrumentation-reports/ with a structured frontmatter, commit it, and recall previous investigations of the same project - the file contract that keeps instrumentation expertise feeding later SDD waves. Use when storing the report an instrumentation investigation produced, or when loading past investigations before a new one.
using-system/oddyssey · ★ 6 · Data & Documents · score 71
Install: claude install-skill using-system/oddyssey
# Create an OTel Instrumentation Report An instrumentation investigation that vanishes with the conversation must be redone from scratch the next time the stack changes. This skill defines the file contract that persists it: reports live **in the investigated repository**, so git versions them, PRs review them, and every user of the repo shares them — the next SDD instrumentation wave starts from what the last investigation already established. ## Where reports live ```text <investigated-repo-root>/.odd/otel-instrumentation-reports/YYYY-MM-DD-HHmm-<run_name>.md ``` - `YYYY-MM-DD-HHmm` is the investigation's **UTC** start time — to the minute so two same-day runs never collide, and a plain directory listing sorts chronologically. Compute it, and the `date:` field, with `date -u`, never from the local clock: a session that crosses local midnight while UTC has not names the wrong day. - `<run_name>` is a short kebab-case slug naming what was investigated (e.g. `mcp-server-python`, `checkout-monorepo-full`). Name the content, not the date. - Create the directory if it does not exist. The files are meant to be **committed**: leave them tracked, never add them to `.gitignore`. ## The file format A YAML frontmatter, then the complete report: ```markdown --- project: oddyssey/src/mcp-server stack: local # local | the remote backend name (grafana, datadog, ...) run_name: mcp-server-python date: 2026-08-23 revision: 2299d4c # optional: