---
name: Check Coverage
slug: check-coverage
category: Quality
description: Check Coverage ensures a CLI handler and its tests cover all documented commands, flags, and edge cases. Use it when adding a new command or auditing existing handler coverage.
github: "https://github.com/ldayton/Dippy/tree/main/.claude/skills/check-coverage"
language: Python
stars: 243
forks: 21
install: "npx degit https://github.com/ldayton/Dippy/tree/main/.claude/skills/check-coverage ~/.claude/skills/check-coverage"
installs_to: ~/.claude/skills/check-coverage
source_path: .claude/skills/check-coverage/SKILL.md
collection_size: 5
category_size: 1418
collection_url: "https://dirskills.com/collections/ldayton/Dippy"
added: 2026-09-02T05:21:48.702Z
last_synced: 2026-09-02T05:21:48.702Z
canonical_url: "https://dirskills.com/skills/check-coverage"
---

# Check Coverage

Check Coverage ensures a CLI handler and its tests cover all documented commands, flags, and edge cases. Use it when adding a new command or auditing existing handler coverage.

**Install:**

```bash
npx degit https://github.com/ldayton/Dippy/tree/main/.claude/skills/check-coverage ~/.claude/skills/check-coverage
```

## README

Ensure the handler and tests for `$ARGUMENTS` provide comprehensive coverage.

## 1. Gather Documentation

Find documentation for the tool (need at least one source):

**tldr:**
```
ls ~/source/tldr/pages/*/$ARGUMENTS*.md
cat ~/source/tldr/pages/*/$ARGUMENTS.md
```

**Local CLI:**
```
$ARGUMENTS --help
man $ARGUMENTS
```

Stop if neither source exists.

## 2. Explore Subcommands

For tools with subcommands, recursively explore:
```
$ARGUMENTS <subcommand> --help
$ARGUMENTS help <subcommand>
```

Build a mental model of:
- All subcommands and their actions
- Which operations are read-only (safe) vs mutate state (unsafe)
- Global flags that affect parsing
- Edge cases

## 3. Review Existing Tests

Read `tests/cli/test_$ARGUMENTS.py` and check for:
- Coverage of all subcommands
- Both safe and unsafe variants of each action
- Global flag handling
- Edge cases from the docs

## 4. Add Missing Tests

Add aspirational test cases for anything missing. Follow existing format:
```python
TESTS = [
    # --- Subcommand group ---
    ("$ARGUMENTS <subcommand> <safe-action>", True),
    ("$ARGUMENTS <subcommand> <unsafe-action>", False),
]
```

## 5. Iterate Until Tests Pass

```
just test
```

For each failure, determine if the test expectation is correct:
- If yes, update `src/dippy/cli/$ARGUMENTS.py`
- If no, fix the test

## 6. Verify

`just check` MUST pass before you're done.