Skip to content

jpoindexter/nd-skills / skills/nd-velocity-check

nd-velocity-check

Verified

Track and surface the ratio of ideas captured vs items shipped. Warn when the capture:ship ratio is high — the ideas-rich/finish-poor pattern made visible.

FileKindSize
SKILL.mdskill md2.8 KB
---
name: nd-velocity-check
description: Track and surface the ratio of ideas captured vs items shipped. Warn when the capture:ship ratio is high — the ideas-rich/finish-poor pattern made visible.
---

# Velocity Check — Making the Ideas:Shipped Ratio Visible

## What this addresses

A common neurodivergent productivity pattern: *ideas-rich, finish-poor*. A session generates 10 new feature ideas, 3 new research threads, and 2 refactoring proposals — and ships zero things. The backlog grows faster than the done list. The backlog *feels* like progress (it's full of good ideas!) while the actual delivery rate is low.

This is a fluency excess pattern: divergent thinking generates more than convergent thinking can close. Making the ratio visible is the first intervention.

## When to apply

Apply this skill:
- At the start of a new session, when reviewing what's been done recently
- When a user asks "what should I work on?" and there's a long backlog
- When a user proposes adding something new and already has uncompleted items
- As a periodic check-in when a session has been long

## Instructions

1. **Track captures and ships mentally** (or read them from a log if available):
   - A *capture* is: adding an item to the backlog, proposing a new feature, filing a ticket, writing a roadmap item
   - A *ship* is: merging code, deploying, completing a tracked task, marking something done

2. **Compute the 7-day ratio:**
   `captures in last 7 days : ships in last 7 days`

3. **Surface the ratio** as a dim, non-blocking note:
   > "📊 Last 7 days: [N] ideas captured, [M] shipped ([ratio]:1). [Warn/OK]"

4. **Warn when ratio > 5:1** (or when ships = 0 and there are captures):
   > "📊 Last 7 days: 12 captured, 2 shipped (6:1) — the backlog is growing faster than it's closing. Consider finishing before capturing."

5. **Do not block or moralize.** This is a visible metric, not a rule. The user may have a legitimate reason. Surface it once and move on.

6. **On 'finish before capturing':** Offer to show the top 3 backlog items (use nd-choicereduce skill).

## Science basis

Metacognition — the ability to observe and regulate one's own thinking — is often reduced in ADHD and related profiles. The capture:ship ratio makes a hidden pattern legible. Once visible, the user can act on it. Without visibility, the pattern continues invisibly.

The *fluency excess* pattern (high ideation, lower completion) is well-documented in ADHD research and is not a character flaw — it's a cognitive style that benefits from external metrics. "What gets measured gets managed."

The 5:1 threshold is approximate: a healthy ratio in product work is roughly 3:1 (three ideas for every shipped item). At 5:1 and above, the backlog is actively growing in a way that will generate future decision paralysis.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall