Report AI workflow friction, improvement suggestions, and session diagnostics to the rqmd telemetry service. Use when an rqmd command fails unexpectedly, when workflow guidance is confusing, or when you notice something that could be improved.
Report AI workflow friction, suggestions, and errors to the rqmd telemetry service.
⚠️ Note: This skill reports issues with rqmd itself. For your own project bugs, use
/buginstead.
Enabled by default — built-in production endpoint with automatic token exchange.
RQMD_TELEMETRY_ENDPOINT env → telemetry.endpoint in config → built-in defaultRQMD_TELEMETRY_API_KEY env → config → automatic token exchangeRQMD_TELEMETRY_DISABLED=1| Event type | When to use |
|---|---|
struggle |
| Command fails, retry needed, guidance confusing, JSON malformed |
struggle (high, category: command_discovery) | CLI not found, tried multiple invocation variants, fell back to file edits |
suggestion | Friction not a failure, workflow could be more intuitive, new skill/prompt idea |
error | Python traceback, command hang/timeout |
from rqmd.telemetry import send_event
send_event(
event_type="struggle",
severity="high",
summary="rqmd --verify-summaries exited non-zero",
agent_name="rqmd",
detail={
"command": "rqmd --verify-summaries --non-interactive",
"expected": "Exit 0",
"actual": "Exit 1 with summary mismatch",
"stderr_snippet": "...",
},
)
send_event(
event_type="struggle",
severity="high",
summary="Could not invoke rqmd; fell back to file edits",
detail={
"category": "command_discovery",
"commands_attempted": ["rqmd --json --non-interactive", "uv run rqmd --json --non-interactive"],
"fallback_action": "Edited docs/requirements directly",
"stderr_snippet": "command not found: rqmd",
},
)
| Field | Required | Description |
|---|---|---|
session_id | yes | UUID per chat session or agent run |
agent_name | no | e.g. rqmd |
event_type | yes | struggle / suggestion / error / success / workflow_step |
severity | yes | low / medium / high / critical |
summary | yes | One-line, <200 chars |
detail | no | Structured context (command, expected, actual, stderr_snippet, etc.) |
POST {endpoint}/api/v1/events
Authorization: Bearer <token>
Content-Type: application/json
from rqmd.telemetry import send_event
send_event(event_type="struggle", severity="low", summary="telemetry pipeline test")
detail over raw text in summary