metrics-reporter

name	metrics-reporter
description	Record agentic task completion via event files for DORA observability.
category	metrics
license	MIT
metadata	{"author":"jules","version":"2.0"}

Skill: metrics-reporter

When to Use

• User asks for this skill's functionality

Purpose

Record agentic task completion by writing a per-event JSON file to .agents/events/. This pattern avoids Git merge conflicts and supports multi-agent coordination.

When to use

Call this skill as the LAST step of any task or sub-task.

Steps

1. Prepare Directory: Ensure the daily directory exists.

   EVENT_DIR=".agents/events/$(date -u +%Y/%m/%d)"
   mkdir -p "${EVENT_DIR}"
   

2. Generate Filename: Create a unique filename for the event.

   EVENT_FILE="${EVENT_DIR}/$(date -u +%Y-%m-%dT%H-%M-%SZ)-${AGENT_NAME:-unknown}-${TASK_ID:-$(date -u +%s)}.json"
   

3. Write Event Data: Populated with task metadata and success status.

   {
     "event_id": "$(date -u +%s)-${AGENT_NAME}",
     "task_id": "${TASK_ID}",
     "skill": "${SKILL_NAME}",
     "status": "success",
     "started_at": "${STARTED_AT}",
     "finished_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
     "success": true,
     "human_interventions": 0,
     "git_sha": "$(git rev-parse --short HEAD)"
   }
   

4. Verify: Ensure the JSON is valid and written to the correct location.

Human Interventions

Set human_interventions > 0 if:

• A human corrected, rewrote, or reverted your code.
• A PR required a fixup commit after your submission.
• A review comment called out an error in your work.

Aggregation

Aggregated metrics are periodically generated by CI into .agents/aggregated/. The CI status files are in .agents/ci/. Do not hand-edit files in these directories.

Rationalizations

Rationalization	Reality
"I'll skip metrics — it's just paperwork."	Without metrics, you can't prove AI tooling ROI or identify bottlenecks.
"I'll log it later."	Later never happens. Log immediately after task completion.
"human_interventions doesn't matter."	It's the key metric for measuring true agent autonomy vs human effort.

Red Flags

• Not calling metrics-reporter as the last step of a task
• Setting human_interventions to 0 when a human fixed your code
• Using the old append-to-metrics.jsonl pattern instead of event files