tasks-explain-diff — Claude Code skill: what it does, how to install
Turns code changes into a structured Notion document with architecture context, diagrams, and verification steps. Useful when documenting PRs for team handoffs.
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a claude-codeWhat tasks-explain-diff 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.
What it helps with
- 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 for the agent
- 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
How to install tasks-explain-diff
1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a claude-code2Manually: put the files in place
~/.claude/skills/tasks-explain-diff/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tasks-explain-diff/
1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a codex2Manually: put the files in place
.agents/skills/tasks-explain-diff/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a cursor2Manually: put the files in place
.cursor/skills/tasks-explain-diff/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makenotion/cursor-notion-plugin tasks-explain-diff2Manually: put the files in place
.github/skills/tasks-explain-diff/SKILL.md1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a gemini-cli2Platform CLI
gemini skills install https://github.com/makenotion/cursor-notion-plugin --path skills/tasks-explain-diffManually: put the files in place
.devin/skills/tasks-explain-diff/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tasks-explain-diff
How to install tasks-explain-diff in Claude Code?
Run npx skills add makenotion/cursor-notion-plugin --skill tasks-explain-diff -a claude-code. The skill file lands in ~/.claude/skills/tasks-explain-diff/SKILL.md.
What does tasks-explain-diff do?
It analyzes code differences and writes an explanatory document in Notion, featuring architecture context, code references, diagrams, and test scenarios.
What is required for tasks-explain-diff to work?
The environment needs a configured Notion MCP server because the agent relies on it to publish the generated content and retrieve the document link.