Dbochman/merge-and-doc
.claude/skills/merge-and-doc/SKILL.md
Merge a PR and update documentation in one workflow. Use when: (1) Ready to merge a PR and want to update roadmap/changelog, (2) Need to verify merge success before documenting, (3) Want atomic merge + doc commits. Handles gh pr merge, verification, kanban updates, and session notes in sequence.
$ install --global
skillsauthnpx skillsauth add Dbochman/dotfiles merge-and-docInstall 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, 1:49 AM6.0s1 file scanned
SKILL.md
- name:
- merge-and-doc
- description:
- |
- Merge a PR and update documentation in one workflow. Use when:
- (1) Ready to merge
- author:
- Claude Code
- version:
- 1.0.0
- date:
- 2026-02-04
- user_invocable:
- true
Merge and Document Workflow
Problem
Merging PRs and updating documentation are separate steps that often get interrupted mid-way, leaving docs out of sync with merged code. Sessions end after the merge but before the roadmap or changelog gets updated.
Context / Trigger Conditions
- User says "merge PR #X" or "merge and doc"
- PR is approved and ready to merge
- Want to ensure documentation is updated atomically with the merge
Solution
Step 1: Verify PR Status
gh pr view <PR_NUMBER> --json state,mergeable,reviews,title,body
Check that:
- State is OPEN
- Mergeable is true
- Has at least one approving review (or user explicitly overrides)
Step 2: Merge the PR
gh pr merge <PR_NUMBER> --squash --delete-branch
Use --squash by default (per project conventions). Add --admin if user has rights and wants to bypass checks.
Step 3: Verify Merge Success
git fetch origin main
git log --oneline -1 origin/main
Confirm the merge commit appears and matches the PR title.
Step 4: Update Local Main
git checkout main
git pull origin main
Step 5: Update Documentation
Based on the PR content, update relevant docs:
For feature PRs:
# Move kanban card to changelog
npm run kanban:move -- --board=roadmap --card=<card-id> --to=changelog
npm run precompile-kanban
For bug fixes:
- Add entry to session-notes.md if notable
- Move related kanban card if exists
For all PRs:
- Check if ROADMAP.md needs updating
- Check if any related cards need status changes
Step 6: Commit Documentation Updates
git add .
git commit -m "docs: update roadmap after PR #<NUMBER> merge
Moved <card-name> to changelog.
Co-Authored-By: Claude Opus 4.5 <[email protected]>"
git push origin main
Arguments
| Argument | Required | Description |
|----------|----------|-------------|
| PR number | Yes | The PR to merge (e.g., 123 or #123) |
| --admin | No | Bypass branch protection (requires admin rights) |
| --no-doc | No | Skip documentation updates |
Example Usage
/merge-and-doc 215
/merge-and-doc #215 --admin
/merge-and-doc 215 --no-doc
Verification
After completion:
- PR shows as merged on GitHub
- Local main is up to date with remote
- Kanban board reflects the change (if applicable)
npm run precompile-kanbanpasses validation
Error Handling
PR not mergeable:
- Show the blocking reason (failing checks, conflicts, missing reviews)
- Ask user if they want to proceed with
--adminor fix issues first
Merge fails:
- Show error message
- Do NOT proceed to documentation updates
- Suggest
gh pr viewto diagnose
Doc update fails:
- Complete what's possible
- Report which updates failed
- Leave user with actionable next steps
Notes
- Always use
--squashmerge per project conventions - Delete branch after merge (keeps repo clean)
- If no kanban card exists for the PR, skip kanban updates
- Session notes are optional—only add if the work was notable
- This skill follows the project's Git Workflow from CLAUDE.md
Related Skills
Dbochman/web-search
development
VerifiedTrustedCommunity
Search the web for current information, news, facts, and answers. Use when asked questions about current events, needing to look something up, finding websites, researching topics, or when you need up-to-date information beyond your training data.
1SKILL.mdUpdated Apr 17, 2026
Dbochman/summarize
development
VerifiedTrustedCommunity
Summarize any URL, YouTube video, podcast, PDF, or file into concise text. Use when asked to read an article, summarize a link, get the gist of a video or podcast, extract content from a URL, or when you need to understand what a web page or document contains.
1SKILL.mdUpdated Apr 17, 2026
Dbochman/spotify-speakers
development
VerifiedTrustedCommunity
Play music via Spotify and control Google Home speakers. Use when asked to play music, songs, artists, playlists, podcasts, or control speakers/volume/audio.
1SKILL.mdUpdated Apr 17, 2026
Dbochman/skill-creator
testing
VerifiedTrustedCommunity
Create new OpenClaw skills, modify and improve existing skills, and measure skill performance with evals. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. Also use when asked to "make a skill", "turn this into a skill", "improve this skill", or "test this skill".
1SKILL.mdUpdated Apr 17, 2026