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.