dilbert

Generates plain-language walkthrough documents explaining pull requests, branches, and diffs for non-technical readers.

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/SYKhayyat/claude-skills --skill dilbert-sykhayyat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dilbert
Source: https://github.com/SYKhayyat/claude-skills/tree/main/dilbert/skills/dilbert
Command: npx skills add https://github.com/SYKhayyat/claude-skills --skill dilbert-sykhayyat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Pull requests are written in code and jargon, so non-technical stakeholders cannot follow what changed, and reviewers often lack a single document that explains the change completely. This Skill turns a PR, branch, commit range, or uncommitted diff into a document a non-technical reader can follow end to end while remaining complete enough to review the change from. ## Core Features & Use Cases - Dual-layer explanation documents: Produces a full plain-English layer (opening, glossary, story, per-file summaries) plus a complete code layer with quoted before/after code, deletions, and file:line anchors. - Multiple diff targets: Explains a GitHub PR by number or URL, a branch against its merge base, a commit range, or the uncommitted working tree, using git and the gh CLI. - Verification and audits: Cross-checks PR descriptions, commit messages, and comments against the actual code, then runs two mandatory audits — readability for a layperson and completeness for a reviewer. - Use Case: A product manager needs to understand PR #60 before sign-off. Run /dilbert 60 to get a document with a ten-word glossary, the bug told as a story, and every changed function quoted before and after. ## Quick Start Ask the assistant to explain pull request number 60 as a document a non-technical reader can follow, and choose a destination folder and markdown or org format when prompted.

Frequently Asked Questions about dilbert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I explain a pull request to a non-technical person?

Invoke the skill with a PR number, branch, commit range, or no argument for the working tree. It produces a document with a plain-English opening, a glossary of about ten terms, the change told as a story, and real code quoted with an English sentence above every code block.

How to generate documentation from a git diff or commit range?

Pass a commit range like abc123..def456 or a branch name, and the skill computes the combined diff via git diff base...head, reads the source files at head, and writes a structured walkthrough in markdown or org format.

Does explaining a GitHub PR require the gh CLI?

Yes, explaining a PR by number or URL requires an authenticated gh CLI to fetch PR metadata. Branch, commit-range, and working-tree modes need only git, and the skill never switches branches or touches the working tree.

Can the generated document be used to review the code change?

Yes, the document quotes every changed function before and after, includes deletions, and anchors code with file:line references, so a reviewer can approve or reject without opening the diff. It deliberately contains no findings or verdict of its own.

What are the limitations of automated PR explanation?

The skill explains but never grades, so it produces no findings, nitpicks, or approve/reject recommendations. Very large changes above roughly 25 files require subagent fan-out, and any load-bearing claims must be verified against the source.