# Commitment Graph

> Turns data/commitments.jsonl (flat list) into a who-owes-what-to-whom graph. Surfaces overdue chains and cross-PA dependencies that the flat list hides. Triggers: "what's overdue", "what did X promise", "commitment graph", "who's blocking whom".

- Skill: `netanel-abergel/commitment-graph` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add netanel-abergel/commitment-graph`
- Raw SKILL.md: https://api.skillmd.com/api/skills/netanel-abergel/commitment-graph/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: netanel-abergel (https://skillmd.com/u/netanel-abergel)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/netanel-abergel/commitment-graph

---


# Commitment Graph

A graph view over commitments.jsonl — surfaces overdue chains, cross-PA dependencies, and blockers.

## When to use
- Daily morning check (overdue chains)
- When asked "what's blocking X?" or "who owes me what?"
- Weekly retro (highlight repeat-offender commitments)

## Process
1. Load `data/commitments.jsonl`
2. Build directed graph: `requester → committed_by → action → due_date`
3. Output:
   - **Overdue** (due_date < today, status != done) — sorted by age
   - **Chains** (A waits on B waits on C) — flag any cycles
   - **Repeat offenders** — names appearing in 3+ overdue items in 30 days

## Script
`python skills/commitment-graph/scripts/graph.py [--overdue|--offenders]`