aiskillstore/marketplace / skills/0xdarkmatter/python-observability-patterns
python-observability-patterns
VerifiedObservability patterns for Python applications. Triggers on: logging, metrics, tracing, opentelemetry, prometheus, observability, monitoring, structlog, correlation id.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.0 KB |
| assets/logging-config.py | script | 3.2 KB |
| references/metrics.md | markdown | 7.5 KB |
| references/structured-logging.md | markdown | 7.8 KB |
| references/tracing.md | markdown | 8.0 KB |
| skill-report.json | config | 32.8 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-06T02:07:04.123Z",
"slug": "0xdarkmatter-python-observability-patterns",
"source_url": "https://github.com/0xDarkMatter/claude-mods/tree/main/skills/python-observability-patterns",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "f5ceb4cd93e3fe0f96ef13b1c8902326df5c88d889138e6f29f3857a139c2298",
"tree_hash": "ce18324d1a0a55bcc0680646be6c981a2096efb91f641e671f878c3780feb874",
"provenance": {
"model_requested": "gpt-5.5:high",
"model_effective": "codex:gpt-5.5:high",
"fallback_chain": [
{
"agent": "codex",
"model": "gpt-5.5",
"effort": "high",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "python-observability-patterns",
"description": "Guides Python developers in adding structured logging, Prometheus metrics, and OpenTelemetry tracing to production services.",
"summary": "Add production-ready observability patterns to Python applications.",
"icon": "📦",
"version": "1.0.0",
"author": "0xDarkMatter",
"license": "MIT",
"tags": [
"python",
"observability",
"logging",
"metrics",
"tracing"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"env_access",
"scripts",
"network",
"external_commands"
],
"category": "devops"
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "All static findings were reviewed as false positives caused by Markdown examples, placeholder telemetry endpoints, request correlation identifiers, and defensive redaction patterns. No prompt injection attempt, malicious intent, credential exfiltration, or unauthorized command execution was found in the reviewed files.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "env_access",
"evidence": [
{
"file": "references/structured-logging.md",
"line_start": 173,
"line_end": 173
}
]
},
{
"factor": "scripts",
"evidence": [
{
"file": "references/tracing.md",
"line_start": 244,
"line_end": 248
}
]
},
{
"factor": "network",
"evidence": [
{
"file": "references/tracing.md",
"line_start": 26,
"line_end": 26
},
{
"file": "references/tracing.md",
"line_start": 114,
"line_end": 114
}
]
},
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 16,
"line_end": 37
},
{
"file": "SKILL.md",
"line_start": 37,
"line_end": 41
},
{
"file": "SKILL.md",
"line_start": 41,
"line_end": 64
},
{
"file": "SKILL.md",
"line_start": 64,
"line_end": 68
},
{
"file": "SKILL.md",
"line_start": 68,
"line_end": 120
},
{
"file": "SKILL.md",
"line_start": 120,
"line_end": 124
},
{
"file": "SKILL.md",
"line_start": 124,
"line_end": 148
},
{
"file": "SKILL.md",
"line_start": 148,
"line_end": 166
},
{
"file": "SKILL.md",
"line_start": 166,
"line_end": 167
},
{
"file": "SKILL.md",
"line_start": 167,
"line_end": 168
},
{
"file": "SKILL.md",
"line_start": 168,
"line_end": 172
},
{
"file": "SKILL.md",
"line_start": 172,
"line_end": 179
},
{
"file": "SKILL.md",
"line_start": 179,
"line_end": 182
},
{
"file": "SKILL.md",
"line_start": 182,
"line_end": 183
},
{
"file": "SKILL.md",
"line_start": 183,
"line_end": 186
}
]
}
],
"static_findings": [
{
"id": "blocker:references/metrics.md:201:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/metrics.md",
"line_start": 201,
"line_end": 201,
"snippet": "return await db.execute(select(User).where(User.id == user_id))"
},
{
"id": "blocker:references/metrics.md:327:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/metrics.md",
"line_start": 327,
"line_end": 327,
"snippet": "| Bad | user_id, request_id |"
},
{
"id": "env_access:references/structured-logging.md:173:generic-api-secret-keys",
"category": "env_access",
"severity": "high",
"pattern": "Generic API/secret keys",
"file": "references/structured-logging.md",
"line_start": 173,
"line_end": 173,
"snippet": "sensitive_keys = {\"password\", \"token\", \"secret\", \"api_key\", \"authorization\"}"
},
{
"id": "blocker:references/structured-logging.md:66:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/structured-logging.md",
"line_start": 66,
"line_end": 66,
"snippet": "from uuid import uuid4"
},
{
"id": "blocker:references/structured-logging.md:74:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/structured-logging.md",
"line_start": 74,
"line_end": 74,
"snippet": "rid = request_id or str(uuid4())"
},
{
"id": "blocker:references/structured-logging.md:80:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/structured-logging.md",
"line_start": 80,
"line_end": 82,
"snippet": "context[\"user_id\"] = user_id"
},
{
"id": "blocker:references/structured-logging.md:83:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/structured-logging.md",
"line_start": 83,
"line_end": 85,
"snippet": "return rid"
},
{
"id": "blocker:references/structured-logging.md:96:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/structured-logging.md",
"line_start": 96,
"line_end": 96,
"snippet": "request_id = request.headers.get(\"X-Request-ID\", str(uuid4()))"
},
{
"id": "blocker:references/structured-logging.md:113:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/structured-logging.md",
"line_start": 113,
"line_end": 114,
"snippet": "response.headers[\"X-Request-ID\"] = request_id"
},
{
"id": "blocker:references/structured-logging.md:152:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "references/structured-logging.md",
"line_start": 152,
"line_end": 152,
"snippet": "self.order_id = order_id"
},
{
"id": "scripts:references/tracing.md:244:dynamic-import-expression",
"category": "scripts",
"severity": "medium",
"pattern": "Dynamic import() expression",
"file": "references/tracing.md",
"line_start": 244,
"line_end": 248,
"snippet": "from opentelemetry.sdk.trace.sampling import ("
},
{
"id": "network:references/tracing.md:26:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "references/tracing.md",
"line_start": 26,
"line_end": 26,
"snippet": "endpoint=\"http://localhost:4317\","
},
{
"id": "network:references/tracing.md:114:hardcoded-url",
"category": "network",
"severity": "low",
"pattern": "Hardcoded URL",
"file": "references/tracing.md",
"line_start": 114,
"line_end": 114,
"snippet": "\"https://api.example.com/process\","
},
{
"id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 16,
"line_end": 37,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 37,
"line_end": 41,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 41,
"line_end": 64,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 64,
"line_end": 68,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 68,
"line_end": 120,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:120:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 120,
"line_end": 124,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 124,
"line_end": 148,
"snippet": "```python"
},
{
"id": "external_commands:SKILL.md:148:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 148,
"line_end": 166,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 166,
"line_end": 167,
"snippet": "- `./references/structured-logging.md` - structlog configuration, formatters"
},
{
"id": "external_commands:SKILL.md:167:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 167,
"line_end": 168,
"snippet": "- `./references/metrics.md` - Prometheus patterns, custom metrics"
},
{
"id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 168,
"line_end": 172,
"snippet": "- `./references/tracing.md` - OpenTelemetry, distributed tracing"
},
{
"id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 172,
"line_end": 179,
"snippet": "- `./assets/logging-config.py` - Production logging configuration"
},
{
"id": "external_commands:SKILL.md:179:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 179,
"line_end": 182,
"snippet": "- `python-async-patterns` - Async context propagation"
},
{
"id": "external_commands:SKILL.md:182:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 182,
"line_end": 183,
"snippet": "- `python-fastapi-patterns` - API middleware for metrics/tracing"
},
{
"id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 183,
"line_end": 186,
"snippet": "- `python-cli-patterns` - CLI logging patterns"
},
{
"id": "blocker:SKILL.md:44:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 44,
"line_end": 44,
"snippet": "from uuid import uuid4"
},
{
"id": "blocker:SKILL.md:50:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 50,
"line_end": 50,
"snippet": "rid = request_id or str(uuid4())"
},
{
"id": "blocker:SKILL.md:53:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 53,
"line_end": 55,
"snippet": "return rid"
},
{
"id": "blocker:SKILL.md:58:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 58,
"line_end": 58,
"snippet": "request_id = request.headers.get(\"X-Request-ID\") or str(uuid4())"
},
{
"id": "blocker:SKILL.md:61:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 61,
"line_end": 62,
"snippet": "response.headers[\"X-Request-ID\"] = request_id"
}
],
"finding_verdicts": [
{
"id": "blocker:references/metrics.md:201:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.93,
"reason": "The snippet is sample application code timing a database query with a provided user_id. It does not enumerate the host, inspect the system, or gather environment metadata."
},
{
"id": "blocker:references/metrics.md:327:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The table explicitly warns that user_id and request_id are bad Prometheus labels because of high cardinality. This is defensive observability guidance, not reconnaissance."
},
{
"id": "env_access:references/structured-logging.md:173:generic-api-secret-keys",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The terms appear in a sensitive_keys set used by filter_sensitive_data to redact log fields. No secret value is read, stored, or transmitted."
},
{
"id": "blocker:references/structured-logging.md:66:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "uuid4 is imported to generate request correlation IDs. It is not used to inspect system state or identify the host."
},
{
"id": "blocker:references/structured-logging.md:74:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The code generates a request ID when one is not supplied. This is ordinary request correlation logic, not system reconnaissance."
},
{
"id": "blocker:references/structured-logging.md:80:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.9,
"reason": "The snippet binds request context fields for structured logs. It does not probe the local system or collect machine metadata."
},
{
"id": "blocker:references/structured-logging.md:83:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The statement returns the generated request ID from a helper function. Returning a correlation ID is not reconnaissance."
},
{
"id": "blocker:references/structured-logging.md:96:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The middleware reads or creates an X-Request-ID header for traceability. It does not enumerate the host or inspect files, processes, users, or networks."
},
{
"id": "blocker:references/structured-logging.md:113:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The response header mirrors the request ID for client-side correlation. This is normal observability behavior and not system reconnaissance."
},
{
"id": "blocker:references/structured-logging.md:152:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.94,
"reason": "The line stores an order_id on a custom exception object for logging context. It does not gather system information."
},
{
"id": "scripts:references/tracing.md:244:dynamic-import-expression",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "This is a normal Python from-import statement for OpenTelemetry sampler classes. It is not dynamic import execution or loading attacker-controlled modules."
},
{
"id": "network:references/tracing.md:26:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.88,
"reason": "The URL is a localhost OTLP collector endpoint in an OpenTelemetry setup example. It describes a deployment configuration and does not make the skill perform network access."
},
{
"id": "network:references/tracing.md:114:hardcoded-url",
"verdict": "false_positive",
"confidence": 0.86,
"reason": "The URL uses api.example.com in a context propagation example. It is a placeholder external service, not an active exfiltration endpoint or hidden callback."
},
{
"id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The finding points to a Markdown Python code fence. It is documentation for structlog configuration, not shell execution."
},
{
"id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is a closing Markdown code fence. It contains no command invocation or executable backtick expression."
},
{
"id": "external_commands:SKILL.md:41:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The finding points to a Markdown Python code fence for request context examples. It is not a shell command or Ruby backtick execution."
},
{
"id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is a closing Markdown code fence. It does not execute a command or interpolate user input."
},
{
"id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The finding points to a Markdown Python code fence for Prometheus examples. It is documentation, not external command execution."
},
{
"id": "external_commands:SKILL.md:120:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is a closing Markdown code fence. It has no shell execution semantics in the skill content."
},
{
"id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The finding points to a Markdown Python code fence for OpenTelemetry examples. It is not a command execution primitive."
},
{
"id": "external_commands:SKILL.md:148:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The snippet is a closing Markdown code fence. It contains no command and no execution path."
},
{
"id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks format a relative documentation path in a resource list. The skill is not instructing the agent to execute that path."
},
{
"id": "external_commands:SKILL.md:167:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks format a relative documentation path in a resource list. This is a reference to read, not a shell command."
},
{
"id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks format a relative documentation path in a resource list. No external command is invoked."
},
{
"id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks format a relative asset path. It identifies a logging configuration file and does not execute it."
},
{
"id": "external_commands:SKILL.md:179:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks format the name of a prerequisite skill. It is plain Markdown text and not a shell execution pattern."
},
{
"id": "external_commands:SKILL.md:182:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks format the name of a related skill. It is not command syntax or executable code."
},
{
"id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The backticks format the name of a related skill. The content does not call a shell or external process."
},
{
"id": "blocker:SKILL.md:44:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "uuid4 is imported to generate request correlation IDs in a Python example. It is unrelated to host or network reconnaissance."
},
{
"id": "blocker:SKILL.md:50:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The line generates a request ID if none is supplied. This supports log correlation and does not inspect the system."
},
{
"id": "blocker:SKILL.md:53:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.96,
"reason": "The helper returns the request ID it created or received. This is not reconnaissance behavior."
},
{
"id": "blocker:SKILL.md:58:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The middleware reads or creates an X-Request-ID header for request tracing. It does not collect local system details."
},
{
"id": "blocker:SKILL.md:61:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.95,
"reason": "The response header exposes the same request ID for correlation. This is a common observability pattern, not host reconnaissance."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 5,
"total_lines": 1213,
"audit_model": "codex",
"audited_at": "2026-07-06T02:07:04.123Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Add Python Observability Patterns",
"value_statement": "Python services often lack consistent logging, metrics, and tracing patterns. This skill provides practical structlog, Prometheus, and OpenTelemetry examples for production applications.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"Python observability",
"structured logging",
"Prometheus metrics",
"OpenTelemetry tracing",
"structlog",
"FastAPI monitoring",
"AI coding assistant"
],
"actual_capabilities": [
"Shows structlog setup for JSON logging and standard library integration.",
"Demonstrates request ID context propagation for FastAPI middleware.",
"Provides Prometheus counters, histograms, gauges, summaries, and metrics endpoints.",
"Explains OpenTelemetry setup, spans, events, sampling, and context propagation.",
"Includes a reusable Python logging configuration asset.",
"Advises on sensitive data redaction and low-cardinality metric labels."
],
"limitations": [
"Provides reference patterns, not a packaged observability framework.",
"Requires project-specific dependencies, exporters, service names, and sampling choices.",
"Does not provision Prometheus, Grafana, Jaeger, Tempo, or OpenTelemetry Collector.",
"Does not define log retention, privacy, or compliance policies."
],
"use_cases": [
{
"title": "Instrument FastAPI Services",
"description": "Add request logging, metrics middleware, and trace propagation to Python APIs.",
"target_user": "Backend developers"
},
{
"title": "Standardize Production Logging",
"description": "Create consistent JSON logs with request IDs, service fields, and redaction rules.",
"target_user": "Platform engineers"
},
{
"title": "Improve Incident Diagnosis",
"description": "Connect logs, metrics, and traces so teams can investigate latency and failures faster.",
"target_user": "SRE teams"
}
],
"prompt_templates": [
{
"title": "Set Up Structured Logging",
"scenario": "Beginner setup for a Python service",
"prompt": "Use this skill to add structured JSON logging to my Python service. Include request IDs, log levels, timestamps, and a safe production default."
},
{
"title": "Add Prometheus Metrics",
"scenario": "Intermediate API monitoring",
"prompt": "Use this skill to add Prometheus metrics to my FastAPI app. Include request count, latency, active requests, and a /metrics endpoint."
},
{
"title": "Integrate Distributed Tracing",
"scenario": "Advanced service tracing",
"prompt": "Use this skill to instrument my Python service with OpenTelemetry. Include an OTLP exporter, FastAPI instrumentation, manual spans, and trace context propagation."
},
{
"title": "Design Full Observability",
"scenario": "Advanced production readiness review",
"prompt": "Use this skill to review my Python application observability. Recommend logging, metrics, tracing, sampling, redaction, and low-cardinality label changes."
}
],
"output_examples": [
{
"input": "A FastAPI service needs request visibility in production.",
"output": "A plan that adds request IDs, structured access logs, request counters, latency histograms, active request gauges, and trace propagation."
},
{
"input": "A team wants to reduce noisy logs and protect sensitive values.",
"output": "A logging configuration approach with JSON output, service metadata, library log level controls, and credential redaction guidance."
},
{
"input": "An API has intermittent slow payment requests.",
"output": "A tracing strategy with nested spans for validation, inventory, payment, confirmation, exception recording, and sampling recommendations."
}
],
"best_practices": [
"Redact credentials and personal data before logs leave the process.",
"Use low-cardinality metric labels such as method, endpoint, and status.",
"Make service names, exporter endpoints, environments, and sampling rates configurable."
],
"anti_patterns": [
"Do not use user IDs, request IDs, or email addresses as metric labels.",
"Do not log tokens, passwords, authorization headers, or raw payment data.",
"Do not hardcode production collector endpoints directly in shared application code."
],
"faq": [
{
"question": "What Python libraries does this skill focus on?",
"answer": "It focuses on structlog, prometheus-client, OpenTelemetry, FastAPI middleware, and related instrumentation packages."
},
{
"question": "Can this skill configure my monitoring infrastructure?",
"answer": "No. It provides application code patterns, but infrastructure setup remains project-specific."
},
{
"question": "Does this skill support Claude, Codex, and Claude Code?",
"answer": "Yes. The generated guidance is suitable for Claude, Codex, and Claude Code workflows."
},
{
"question": "Does it include sensitive data handling?",
"answer": "Yes. It includes examples for redacting credentials and avoiding unsafe metric labels."
},
{
"question": "Is this only for FastAPI applications?",
"answer": "No. Several examples use FastAPI, but the logging, metrics, and tracing patterns can be adapted to other Python services."
},
{
"question": "Will the examples run without changes?",
"answer": "Most examples need application-specific imports, dependency installation, service names, and endpoint configuration."
}
]
},
"file_structure": [
{
"name": "assets",
"type": "dir",
"path": "assets",
"children": [
{
"name": "logging-config.py",
"type": "file",
"path": "assets/logging-config.py",
"lines": 115
}
]
},
{
"name": "references",
"type": "dir",
"path": "references",
"children": [
{
"name": "metrics.md",
"type": "file",
"path": "references/metrics.md",
"lines": 329
},
{
"name": "structured-logging.md",
"type": "file",
"path": "references/structured-logging.md",
"lines": 300
},
{
"name": "tracing.md",
"type": "file",
"path": "references/tracing.md",
"lines": 282
}
]
},
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 187
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |