# tasks-explain-diff

Turns code changes into a structured Notion document with architecture context, diagrams, and verification steps. Useful when documenting PRs for team handoffs.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 38
- Author: makenotion
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makenotion/cursor-notion-plugin/tree/HEAD/skills/tasks-explain-diff/SKILL.md
- Updated: 2026-02-07
- HTML: https://affpapa.org/en/nevibecode/skills/tasks-explain-diff

## What it does

The skill inspects specified file diffs or the latest edits from the active chat session. It then drafts a multi-part Notion entry covering background system context, core logic explained via toy data, and specific file references with line numbers. Where relevant, it includes Mermaid charts to clarify architecture decisions.

Each generated document includes manual QA steps and a five-question interactive quiz inside toggle blocks. Publishing requires an active Notion MCP server so the assistant can create the document and return a shareable URL. Without Notion MCP configured, page export will fail.

## Requirements
- Works with: Notion

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/tasks-explain-diff/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tasks-explain-diff/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tasks-explain-diff/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tasks-explain-diff/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makenotion/cursor-notion-plugin tasks-explain-diff
```

2. **Manually: put the files in place**
- File: `.github/skills/tasks-explain-diff/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/makenotion/cursor-notion-plugin --path skills/tasks-explain-diff
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tasks-explain-diff/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/makenotion/cursor-notion-plugin/tree/HEAD/skills/tasks-explain-diff/SKILL.md

## When to use it
- document recent repository changes directly in Notion
- produce manual QA steps alongside code walkthroughs
- explain refactoring logic to teammates using toy examples
- build a quick comprehension quiz around updated logic

## Example prompts
- Explain the latest code edits and export the walkthrough to Notion
- Document the diff from the billing refactor as a Notion page using tasks-explain-diff
- Create a Notion document breaking down recent changes with diagrams and a quiz

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [domain-modeling](https://affpapa.org/en/nevibecode/skills/domain-modeling.md) — skill · 876391 installs

From the same set: [makenotion/cursor-notion-plugin](https://affpapa.org/en/nevibecode/by/makenotion/cursor-notion-plugin.md) — 13 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md