| 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
-
Prepare Directory: Ensure the daily directory exists.
EVENT_DIR=".agents/events/$(date -u +%Y/%m/%d)"
mkdir -p "${EVENT_DIR}"
-
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"
-
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)"
}
-
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