websiteURL should be present for marketplace readiness.
oddyssey
using-system/oddyssey · v1.13.2 · Development & Workflow
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
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
- Open data
- entity.json (JSON-LD)
Trust & Reputation
Factor Analysis
Per-metric points (0–100 each) combined via a weighted average into the overall score.
Registry Snapshot
- Repository
- https://github.com/using-system/oddyssey
- Canonical profile
- https://hol.org/registry/plugins/using-system%2Foddyssey
- Publisher verification
- No
- Marketplace source
- Unknown
- Scanner
- Broker fallback
- Safety label
- caution
- Digest verified
- Yes
Trust & reputation
Trust & Reputation
Factor Analysis
Per-metric points (0–100 each) combined via a weighted average into the overall score.
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
- Provider
- registry-broker-fallback
- Grade
- F · caution
- Version
- Unknown
Findings
privacyPolicyURL should be present for marketplace readiness.
termsOfServiceURL should be present for marketplace readiness.
Repository snapshot does not include a lockfile.
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)
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)
Cisco skill scanner timed out after 60000 ms
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)
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)
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
Cisco skill scanner timed out after 60000 ms
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.
- 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
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
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.
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…
