settle-blockers SKILL.md skillA

settle-blockers from checkpickerupper/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add checkpickerupper/skills/settle-blockers@git:20261021.61c15fb

Pins git:20261021.61c15fb in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
checkpickerupper/skills
Path
skills/productivity/settle-blockers/SKILL.md
Versions recorded
2
Latest version
git:20261021.61c15fb, committed Oct 21, 2026
First version recorded
Oct 14, 2026
Size
4,645 bytes
Repository stars
6
License
MIT

Decide whether each blocked-by link or claimed blocker between GitHub issues is real, and record the verdict on the issue. Use before calling work blocked, waiting on another issue, or sequencing issues; when picking what can run in parallel; when reviewing or creating blocked-by edges; and when an agent reports 'blocked on #N'. A blocker is real only when the work cannot be done now or doing it now means redoing it; shared files, merge conflicts and relatedness never are. Sends cheap…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Settle blockers

Waiting costs time, so every wait has to buy something. An issue is
**blocked** only when one of these is true:

- **Missing**: it needs something only the blocker delivers (a function, a
  table, an API, a decision), and building that here would duplicate the
  blocker's work.
- **Rework**: doing it now means redoing part of it once the blocker lands.

Everything else is ready now. That includes touching the same file, an expected
merge conflict, a related topic, a preferred order, "safer to wait", a big or
important blocker, and a link that already exists. A conflict is fixed in
minutes at merge time; waiting costs the whole blocker.

This skill settles and records. Starting the work it finds ready is a separate
step the owner calls for.

## 1. List what needs a verdict

<what-to-do>
Run the check on the repository, or on the issues in question:

```bash
python3 <folder of this SKILL.md>/scripts/blockers.py check --repo OWNER/REPO [--issue N ...]
```

It lists every blocked-by link with no reason line, every reason line with no
link, every line with no reason, and every blocker that has already closed.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add checkpickerupper/skills/settle-blockers@sha256:2d3fdbaef5eb5936

The line at the top of this page pins the label git:20261021.61c15fb, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tk2ovzjfzou272et.svg)](https://markdownregistry.com/a/art_tk2ovzjfzou272et)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Oct 14, 2026 and Oct 21, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20261021.61c15fb latest2026-10-21 61c15fb 4,645 BA view · diff
git:20261014.1bd544c2026-10-14 1bd544c 4,551 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4645 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

checkpickerupper/skills · 6 stars · license MIT · pushed 2026-10-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tk2ovzjfzou272et
GET https://markdownregistry.com/api/v1/resolve?ref=checkpickerupper/skills/settle-blockers
GET https://markdownregistry.com/api/v1/blob/2d3fdbaef5eb5936db1d0a27f2ac0ba52580ab9d3a50a114c9d438e53dcfc7c8

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from checkpickerupper/skills

grill-with-docs-requiem SKILL.md skill
checkpickerupper/skills · skills/deprecated/grill-with-docs-requiem/SKILL.md · A high-judgment design interview that sharpens plans in useful batches and records settled domain language and ADRs as…
git:20261012.0a0453b · audit A · 6 stars
antimatter-code-quality-review SKILL.md skill
checkpickerupper/skills · skills/engineering/antimatter-code-quality-review/SKILL.md · Deep code-quality and pre-merge review of a commit, PR, branch, or diff. Audit correctness, intent, naming, cohesion…
git:20261021.61c15fb · audit A · 6 stars
antimatter-codebase-structure-review SKILL.md skill
checkpickerupper/skills · skills/engineering/antimatter-codebase-structure-review/SKILL.md · Pedantic structural audit of a commit, PR or branch, selected directory or module, or an entire codebase — hierarchy…
git:20261021.61c15fb · audit A · 6 stars
explain-diff SKILL.md skill
checkpickerupper/skills · skills/engineering/explain-diff/SKILL.md · Explain a code change, diff, branch, commit, or PR as a rich, self-contained page: background, intuition with concrete…
git:20261021.61c15fb · audit B · 6 stars
pizza1 SKILL.md skill
checkpickerupper/skills · skills/engineering/pizza1/SKILL.md · Justify by correctness, never by convention. Use when a design, fix, API, macro, library surface, hook message, or…
git:20261021.61c15fb · audit A · 6 stars
readonly SKILL.md skill
checkpickerupper/skills · skills/engineering/readonly/SKILL.md · User-invoked modifier for evidence-first read-only investigation. Use when the user appends /readonly to a question or…
git:20261021.61c15fb · audit A · 6 stars
zen-of-checkpickerupper SKILL.md skill
checkpickerupper/skills · skills/engineering/zen-of-checkpickerupper/SKILL.md · The Zen of CheckPickerUpper: twenty-one lines that judge designs, fixes, abstractions, types, structure, and questions…
git:20261021.61c15fb · audit A · 6 stars
agent-mdlint SKILL.md skill
checkpickerupper/skills · skills/in-progress/agent-mdlint/SKILL.md · Review AGENTS.md changes for Markdown defects, duplicated or conflicting instructions, and unintended semantic drift…
git:20261021.98508ae · audit A · 6 stars
build-vs-buy SKILL.md skill
checkpickerupper/skills · skills/in-progress/build-vs-buy/SKILL.md · Before implementing a new capability, service, subsystem, or integration, choose its owner—reuse, adopt, buy, build…
git:20261021.98508ae · audit A · 6 stars
correct-by-construction SKILL.md skill
checkpickerupper/skills · skills/in-progress/correct-by-construction/SKILL.md · Make classes of invalid states and evaded constraints unreachable by type composition first. Use for bugs, bad APIs…
git:20261021.98508ae · audit A · 6 stars
make-artifact SKILL.md skill
checkpickerupper/skills · skills/in-progress/make-artifact/SKILL.md · Make, revise, or republish a claude.ai Artifact of any kind: report, audit, decision page, dashboard, tracker, form…
git:20261021.98508ae · audit A · 6 stars
pressure-test-this SKILL.md skill
checkpickerupper/skills · skills/in-progress/pressure-test-this/SKILL.md · Adversarial stress-test of an architecture, technical proposal, API contract, state machine, or plan before…
git:20261021.98508ae · audit A · 6 stars

Every file in checkpickerupper/skills

Browse by kind, by grade A, or by owner.