← Back to Skills Marketplace
Trace Debugger Safety
by
gakkiismywife
· GitHub ↗
· v1.0.0
· MIT-0
95
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install trace-debugger-safety
Description
Safer end-to-end trace debugging from trace_id using Jaeger and Elasticsearch with guarded Codex analysis. Use when a user wants a trace report similar to tr...
Usage Guidance
This skill is mostly coherent for trace debugging, but exercise caution before installing or running it:
- Inspect how run_codex_analysis is implemented (the script references a 'Codex' analysis path). Confirm whether it calls an external CLI or LLM API and whether that requires API keys (e.g., OPENAI_API_KEY or a custom token). The skill declares no required env vars, so missing credential documentation is a gap.
- Prefer running with --no-codex when analyzing logs from untrusted sources to avoid prompt-injection risks (the SKILL.md already advises this).
- Only pass an absolute repo_path you trust; the script will read many source files and may include file paths in the report.
- If you need to run this in production, run it against local/test Jaeger/ES endpoints first (defaults are localhost). Verify network requests made by the script (which endpoints are contacted) and confirm there are no hardcoded remote endpoints.
- If you are not comfortable auditing the full run_codex_analysis code path or any subprocess calls the script makes, consider not enabling Codex analysis or running the script in a restricted environment (container, limited filesystem access) to reduce risk.
Capability Assessment
Purpose & Capability
Name/description (trace debugging using Jaeger + Elasticsearch, optional code context) aligns with the script: it queries Jaeger/ES endpoints, normalizes spans/logs, and performs optional repository analysis. Requesting repo_path and jaeger/es URLs is coherent with the stated purpose.
Instruction Scope
SKILL.md instructs running the included Python script, providing trace_id and optional jaeger/es URLs and repo path. The instructions explicitly allow reading a local repo (if provided) and require writing and then deleting a Markdown report — those are within scope. The skill also instructs sending the generated report as a file attachment with a specific message format; that is an agent-level behavior but consistent with the skill. One scope concern: the SKILL.md and code emphasize an optional 'Codex' analysis path; the docs warn about prompt-injection risk, but they do not explain what 'Codex' binary/service is or what credentials it needs.
Install Mechanism
No install spec — instruction-only with an included Python script. There are no downloads or package installs, so nothing extra is written to disk by an installer. Running the script will execute code bundled with the skill (normal for instruction-plus-script skills).
Credentials
The skill declares no environment variables or credentials, but the code imports subprocess and includes a run_codex_analysis flow (truncated in the provided snippet) that likely invokes an external 'Codex' analysis step. If Codex requires API keys (e.g., OpenAI/OpenAI CLI, other LLM service), those credentials are not declared in requires.env or documented, creating a mismatch. Additionally, the script reads arbitrary files under a provided absolute repo_path, which is expected for code-context features but is privileged file access — users should only supply trusted repo paths.
Persistence & Privilege
The skill is not always-included and does not request persistent system privileges. It runs only when invoked and does not appear to modify other skills or system-wide agent settings. Writing a temporary Markdown report and deleting it afterward is normal and explicitly documented.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install trace-debugger-safety - After installation, invoke the skill by name or use
/trace-debugger-safety - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: safer trace debugger with optional Codex, sanitized logs, and no hardcoded repo path.
Metadata
Frequently Asked Questions
What is Trace Debugger Safety?
Safer end-to-end trace debugging from trace_id using Jaeger and Elasticsearch with guarded Codex analysis. Use when a user wants a trace report similar to tr... It is an AI Agent Skill for Claude Code / OpenClaw, with 95 downloads so far.
How do I install Trace Debugger Safety?
Run "/install trace-debugger-safety" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Trace Debugger Safety free?
Yes, Trace Debugger Safety is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Trace Debugger Safety support?
Trace Debugger Safety is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Trace Debugger Safety?
It is built and maintained by gakkiismywife (@gakkiismywife); the current version is v1.0.0.
More Skills