From sbox-bugfix-pipeline
Use when a ClickUp bug task needs to be investigated in the codebase, fixed, and delivered as a pull request - the complete lifecycle from ClickUp task to merged code
How this skill is triggered — by the user, by Claude, or both
Slash command
/sbox-bugfix-pipeline:clickup-to-prThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Complete bug fix lifecycle: ClickUp task analysis → codebase investigation → root cause analysis → code fix → branch & PR → task status update. Takes an existing ClickUp bug task and delivers a ready-to-review PR.
Complete bug fix lifecycle: ClickUp task analysis → codebase investigation → root cause analysis → code fix → branch & PR → task status update. Takes an existing ClickUp bug task and delivers a ready-to-review PR.
Required MCP servers:
Required CLI tools:
gh (GitHub CLI) — authenticated for PR creationgit — with remotes configuredRequired skills:
superpowers:systematic-debugging — for root cause investigationdigraph clickup_to_pr {
rankdir=TB;
node [shape=box, style=rounded];
task [label="1. Get ClickUp\nTask Details"];
checkout [label="2. Checkout Master\n& Create Branch"];
investigate [label="3. Investigate\nRoot Cause"];
confirm [label="Confirm with Dev", shape=diamond];
fix [label="4. Fix the Bug"];
verify [label="5. Build & Verify"];
pr [label="6. Commit &\nCreate PR"];
update [label="7. Update ClickUp\nStatus"];
done [label="Done", shape=doublecircle];
task -> checkout;
checkout -> investigate;
investigate -> confirm;
confirm -> fix [label="approved"];
fix -> verify;
verify -> pr [label="build passes"];
verify -> fix [label="build fails"];
pr -> update;
update -> done;
}
Input: ClickUp task ID (e.g. 86ewqfe4q) or URL (e.g. https://app.clickup.com/t/6958790/CMS-2714)
/t/)mcp__clickup__get_task_details with task_id and include_subtasks: truegit checkout master && git pull
git checkout -b bugfix/<CustomID>-<short-kebab-description>
Branch naming: bugfix/<CustomID>-<short-kebab-description>
bugfix/CMS-2714-hide-disabled-profiles-from-racf-resident-listInvoke superpowers:systematic-debugging skill and follow its four phases:
Phase 1 — Root Cause Investigation:
Agent with subagent_type: Explore to search the codebase thoroughly:
IgnoreQueryFilters() removing soft-delete filters on navigation propertiesDeletedAt == null checks when using AllIncludingArchivedEmployeeLocation → Employee navigationPhase 2 — Pattern Analysis:
Phase 3 — Hypothesis:
Pause — Confirm with developer before proceeding.
Present the root cause analysis and proposed fix. Use AskUserQuestion if needed.
This step is mandatory — no skipping.
# Backend fix
cd src && dotnet build CMS.WebApi/CMS.WebApi.csproj --no-restore
# Frontend fix
cd src/CMS.WebApi/ClientApp && yarn build:prod
git diff to review the change — confirm it's minimal and correctCommit message format:
[b] [<CustomID>] <Short description of the fix>
<Root cause explanation in 1-2 sentences>
Co-Authored-By: Claude Opus 4.6 <[email protected]>
PR title format: [b] [<CustomID>] <Short description>
PR body format:
## Summary
- <What was fixed and why>
- **Root cause**: <detailed explanation>
- **Fix**: <what was changed>
## Test plan
- [ ] <Steps to verify the fix>
- [ ] <Edge cases to check>
**ClickUp Task:** <clickup-url>
Generated with [Claude Code](https://claude.com/claude-code)
Steps:
git add -A)upstream if origin is a forkgh pr create targeting masterupstream remote and use --repo flagAfter the PR is created successfully:
mcp__clickup__get_space with the space ID from task detailspr - in review)mcp__clickup__update_task with task_id and statusCommon status names in CMS space:
| Status | Value |
|---|---|
| Open | Open |
| In Progress | in progress |
| PR In Review | pr - in review |
| Finished | finished |
| Staging | staging |
| Production | production |
| Mistake | Fix |
|---|---|
| Fixing symptoms, not root cause | Always trace the full data flow before coding |
Missing DeletedAt filter on navigation properties | When IgnoreQueryFilters() is used, ALL entity filters are removed — add explicit checks |
| ClickUp status case mismatch | Always fetch space statuses first — they're lowercase (e.g. pr - in review not PR In Review) |
| PR fails on fork repos | Push to upstream remote, use gh pr create --repo owner/repo |
| Forgetting to build before PR | Always run dotnet build or yarn build:prod — no exceptions |
| Overly broad fix | Fix only what the ClickUp task describes |
Using git add -A | Stage specific files to avoid committing secrets or unrelated changes |
| Item | Format |
|---|---|
| Branch | bugfix/<CustomID>-<kebab-description> |
| Commit prefix | [b] [<CustomID>] |
| PR title | [b] [<CustomID>] <Description> |
| PR target | master |
| ClickUp status after PR | pr - in review |
mastergit diff reviewed — change is correct and minimalbugfix/<CustomID>-<desc> convention[b] [<CustomID>] prefix and Co-Authored-By[b] [<CustomID>] Description formatpr - in reviewnpx claudepluginhub quynhlx/sbox-bugfix-pipeline --plugin sbox-bugfix-pipelineFixes GitHub issues end-to-end with GitHub CLI: views issue, researches context, plans fix, creates branch, implements/tests changes, submits PR.
Investigates and resolves GitHub issues with systematic triage, root cause analysis, test-driven fixes, and pull request management. Use when given an issue ID or URL.
Creates a branch and draft PR before implementation or turns existing work into a PR. Supports issue-driven workflows, review loops, and optional merge. Works on Claude Code web and local environments.