b-open-io/critique
skills/critique/SKILL.md
This skill should be used when the user asks to "show me the changes", "what did you change", "let me see the diff", "review the code", "open web preview of changes", "show me what you worked on", "compare branches", "explain what changed", or wants to view git diffs in a terminal UI, web browser, or get AI-powered code review explanations.
$ install --global
skillsauthnpx skillsauth add b-open-io/prompts critiqueInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 29, 2026, 3:51 AM56.2s4 files scanned
SKILL.md
- name:
- critique
- version:
- 1.0.0
- description:
- This skill should be used when the user asks to "show me the changes", "what did you change", "let me see the diff", "review the code", "open web preview of changes", "show me what you worked on", "compare branches", "explain what changed", or wants to view git diffs in a terminal UI, web browser, or get AI-powered code review explanations.
Review git diffs with syntax highlighting, split view, and word-level diff. Show users what code was changed during a session using terminal UI or web preview.
Prerequisites
Critique requires Bun (does not work with Node.js):
# Run directly (no install needed)
bunx critique
# Or install globally
bun install -g critique
Core Commands
View Current Changes
# Unstaged changes (includes untracked files)
critique
# Staged changes only
critique --staged
# Watch mode - auto-refresh on file changes
critique --watch
View Commits
# Last commit
critique HEAD
# Specific commit
critique --commit HEAD~1
critique --commit abc1234
# Combined changes from last N commits
critique HEAD~3 HEAD
Compare Branches (PR-style)
# What feature-branch added vs main
critique main feature-branch
# What current branch added vs main
critique main HEAD
Filter Files
# Filter by glob pattern
critique --filter "src/**/*.ts"
critique --filter "src/**/*.ts" --filter "lib/**/*.js"
Web Preview
Generate an HTML preview viewable in a browser - ideal for sharing or detailed review:
# Generate web preview
critique --web
# Generate and open in browser
critique --web --open
# Web preview for commits
critique HEAD --web --open
critique main HEAD --web --open
The web preview provides:
- Full syntax highlighting
- Split view with before/after
- Shareable HTML output
- Better for large diffs
AI-Powered Review
Generate AI explanations of code changes. Best for reviewing AI-generated changes:
# Review unstaged changes (uses OpenCode by default)
critique review
# Use Claude Code as the AI backend
critique review --agent claude
# Review specific commits
critique review HEAD
critique review --commit HEAD~1
# Review branch diff (like a PR)
critique review main HEAD
# Include session context for better explanations
critique review --agent claude --session <session-id>
# Generate web preview of AI review
critique review --web
critique review --web --open
AI review features:
- Orders hunks in logical reading order
- Splits large hunks into digestible chunks
- Explains changes with diagrams and tables
- Groups related changes across files
Integrations
Git Difftool
Configure as default git difftool:
git config --global diff.tool critique
git config --global difftool.critique.cmd 'critique difftool "$LOCAL" "$REMOTE"'
Then use: git difftool HEAD~1
Lazygit
Add to ~/.config/lazygit/config.yml:
git:
paging:
pager: critique --stdin
Running from Claude Code
Since the TUI runs inside the Bash tool (hidden/folded), use one of these approaches:
Option 1: Split Pane (macOS with iTerm2, Recommended)
Open critique in a split pane that auto-closes when done:
# Horizontal split (top/bottom)
/path/to/skills/critique/scripts/open-critique-pane.sh /path/to/repo -h
# Vertical split (side by side)
/path/to/skills/critique/scripts/open-critique-pane.sh /path/to/repo -v
Option 2: New Terminal Tab (macOS with iTerm2)
Open critique in a new tab:
/path/to/skills/critique/scripts/open-critique.sh /path/to/repo
Option 3: Web Preview (Cross-platform)
Opens in browser - works everywhere:
bunx critique --web --open
Recommended Usage After Claude Work
When a user asks to see what changed after Claude has made modifications:
- New terminal tab (macOS): Use osascript to open critique in iTerm
- Web preview: Run
critique --web --openfor browser view - AI-explained review: Run
critique review --agent claude --web --open - Compare to starting point: Run
critique HEAD~N HEAD --web --open
Navigation Keys (Terminal UI)
| Key | Action |
|-----|--------|
| j/k or ↓/↑ | Navigate lines |
| h/l or ←/→ | Switch files |
| Tab | Toggle split/unified view |
| q | Quit |
| ? | Help |
Related Skills
b-open-io/html-to-pdf
development
VerifiedTrustedCommunity
This skill should be used when the user asks to "design a business card", "make a printable PDF", "render HTML to PDF", "generate a postcard", "build print collateral", "set up an HTML print pipeline", or needs help with bleed, safe areas, font embedding, or QR generation for print. Provides a Playwright-based pipeline with multiple bundled templates and theme variants for business cards (minimal, watercolor light, watercolor dark) and instructions for adding new templates.
12SKILL.mdUpdated May 29, 2026
b-open-io/x-user-timeline
tools
VerifiedTrustedCommunity
Get recent tweets from an X/Twitter user. Use when user asks "what has @username posted", "recent tweets from", "user's X posts", "show timeline for", "what is @user saying". Requires X_BEARER_TOKEN.
12SKILL.mdUpdated Apr 3, 2026
b-open-io/x-user-lookup
data-ai
VerifiedTrustedCommunity
Get X/Twitter user profile by username. Use when user asks "who is @username", "get X profile", "lookup Twitter user", "find X account", "user details", "follower count for". Requires X_BEARER_TOKEN.
12SKILL.mdUpdated Apr 3, 2026
b-open-io/x-tweet-search
data-ai
VerifiedTrustedCommunity
Search recent X/Twitter posts by query. Returns RAW TWEETS (last 7 days). Use when user asks "search X for", "find tweets about", "what are people saying about", "Twitter search", "raw tweets about". For AI summaries/sentiment, use x-research instead. Requires X_BEARER_TOKEN.
12SKILL.mdUpdated Apr 3, 2026