dora-report - SKILL.md Agent Skill

name: dora-report description: Generate a DORA-REPORT.md for this repository by computing the five core DORA software delivery performance metrics and three DORA agentic metrics from available data sources. Use this when asked to generate a DORA report or assess delivery performance. license: MIT metadata: author: d-oit version: "1.0"

Skill: dora-report

Purpose

Generate a DORA-REPORT.md for this repository by computing the five core DORA software delivery performance metrics and three DORA agentic metrics from available data sources.

When to use

When asked to generate a DORA report or assess delivery performance
During sprint reviews or quarterly assessments
When evaluating the ROI of AI tooling adoption
Run this skill monthly to track trends

Prerequisites

GitHub CLI (gh) installed and authenticated
Python 3.9+ available
.agents/metrics.jsonl exists
dora-metrics.jsonl exists

Steps

1. Fetch Deployment Frequency data from GitHub API

gh api "/repos/{owner}/{repo}/releases" --paginate \
  --jq '[.[] | {tag: .tag_name, published: .published_at}]' \
  > /tmp/releases.json

2. Fetch PR Lead Time data

gh api "/repos/{owner}/{repo}/pulls?state=closed&base=main" --paginate \
  --jq '[.[] | select(.merged_at != null) | {pr: .number, created: .created_at, merged: .merged_at}]' \
  > /tmp/prs.json

3. Run the compute script

python3 .agents/skills/dora-report/scripts/compute_dora.py \
  --releases /tmp/releases.json \
  --prs /tmp/prs.json \
  --agent-metrics .agents/metrics.jsonl \
  --dora-metrics dora-metrics.jsonl \
  --template .agents/skills/dora-report/templates/DORA-REPORT.md.jinja \
  --output DORA-REPORT.md \
  --period-days 30 \
  --repo $(git remote get-url origin | sed 's/.*github.com[:\/]\(.*\)\.git/\1/')

4. Review and commit the report

git add DORA-REPORT.md
git commit -m "docs(dora): update DORA-REPORT.md [skip ci]"

5. Log the report generation in metrics.jsonl

Append to .agents/metrics.jsonl:

echo '{"timestamp":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","agent":"claude","skill":"dora-report","task_description":"Generated monthly DORA report","success":true,"human_interventions":0}' >> .agents/metrics.jsonl

Success Criteria

DORA-REPORT.md is generated with up-to-date metrics.
All four core DORA metrics and three agentic metrics are populated.
The report is committed to the repository.
The activity is logged in .agents/metrics.jsonl.