issues-to-outcomes SKILL.md skillA

issues-to-outcomes 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/issues-to-outcomes@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/issues-to-outcomes/SKILL.md
Versions recorded
3
Latest version
git:20261021.61c15fb, committed Oct 21, 2026
First version recorded
Oct 12, 2026
Size
5,445 bytes
Repository stars
6
License
MIT

Load before writing any report of work: a status update, an end-of-day or session summary, a handoff, a 'what landed' or 'what did you do' answer, or any reply built from a list of issues, PRs or commits. Also load when the reader says a report means nothing to them, asks what they experience, or asks for it at a high level. Turns issue and PR titles into outcomes the reader notices: how much of the work shows in the product, each visible change as before and now, and the invisible work as…

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

# Issues to outcomes

A report of finished work answers one question for its reader: what is
different for me now? An issue number and its title answer a different one:
what did the tracker call it? Titles are written for whoever implements the
work. The reader of a report was not there and should not need the codebase in
their head to understand it.

## Who the reader is

Write for the person who uses the product and pays for the work. They notice
two things: what the product does when they use it, and what they or their
agents can or cannot get done while working on it. Everything in the report is
one of those two, or it is left out.

## The shape

Write the report in this order.

1. **How much of this can you see.** Open with one honest sentence on how much
   of the work shows up in the product. When the answer is "almost nothing",
   say exactly that and say what the work was instead. Do not open with a
   count of issues closed or PRs merged.

2. **What changed in the product.** One item for each change the reader can
   see, hear or do. Describe the situation they are in, what happened before,
   and what happens now. A change that is real but shows nothing yet says so,
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add checkpickerupper/skills/issues-to-outcomes@sha256:f06c0256cf4e870f

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_ibieqa5nloxsfvmh.svg)](https://markdownregistry.com/a/art_ibieqa5nloxsfvmh)

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

Versions

The registry has recorded 3 versions of this file, between Oct 12, 2026 and Oct 21, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20261021.61c15fb latest2026-10-21 61c15fb 5,445 BA view · diff
git:20261012.f30b6f82026-10-12 f30b6f8 5,368 BA view · diff
git:20261012.8ac3a522026-10-12 8ac3a52 5,315 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 (5445 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_ibieqa5nloxsfvmh
GET https://markdownregistry.com/api/v1/resolve?ref=checkpickerupper/skills/issues-to-outcomes
GET https://markdownregistry.com/api/v1/blob/f06c0256cf4e870f25e5c203eaf89fc7011fe25d6cace3d9dad9f8bd78a3d587

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.