Orgx Deviation Reporting

OrgX — skill deviation reporting

Every time an OrgX skill catches a deviation during your work, record it with OrgX so the evidence shows up in tomorrow's Daily Brief and drives the confidence trajectory for that skill.

When to record

You should record a deviation when:

• A rule from an OrgX skill triggered on code or content you touched.
• You accepted or rejected a skill's suggestion (pass outcome: confirmed or outcome: rejected).
• A skill surfaced a pattern in output you produced.

Do not record the same deviation more than once per 10-minute window — the server dedupes on dedupe_key automatically; duplicate POSTs waste tokens.

How to record

Direct HTTP POST through the OpenClaw bridge or via orgx.post_skill_deviation MCP tool:

POST /api/v1/skills/{skill_id}/deviations
Authorization: Bearer <OrgX API key>
Content-Type: application/json

{
  "evidence_kind":      "file_edit" | "commit" | "pr" | "chat_turn" | "task_output",
  "evidence_ref":       "<repo>#<pr>" | "<path>:<line>" | "<commit_sha>",
  "summary":            "<one-line description>",
  "application_source": "plugin_codex",
  "confidence":         0.0..1.0,
  "outcome":            "pending" | "confirmed" | "rejected" | "ignored",
  "trigger_context":    { "file_path": "...", "rule_matched": "..." },
  "dedupe_key":         "<sha1(skill_id | evidence_kind | evidence_ref | floor(epoch/600))>",
  "captured_at":        "2026-04-17T10:00:00Z"
}

Computing dedupe_key

import { createHash } from "node:crypto";

const bucket = Math.floor(Date.now() / 1000 / 600);
const material = [skillId, evidenceKind, evidenceRef, String(bucket)].join("|");
const dedupe_key = createHash("sha1").update(material).digest("hex");

10-minute bucketing handles save-happy editors without losing legitimate re-fires beyond that window.

What happens next

Your deviation lands in skill_deviations. The nightly rollup feeds it into the Daily Brief proof strip's "Deviations caught" tile + updates the skill's confidence sparkline. Agents whose loadout doesn't include the skill may get a cross-pollination proposal surfaced.

Links

• Full contract: https://github.com/hopeatina/orgx/blob/main/orgx/docs/api-contracts/daily-brief-schema.md#04
• SDK reference implementation (Node): https://github.com/useorgx/openclaw-plugin/blob/main/src/deviations-sdk.ts
• Daily Brief surface: https://useorgx.com/today

Source: hashgraph-online/awesome-codex-plugins → plugins/useorgx/orgx-codex-plugin/skills/orgx-deviation-reporting/SKILL.md