O

oddyssey

using-system/oddyssey · v1.13.2 · Development & Workflow

by using-systemOwner verifiedcaution

Observability-Driven Development for coding agents: instrument an application or an AI agent with OpenTelemetry (gen_ai semantic conventions: model, agent, tool and MCP spans, token and latency metrics), observe a run through its metrics, traces, logs and profiles on a local Grafana stack or a remote backend, benchmark it with k6, and verify that a fix landed

InstallSourceFollow0

What is oddyssey?

oddyssey is a published development & workflow plugin for AI coding agents in the claude-code ecosystem, developed by using-system and distributed through the HOL AI plugin registry. Observability-Driven Development for coding agents: instrument an application or an AI agent with OpenTelemetry (gen_ai semantic conventions: model, agent, tool and MCP spans, token and latency metrics), observe a run through its metrics, traces, logs and profiles on a local Grafana stack or a remote backend, benchmark it with k6, and verify that a fix landed

Canonical slug
using-system/oddyssey
Version
v1.13.2 · updated Oct 15, 2026

Trust & Reputation

HOL Trust Score
59

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
64pts
Maintenance
25pts
MCP Posture
100pts
Plugin Security
59pts
Provenance
70pts
Publisher Quality
75pts

Registry Snapshot

Publisher verification
No
Marketplace source
Unknown
Scanner
Broker fallback
Safety label
caution
Digest verified
Yes
9 bundled skills — copy or download SKILL.mdOpen skills

Trust & reputation

Trust & Reputation

HOL Trust Score
59

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
64pts
Maintenance
25pts
MCP Posture
100pts
Plugin Security
59pts
Provenance
70pts
Publisher Quality
75pts

Provenance

Plugin root
marketplace/oddyssey
Source repo
https://github.com/using-system/oddyssey
Source commit
df33814643b7…
Publisher verified
No
Owner verified
@using-system

Continuous scanner CI not detected

This plugin remains listed. Its overall trust score is reduced by 10% because security checks are not maintained in the source repository's CI.

Optional: maintain the scanner in the source repository's CI to receive the full trust score. Listing does not require that change.

Verified badge not detected

Add the HOL verified badge to the repository README to score +2% trust. Plugin owners can open that pull request from Guard Plugins.

Security Posture

caution
Safety label
59
Security score
0
High findings
Provider
registry-broker-fallback
Grade
F · caution
Version
Unknown
cisco-skill-scanner: unknown

Findings

mediumpublishabilitypublishability.link.missing.websiteURL

websiteURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.privacyPolicyURL

privacyPolicyURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.termsOfServiceURL

termsOfServiceURL should be present for marketplace readiness.

lowoperational-securitysupply-chain.lockfile-missing

Repository snapshot does not include a lockfile.

infoskill-securityskill-scan.unavailable

Cisco skill scanner exited with code 1: Error loading skill: No SKILL.md and no .md files found in /tmp/hol-skill-safety-01SBXm (lenient mode requires at least one markdown file)

infoskill-securityskill-scan.unavailable

Cisco skill scanner exited with code 1: Error loading skill: No SKILL.md and no .md files found in /tmp/hol-skill-safety-ML3OWl (lenient mode requires at least one markdown file)

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner exited with code 1: Error loading skill: No SKILL.md and no .md files found in /tmp/hol-skill-safety-7aQfKH (lenient mode requires at least one markdown file)

infoskill-securityskill-scan.unavailable

Cisco skill scanner exited with code 1: Error loading skill: No SKILL.md and no .md files found in /tmp/hol-skill-safety-fgASut (lenient mode requires at least one markdown file)

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

oddyssey — Frequently asked questions

What is oddyssey?
oddyssey is an AI plugin in the HOL registry. Observability-Driven Development for coding agents: instrument an application or an AI agent with OpenTelemetry (gen_ai semantic conventions: model, agent, tool and MCP spans, token and latency metrics), observe a run through its metrics, traces, logs and profiles on a…
How do I install oddyssey?
Install oddyssey in your harness: Claude Code — /plugin marketplace add using-system/oddyssey; MCP — git clone https://github.com/using-system/oddyssey; Any agent — npx skills add using-system/oddyssey. Full step-by-step guidance is on the HOL plugin page.
How do I install oddyssey in Claude Code?
To install oddyssey in Claude Code, start with /plugin marketplace add using-system/oddyssey. The complete step-by-step install guide for Claude Code is on the HOL plugin page.
How do I install oddyssey in MCP?
To install oddyssey in MCP, start with git clone https://github.com/using-system/oddyssey. The complete step-by-step install guide for MCP is on the HOL plugin page.
Is oddyssey free?
Pricing for oddyssey is published on its HOL plugin page when the maker schedules a launch.
Who publishes oddyssey?
oddyssey is published by using-system and listed on HOL.
Is oddyssey available now?
oddyssey availability is listed on its HOL plugin page.

Install Guidance

Install in Claude Code

Install through the Claude Code plugin marketplace.

Claude Code plugin docs
  1. 1

    Add the marketplace

    Run this inside a Claude Code session. It registers the marketplace manifest shipped at the repository root. If the repository ships none, add the generated entry from the Advanced section below first.

    claude code
  2. 2

    Find the marketplace and plugin names

    The install id is <plugin-entry>@<marketplace-name>, and the marketplace name is declared inside the manifest — it can differ from the repository name. List registered marketplaces to read both names.

    shell
  3. 3

    Install the plugin

    Substitute the plugin entry name and the marketplace name shown by the previous step.

    claude code

Plugin Manifest

{
  "name": "oddyssey",
  "version": "1.13.2",
  "description": "CLI toolbox for Observability-Driven Development (ODD): coding agents observe local runs on an OpenTelemetry/Grafana stack - or remote ones on any OpenTelemetry backend - and feed the next spec-driven improvement loop.",
  "author": {
    "name": "using-system",
    "url": "https://github.com/using-system"
  },
  "license": "MIT",
  "homepage": "https://github.com/using-system/oddyssey#readme",
  "repository": "https://github.com/using-system/oddyssey",
  "keywords": [
    "claude-code",
    "claude-code-plugin",
    "claude-skills",
    "mcp",
    "ai-agents",
    "observability",
    "opentelemetry",
    "developer-tools"
  ],
  "displayName": "Oddyssey",
  "interface": {
    "displayName": "Oddyssey",
    "developerName": "using-system"
  },
  "skills": "./",
  "mcpServers": "./.registry/mcp.json",
  "holManifestOrigin": "repository",
  "registryIndexVersion": 5
}

Marketplace Source

Repo URL
https://github.com/using-system/oddyssey
Marketplace path
Unknown
Source path
marketplace/oddyssey
Install policy
Unspecified

Skills

9 SKILL.md files ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

Share
skills-cli
  • backend-configuration

    skills/backend-configuration/SKILL.md

    Own the configured observability backend, in two sections invoked by name. Check: display the configured stack and the instance the runs will hit, prove the CLI connected, guide the user when it is not, and hand the preflight over to the mission. Switch: verify the target backend's CLI is installed (offer a guided install when missing), persist the switch via odd_config_set, persist the per-stack stack_config values the missions will need, then run Check for the proof. Stack-agnostic - the stack list and everything about a given stack come from the observability-cli-guides skill. Use before dispatching an observe, verify or bench mission, when the configured stack must be confirmed or the CLI's connection proven, when the user needs guidance to set their CLI up, and when the user asks to change the configured backend or to persist targeting values. Never installs silently, never authenticates on the user's behalf, never stores or echoes a secret.

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • get-status

    skills/get-status/SKILL.md

    Render the state of the ODD loop from the repository's committed .odd/ history and git alone - one screen by default (the loop state per lineage with its burn-down and next action), the full tables on request (per-service loop state, findings ledger, trends, open telemetry gaps) - read-only, no backend queries, no report written. Use when answering where the loop is, when /odd-status runs, or when a status must be computed offline from the clone.

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • k6-guides

    skills/k6-guides/SKILL.md

    Curated map of the official k6 load-testing docs - installation, running a script, scripting (checks/thresholds/scenarios), test types, protocols, and which questions a benchmark's inputs require before it can be authored. Use when authoring or reasoning about a k6 benchmark - pick the topic, open its reference file, and follow the linked official docs. Read by /odd-instrument-bench (which questions to ask), k6-benchmark-expert (authoring and validating), a stored benchmark's replay (running one), and the /odd-instrument-bench, /odd-observe, and /odd-verify preflights (ensuring k6 is present).

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • observability-cli-guides

    skills/observability-cli-guides/SKILL.md

    The package's knowledge of every observability stack it supports, one reference file per stack - the terminal query surface (how to authenticate and query metrics, traces, logs, and profiles from the CLI), how the stack's configuration is displayed and proven, and what its stack_config persists - plus the list of built-in stacks. Use when observing a run, local or remote, and when backend-configuration's Check or Switch need anything about a stack - Grafana (gcx), Datadog (Pup CLI), Dynatrace (dtctl and DQL), Azure Monitor (az), AWS CloudWatch and X-Ray (aws), and the local stack.

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • odd-memory

    skills/odd-memory/SKILL.md

    The .odd/ memory - its contract and one reference per kind. The contract states what every kind shares (where the memory lives, the frontmatter and the whole body, append-only reports versus living-source benchmarks, recall by frontmatter then by section, the no-secrets rule, the work branch and the lone commit, the reply that carries a synthesis and never the artifact); each reference says how to persist, recall and show its kind - observation reports, instrumentation reports, benchmarks, the maintainer-ruling ledgers (finding decisions, tree-entry classifications), custom stacks. Read when a report, a benchmark, a custom stack or a decision is persisted, recalled, shown or inventoried, or when a finding is declined (wontfix) or such a decision reversed, or a tree entry is ruled runtime or non-runtime; never invoked on its own.

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • otel-guides

    skills/otel-guides/SKILL.md

    Curated map of the official OpenTelemetry documentation by language. Use when planning or implementing OpenTelemetry instrumentation for a codebase - pick the language, open its reference file, and follow the linked official docs for traces, metrics, logs, instrumentation libraries, exporters, and SDK configuration. Covers C++, .NET, Erlang/Elixir, Go, Java, JavaScript, Kotlin, PHP, Python, Ruby, Rust, Swift, and other community SDKs, plus the cross-language references for SDK configuration, semantic conventions, generative AI (the gen_ai conventions and the instrumentation library per LLM SDK or agent framework), the Collector, and profiling.

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • package-layout

    skills/package-layout/SKILL.md

    Where this package is installed and what each part of it is - every skill, its reference files, its scripts, and the sibling directories the install carries. Use when a mission block needs the skills' directory, when a contract must name a reference or a script by path, or when anything is about to look for the package on disk. The answer comes from the script's own location, so it is exact wherever a host installed the package, and nothing has to be searched for or written down in advance.

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • run-scenario

    skills/run-scenario/SKILL.md

    Drive a reproducible request scenario against a locally running service - ad-hoc requests, or a stored k6 benchmark from .odd/benchmarks/ - and record it verbatim, so the telemetry it produces can be compared with a later run. Use when traffic must be generated before observing a service, when a stored k6 benchmark must be run, when an observation report needs a replayable scenario, or when verifying after a fix that the same scenario now measures better.

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • setup-local-stack

    skills/setup-local-stack/SKILL.md

    Configure gcx against the local oddyssey Grafana stack and query its four signals (metrics, traces, logs, profiles) without touching the user's own gcx contexts. Owns the global configuration's "local" stack value. Use when the configured stack is "local", when querying the local stack (Grafana host port from the global configuration, default 3000), when configuring gcx locally, when a command needs the Tempo, Prometheus, Loki, or Pyroscope datasource UID. gcx is the mandatory query CLI for the stack - install it if missing (brew install gcx, or the official install script from github.com/grafana/gcx).

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

File Inventory

.claude-plugin/plugin.json

file

732 bytes

80afc7ced245a055…

.codex-plugin/plugin.json

plugin-manifest

814 bytes

8d1b6764e9db8c73…

.mcp.json

file

173 bytes

21759014a5b6302d…

.registry/mcp.json

mcp-config

127 bytes

d2b2aa8002b8fbc3…

agents/k6-benchmark-expert.agent.md

file

29,505 bytes

b8b79f9f98690b8b…

agents/observe-run.agent.md

file

56,571 bytes

c8043868ab3998ca…

agents/otel-instrumentation-expert.agent.md

file

15,522 bytes

e9d2c2882f0aa7b5…

agents/stack-instrumentation-expert.agent.md

file

16,106 bytes

53364c8d5bd17c60…

commands/odd-config.md

file

6,278 bytes

4d952106ad00ddd2…

commands/odd-instrument-bench.md

file

5,097 bytes

d69a054c09b12205…

commands/odd-instrument-otel.md

file

1,845 bytes

5cbe3b167e48d754…

commands/odd-instrument-stack.md

file

6,364 bytes

0d2824a8a56eadd2…

commands/odd-observe.md

file

8,198 bytes

47a4869dc22faeed…

commands/odd-status.md

file

3,718 bytes

6c7c5b8d975d3755…

commands/odd-verify.md

file

12,858 bytes

6cbd9a87c84deccf…

hooks/hooks.json

file

1,019 bytes

1b697c6afbec72a7…

hooks/scripts/check_report_frontmatter.py

file

18,871 bytes

006abe599feca6ac…

hooks/scripts/guard_append_only.py

file

22,116 bytes

a3baaaeb38691dd9…

hooks/scripts/guard_default_branch.py

file

26,530 bytes

ec5b5c0da0e19924…

hooks/scripts/scan_odd_identifiers.py

file

17,753 bytes

e3da61e42d6f026d…

plugin.json

file

778 bytes

20df32f1d1bf9733…

SECURITY.md

file

629 bytes

9433aa2076004740…

skills/backend-configuration/scripts/preflight.py

skill

13,270 bytes

f05da1edc27f3b2b…

skills/backend-configuration/SKILL.md

skill

23,876 bytes

21975519fbc0b49e…

skills/get-status/scripts/odd_render.py

skill

75,015 bytes

4e6d0ff42846e8a8…

skills/get-status/scripts/odd_status.py

skill

31,941 bytes

248e0af4605e1036…

skills/get-status/SKILL.md

skill

22,595 bytes

43dfbae06c58b7eb…

skills/k6-guides/references/authoring-inputs.md

skill

2,595 bytes

bca78ebb4a777198…

skills/k6-guides/references/browser.md

skill

524 bytes

bebe5451f013eda0…

skills/k6-guides/references/install.md

skill

6,088 bytes

bebd93510226367e…

skills/k6-guides/references/mcp.md

skill

14,491 bytes

b6262520ddf72418…

skills/k6-guides/references/protocols.md

skill

987 bytes

43c82d71b73b14f4…

skills/k6-guides/references/running-tests.md

skill

18,158 bytes

47a82d0f6460911a…

skills/k6-guides/references/scripting.md

skill

13,501 bytes

d3fb5985f12cfd79…

skills/k6-guides/references/test-types.md

skill

1,778 bytes

7b4f3a7bc2fcd9ec…

skills/k6-guides/scripts/replay_benchmark.py

skill

29,243 bytes

b618b7e71a5cf926…

skills/k6-guides/SKILL.md

skill

4,654 bytes

bd8c9c8f8699259b…

skills/observability-cli-guides/references/azure-monitor.md

skill

46,241 bytes

cbc3f54f95161ddd…

skills/observability-cli-guides/references/builtin-stacks.md

skill

1,924 bytes

f15ece6f6e3d19dd…

skills/observability-cli-guides/references/cloudwatch.md

skill

53,644 bytes

f92d20fef92cd7f2…

skills/observability-cli-guides/references/CONTRACT.md

skill

8,960 bytes

329c80313b31d992…

skills/observability-cli-guides/references/datadog.md

skill

15,903 bytes

055e4c0c15a40682…

skills/observability-cli-guides/references/dynatrace.md

skill

16,146 bytes

b68b91a556c6b630…

skills/observability-cli-guides/references/grafana.md

skill

44,304 bytes

6a9bde5d3b29a9bb…

skills/observability-cli-guides/references/local.md

skill

8,085 bytes

79c5301d30e37465…

skills/observability-cli-guides/scripts/azure_monitor_az.py

skill

16,482 bytes

b8a3b36dbbc0f6d8…

skills/observability-cli-guides/scripts/azure-monitor-context.py

skill

11,974 bytes

a747b3f7aa4a8b10…

skills/observability-cli-guides/scripts/azure-monitor-discover.py

skill

11,826 bytes

81f39720401bf497…

skills/observability-cli-guides/scripts/azure-monitor-logs.py

skill

14,064 bytes

4af47b878835da37…

skills/observability-cli-guides/scripts/azure-monitor-metrics.py

skill

21,351 bytes

c5d8c2d4910f8727…

skills/observability-cli-guides/scripts/azure-monitor-traces.py

skill

43,595 bytes

cdc1165d93b03e1e…

skills/observability-cli-guides/scripts/check_stack_reference.py

skill

20,673 bytes

ec220dd4e2f690b0…

skills/observability-cli-guides/scripts/cloudwatch_aws.py

skill

23,757 bytes

2896c933385fca91…

skills/observability-cli-guides/scripts/cloudwatch-context.py

skill

14,916 bytes

462d547cdac901d6…

skills/observability-cli-guides/scripts/cloudwatch-discover.py

skill

17,265 bytes

3cfd0fa8398fffb4…

skills/observability-cli-guides/scripts/cloudwatch-logs.py

skill

13,430 bytes

d70ff052ab4d9c3e…

skills/observability-cli-guides/scripts/cloudwatch-metrics.py

skill

26,705 bytes

ef5faee20015bca5…

skills/observability-cli-guides/scripts/cloudwatch-traces.py

skill

49,080 bytes

8369080f1059a3d0…

skills/observability-cli-guides/scripts/grafana_gcx.py

skill

21,144 bytes

fa4c5f543180167a…

skills/observability-cli-guides/scripts/grafana-context.py

skill

10,898 bytes

b5d7593e60fb4758…

skills/observability-cli-guides/scripts/grafana-discover.py

skill

8,126 bytes

735796cceddd35a7…

skills/observability-cli-guides/scripts/grafana-logs.py

skill

7,646 bytes

926c836b39c1340e…

skills/observability-cli-guides/scripts/grafana-metrics.py

skill

15,921 bytes

cfa55d8d38e52b90…

skills/observability-cli-guides/scripts/grafana-profiles.py

skill

8,539 bytes

cd5f87ab607165f3…

skills/observability-cli-guides/scripts/grafana-traces.py

skill

63,883 bytes

8097b0d59763adc2…

skills/observability-cli-guides/SKILL.md

skill

3,675 bytes

4090061abe948b3e…

skills/odd-memory/references/benchmark.md

skill

8,158 bytes

c89d7559fcee5cd9…

skills/odd-memory/references/decisions.md

skill

10,566 bytes

75719bccf2f59872…

skills/odd-memory/references/observability-stack.md

skill

10,744 bytes

b494406c8c2836dd…

skills/odd-memory/references/observe-run-report.md

skill

27,299 bytes

d00a8951d8507a72…

skills/odd-memory/references/otel-instrumentation-report.md

skill

18,991 bytes

1383ccd2362bf2f4…

skills/odd-memory/scripts/odd_ledger.py

skill

17,959 bytes

f507baada9dc4cb9…

skills/odd-memory/scripts/odd_recall.py

skill

17,661 bytes

8ccbfe89c59509ad…

skills/odd-memory/scripts/odd_report.py

skill

137,375 bytes

c469998d785d1a38…

skills/odd-memory/SKILL.md

skill

12,884 bytes

35218d192c1b8e65…

skills/otel-guides/references/collector.md

skill

7,994 bytes

83fb9d710ea125d2…

skills/otel-guides/references/cpp.md

skill

3,988 bytes

a95137ab63bda80f…

skills/otel-guides/references/dotnet.md

skill

7,146 bytes

c49e5e245cd56691…

skills/otel-guides/references/erlang.md

skill

5,091 bytes

4a17406085257dba…

skills/otel-guides/references/genai.md

skill

20,177 bytes

48b3713ed98f50ee…

skills/otel-guides/references/go.md

skill

5,039 bytes

7265fdb8ec0b3e7d…

skills/otel-guides/references/java.md

skill

6,819 bytes

1d1931cb29376d8b…

skills/otel-guides/references/js.md

skill

6,189 bytes

4bef85515d9562e4…

skills/otel-guides/references/kotlin.md

skill

3,747 bytes

7c4907d6e522df3d…

skills/otel-guides/references/other.md

skill

3,820 bytes

1a1b3b805aa9f70e…

skills/otel-guides/references/php.md

skill

5,518 bytes

2af620c6aba08298…

skills/otel-guides/references/profiling.md

skill

17,203 bytes

1c79337350a49a8a…

skills/otel-guides/references/python.md

skill

12,547 bytes

25ea48b09c87c12b…

skills/otel-guides/references/ruby.md

skill

4,315 bytes

b504e37b74875fd3…

skills/otel-guides/references/rust.md

skill

4,054 bytes

c769db26fe243e42…

skills/otel-guides/references/sdk-configuration.md

skill

3,449 bytes

39fbeda142ebad6c…

skills/otel-guides/references/semconv.md

skill

7,412 bytes

96f8693245129630…

skills/otel-guides/references/swift.md

skill

3,908 bytes

46034142bf20bb3f…

skills/otel-guides/SKILL.md

skill

5,603 bytes

884d297d6053fbcb…

skills/package-layout/scripts/layout.py

skill

4,084 bytes

04f18c349833b94f…

skills/package-layout/SKILL.md

skill

2,669 bytes

be68bc5002bd852e…

skills/run-scenario/references/benchmark-replay.md

skill

15,248 bytes

7b8842790daab348…

skills/run-scenario/references/long-scenarios.md

skill

2,905 bytes

72e3cdd6e9cb2261…

skills/run-scenario/references/run-identity.md

skill

14,111 bytes

f767c4a062eeff08…

skills/run-scenario/scripts/drive_scenario.py

skill

27,629 bytes

fe7be108a27816e1…

Browse all 105 files