Finishing a Development Branch
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
Symptom to cause to fix for build, CI, and runtime failures, plus the pre-commit checklist.
Install Troubleshooting
$ npx skills add projectbluefin/finpilot --skill troubleshooting -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install projectbluefin/finpilot troubleshooting --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/projectbluefin/finpilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/troubleshooting .claude/skills/troubleshooting && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "troubleshooting" agent skill from https://github.com/projectbluefin/finpilot/tree/main/.agents/skills/troubleshooting into .claude/skills/troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/projectbluefin/finpilot/tree/main/.agents/skills/troubleshootingType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add projectbluefin/finpilot --skill troubleshooting -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install projectbluefin/finpilot troubleshooting --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/projectbluefin/finpilot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/troubleshooting .agents/skills/troubleshooting && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "troubleshooting" agent skill from https://github.com/projectbluefin/finpilot/tree/main/.agents/skills/troubleshooting into .agents/skills/troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add projectbluefin/finpilot --skill troubleshooting -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install projectbluefin/finpilot troubleshooting --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/projectbluefin/finpilot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/troubleshooting .cursor/skills/troubleshooting && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "troubleshooting" agent skill from https://github.com/projectbluefin/finpilot/tree/main/.agents/skills/troubleshooting into .cursor/skills/troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/projectbluefin/finpilot.git --path .agents/skills/troubleshooting--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add projectbluefin/finpilot --skill troubleshooting -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install projectbluefin/finpilot troubleshooting --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/projectbluefin/finpilot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/troubleshooting .gemini/skills/troubleshooting && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "troubleshooting" agent skill from https://github.com/projectbluefin/finpilot/tree/main/.agents/skills/troubleshooting into .gemini/skills/troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install projectbluefin/finpilot troubleshootingInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add projectbluefin/finpilot --skill troubleshooting -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/projectbluefin/finpilot.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/troubleshooting .github/skills/troubleshooting && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "troubleshooting" agent skill from https://github.com/projectbluefin/finpilot/tree/main/.agents/skills/troubleshooting into .github/skills/troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add projectbluefin/finpilot --skill troubleshooting -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install projectbluefin/finpilot troubleshooting --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/projectbluefin/finpilot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/troubleshooting .opencode/skills/troubleshooting && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "troubleshooting" agent skill from https://github.com/projectbluefin/finpilot/tree/main/.agents/skills/troubleshooting into .opencode/skills/troubleshooting/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "troubleshooting", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
troubleshooting- GitHub stars
- 126
- Token cost
- ~605 tokens
- SKILL.md length
- 309 words
- Files
- 1
- Skills in repo
- 5
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Symptom to cause to fix for build, CI, and runtime failures, plus the pre-commit checklist.
- Something is broken
- SKILL.md covers Before a pull request, Build, CI and Runtime, plus 1 more section
- Calls just; needs RENOVATE_TOKEN
- Before opening a pull request
What it does
Troubleshooting is an agent skill from projectbluefin/finpilot. Symptom to cause to fix for build, CI, and runtime failures, plus the pre-commit checklist. Use when something is broken or before opening a pull request.
Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Pull requests. The repository describes itself as: Build your own custom Bluefin. The licence is Apache-2.0.
When your agent uses it
- Something is broken
- Before opening a pull request
Example prompts
- “/troubleshooting”
Requirements
- A credential in RENOVATE_TOKEN
What it can do on your machine
Read from SKILL.md and the folder at commit 8e0eb5d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
just
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
RENOVATE_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Troubleshooting loads about 605 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 309 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from projectbluefin/finpilot at commit 8e0eb5d, republished under its Apache-2.0 licence (© projectbluefin). 309 words, ~605 tokens.
Download SKILL.mdSave it as
.claude/skills/troubleshooting/SKILL.md (or your agent's skills folder).- name
- troubleshooting
- description
- Symptom to cause to fix for build, CI, and runtime failures, plus the pre-commit checklist. Use when something is broken or before opening a pull request.
Troubleshooting
Before a pull request
- Conventional Commit message.
-
just lint— shellcheck on every tracked script. -
just check— Justfile syntax. -
just test-unit— the suite. -
just validate-brewfiles/just validate-flatpaksif those changed. -
just buildif the image changed.
CI runs the same checks; running them locally only makes the pull request quiet.
Build
| Symptom | Cause | Fix |
|---|---|---|
bootc container lint fails on a nonempty /run | a script wrote to /run into an image layer | remove it in 90-cleanup.sh; that phase deliberately does not mount /run as tmpfs |
| a third-party repository is live in the final image | a script enabled it and did not disable it | use copr_install_isolated, or disable it explicitly |
| the package layer rebuilds on every overlay edit | packages drifted into the overlay phase | keep packages in 20-packages-and-services.sh |
| hadolint flags the Containerfile | a rule in .github/hadolint.yaml | fix it, or add a suppression with a reason |
CI
| Symptom | Cause | Fix |
|---|---|---|
validate never runs | branch protection names a check no workflow produces | the context must be exactly validate |
| Renovate logs a skip and opens nothing | RENOVATE_TOKEN is not set | expected; set the secret to turn Renovate on |
Renovate fails on Validate RENOVATE_TOKEN | the token is expired or lacks the workflow scope | recreate the token |
| the promotion PR never opens | stable does not exist | create the branch |
| the promotion PR will not merge | stable requires an approval | set required approvals to 0 |
| a Renovate PR waits forever | auto-merge is off | enable it in Settings |
Runtime
The two most common first-boot surprises — no Flatpaks, and no brew — are in
the README's Troubleshooting section.
| Symptom | Cause | Fix |
|---|---|---|
ujust shows no custom commands | 60-custom.just was not written or imported | check that 10-overlay.sh copied the recipes |
Capturing what you learned
When a fix here was non-obvious, put it in the skill that owns the area, in the same pull request. That is the only home for durable learning.
© projectbluefin, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/troubleshooting of projectbluefin/finpilot.
Open the folder on GitHubat commit 8e0eb5d
Compare with similar skills
Troubleshooting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Troubleshooting this skillprojectbluefin/finpilot | 126 | — | ~605 | Automated safety check: Pass | Apache-2.0 | |
| Finishing a Development Branchobra/superpowers | 296k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| PR Babysitteropeninterpreter/openinterpreter | 69k | 3 repos | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Check PRonyx-dot-app/onyx | 32k | 2 repos | ~2.3k | Automated safety check: Pass | MIT | |
| Understand Diff AnalysisEgonex-AI/Understand-Anything | 86k | 1 repos | ~1.4k | Automated safety check: Pass | MIT | |
| PR Design DocOpenHands/OpenHands | 90k | — | ~2.4k | Automated safety check: Pass | MIT |
Similar skills
PR Babysitter
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
Check PR
onyx-dot-app/onyx
Checks a GitHub, GitLab, or Perforce (p4) pull request (or merge request, or shelved changelist) for unresolved review comments, failing status checks, and incomplete PR descriptions.
Understand Diff Analysis
Egonex-AI/Understand-Anything
Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.
PR Design Doc
OpenHands/OpenHands
For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…
WooCommerce Code Review
woocommerce/woocommerce
Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.
More from projectbluefin/finpilot
Customize
projectbluefin/finpilot
Decide where a package, app, or command belongs — dnf5 at build time, Homebrew, Flatpak, or ujust — and how each is validated.
Onboarding
projectbluefin/finpilot
Bootstrap a new image from this template: rename the project, enable Actions and Renovate, protect the branch, and reach a first green build.
CI
projectbluefin/finpilot
GitHub Actions, Renovate, the two-branch release model, signing, and promotion.
Overview
projectbluefin/finpilot
Architecture, repository layout, and file map for this template.
Related
Categories
Questions about Troubleshooting
What does Troubleshooting do?
Symptom to cause to fix for build, CI, and runtime failures, plus the pre-commit checklist. Troubleshooting is an agent skill from projectbluefin/finpilot. Symptom to cause to fix for build, CI, and runtime failures, plus the pre-commit checklist.
When should I use Troubleshooting?
Troubleshooting fits situations like: something is broken; before opening a pull request.
How do I install Troubleshooting in Claude Code?
Run `npx skills add projectbluefin/finpilot --skill troubleshooting -a claude-code`. Or copy the skill folder (.agents/skills/troubleshooting in projectbluefin/finpilot) into .claude/skills/troubleshooting in your project. Claude Code loads it when a task matches its description.
How do I install Troubleshooting in Codex?
Run `npx skills add projectbluefin/finpilot --skill troubleshooting -a codex`. Or copy the skill folder (.agents/skills/troubleshooting in projectbluefin/finpilot) into .agents/skills/troubleshooting in your project. Codex loads it when a task matches its description.
Can I use Troubleshooting in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add projectbluefin/finpilot --skill troubleshooting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/troubleshooting, .gemini/skills/troubleshooting, .github/skills/troubleshooting and .opencode/skills/troubleshooting in your project.
What does Troubleshooting need to run?
Going by SKILL.md and its folder, Troubleshooting needs the command-line tools its instructions call (just) and credentials named RENOVATE_TOKEN. Our summary lists: A credential in RENOVATE_TOKEN.
Does Troubleshooting access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Troubleshooting safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Troubleshooting use?
Troubleshooting is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Troubleshooting use?
About 605 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Troubleshooting?
Skills that share tags, products or a category with Troubleshooting: Finishing a Development Branch (obra/superpowers, 296k stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars), Check PR (onyx-dot-app/onyx, 32k stars) and Understand Diff Analysis (Egonex-AI/Understand-Anything, 86k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Troubleshooting?
projectbluefin (a GitHub organization) maintains it in projectbluefin/finpilot, which has 126 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 8, 2026.
Source: projectbluefin/finpilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.