szymonkaliski/plan-review
dotfiles/agents/skills/plan-review/SKILL.md
Open the current plan file in nvim for user review
$ install --global
skillsauthnpx skillsauth add szymonkaliski/home-configuration plan-reviewInstall 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: Apr 17, 2026, 7:26 AM329.3s1 file scanned
SKILL.md
- name:
- plan-review
- description:
- Open the current plan file in nvim for user review
- allowed-tools:
- Bash(tmux *), Bash(tmux-smart-split), Read
- disable-model-invocation:
- true
Open the plan file in nvim (in a tmux split) so the user can review, edit, and add inline annotations. After the user closes nvim, re-read the file and extract any annotations.
Arguments
$ARGUMENTS is the path to the plan file. If empty, determine it from conversation context.
Steps
-
Derive a unique signal name from the plan file basename:
plan-review-{basename_without_extension} -
Open up a split with nvim:
tmux-smart-split "nvim '$PLAN_PATH'; tmux wait-for -S plan-review-{basename}"Then wait (this blocks until the user quits nvim):
tmux wait-for plan-review-{basename}Use
run_in_background: trueon the wait command. Then poll withTaskOutputusingblock: true, timeout: 600000. If it times out, keep polling - never give up. -
After nvim closes,
Readthe plan file. -
Scan for lines containing
TODO:,FIXME:, orCOMMENT:annotations. -
Present results:
- Annotations found: list each annotation with its line number and content, then ask how to proceed.
- No annotations: report the plan is approved as-is.
Related Skills
szymonkaliski/tdd
development
VerifiedTrustedCommunity
Test-driven bug fixing and feature development. Use when fixing bugs or building features — works with test suites or ad-hoc repro scripts. Enforces red-green-refactor vertical slices.
8SKILL.mdUpdated Apr 15, 2026
szymonkaliski/git-review
testing
VerifiedTrustedCommunity
Review uncommitted changes for issues, missed items, and improvements. Use when reviewing before commit or when user asks to check their work.
8SKILL.mdUpdated Apr 15, 2026
szymonkaliski/git-commit
tools
VerifiedTrustedCommunity
Format, lint, test, and commit changes. Detects repo tooling automatically.
8SKILL.mdUpdated Apr 15, 2026
szymonkaliski/git-catchup
tools
VerifiedTrustedCommunity
Understand current work context from recent changes. Use at session start or when resuming work.
8SKILL.mdUpdated Apr 15, 2026