PR Fix

VerifiedCaution

Address all outstanding issues on a GitHub Pull Request by handling review comments and failing CI checks.

Sby Skills Guide Bot
DevelopmentIntermediate
7/26/2026
Claude Code
#pull-request#code-review#ci-fixes#github#automation

Recommended for

Automated summary

This skill orchestrates the full cleanup of an open GitHub pull request by handling review comments and failing CI checks, then committing and pushing the fixes.

Strengths

  • Chains three sub-skills (comments, CI, push) in an explicit order and enforces progress tracking through the TaskCreate and TaskUpdate tools
  • Relies on rules/product-principles.md to settle ambiguous feedback autonomously and escalates only genuinely undecidable cases
  • Posts a structured summary comment on the PR with a success or failure header and verbose details collapsed in <details> tags
  • Handles errors explicitly: a failed gh pr comment is logged as a warning and does not invalidate fixes that already landed

Limitations

  • Fully dependent on the existence of the /dyad:pr-fix:comments, /dyad:pr-fix:ci and /dyad:pr-push sub-skills plus the rules/product-principles.md file
  • Requires a working gh CLI authentication and, for the workflow run link, GitHub Actions environment variables
When to use it

Reach for it when a PR has both unresolved review comments and failing CI checks that you want handled in a single automated pass.

When not to use it

Avoid it on PRs where the design disagreements go beyond the team's product principles, or when the required sub-skills and principles file are not present in the repository.

Security analysis

Caution
Quality score85/100

The skill orchestrates code fixes, commit/push, and PR commenting. While these are legitimate PR maintenance actions, they involve powerful operations (repository mutation, authenticated GitHub API calls) that warrant caution. No destructive or exfiltrating instructions were found.

Findings
  • •Instructs committing and pushing code changes automatically, which is a powerful, irreversible action if misused.
  • •Uses `gh pr comment` to post to GitHub, requiring authenticated access and network operations.
  • •Relies on sub-skills that may execute code modifications and test/lint commands, potentially affecting the repository.
How this analysis is made

Examples

Fix a specific PR
/dyad:pr-fix 482
Fix the current branch's PR
Run the PR fix workflow on my current branch and address all review comments and failing CI checks.
Fix by URL
/dyad:pr-fix https://github.com/dyad-sh/dyad/pull/1234

name: dyad:pr-fix description: Address all outstanding issues on a GitHub Pull Request by handling both review comments and failing CI checks.

PR Fix

Address all outstanding issues on a GitHub Pull Request by handling both review comments and failing CI checks.

Arguments

  • $ARGUMENTS: Optional PR number or URL. If not provided, uses the current branch's PR.

Task Tracking

You MUST use the TaskCreate and TaskUpdate tools to track your progress. At the start, create tasks for each step below. Mark each task as in_progress when you start it and completed when you finish. This ensures you complete ALL steps.

Product Principles

When making decisions about review comments, consult rules/product-principles.md. Use these principles to resolve ambiguous or subjective feedback autonomously. Only flag issues for human attention when the product principles do not provide enough guidance to make a decision.

Instructions

This is a meta-skill that orchestrates two sub-skills to comprehensively fix PR issues.

  1. Run /dyad:pr-fix:comments to handle all unresolved review comments:

    • Address valid code review concerns
    • Resolve invalid concerns with explanations
    • Use product principles to resolve ambiguous feedback autonomously
    • Only flag issues for human attention when product principles are insufficient to decide
  2. Run /dyad:pr-fix:ci to handle failing CI checks from the latest PR run:

    • Fix failing tests (unit and E2E)
    • Update snapshots if needed
    • Ensure all checks pass
  3. Run /dyad:pr-push to commit and push all changes:

    • This step is REQUIRED. Do NOT skip it or stop before it completes.
    • It will commit changes, run lint/tests, and push to GitHub.
    • Wait for it to finish and verify the push succeeded.
  4. Post Summary Comment: After both sub-skills complete, post a comment on the PR with a consolidated summary using gh pr comment. The comment should include:

    • A header indicating success (✅) or failure (❌)
    • Review comments addressed, resolved, or flagged
    • CI checks that were fixed
    • Any remaining issues requiring human attention
    • Use <details> tags to collapse verbose details (e.g., full error messages, lengthy explanations)
    • If there were any errors, include specific error messages in the collapsed details

    Error handling: If gh pr comment fails (e.g., due to network issues, rate limits, or permissions), log a warning but do not fail the entire skill if the underlying fixes were successful. The comment is informational and should not block a successful run.

    Example formats:

    Success:

    ## ✅ Claude Code completed successfully
    
    ### Summary
    - Fixed 2 review comments
    - Resolved 1 CI failure (lint error in `src/foo.ts`)
    
    <details>
    <summary>Details</summary>
    
    ... detailed information here ...
    
    </details>
    
    ---
    [Workflow run](https://github.com/dyad-sh/dyad/actions/runs/12345678)
    

    Failure:

    ## ❌ Claude Code failed
    
    ### Summary
    - Attempted to fix 2 review comments
    - Failed to resolve 1 CI failure (lint error in `src/foo.ts`)
    
    <details>
    <summary>Error Details</summary>
    
    **Error:** `lint` command failed with exit code 1.
    
    

    ... linter output ...

    
    </details>
    
    ---
    [Workflow run](https://github.com/dyad-sh/dyad/actions/runs/12345678)
    

    Note: Include a link to the workflow run at the end. If the GITHUB_REPOSITORY and GITHUB_RUN_ID environment variables are available, use them to construct the URL: https://github.com/$GITHUB_REPOSITORY/actions/runs/$GITHUB_RUN_ID. If these environment variables are not set, omit the workflow run link.

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/pr-fix-ms1aw5kg/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/pr-fix-ms1aw5kg' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/pr-fix-ms1aw5kg/download' --output '.skill-downloads/pr-fix-ms1aw5kg/SKILL.md.part' && mv '.skill-downloads/pr-fix-ms1aw5kg/SKILL.md.part' '.skill-downloads/pr-fix-ms1aw5kg/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

No recognized prerequisites section in this file. This does not mean it is self-contained: libraries, tools and access requirements may be mentioned elsewhere in the content or source repository.

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

This file does not provide a usable name/description header for this native procedure. It remains available to download and inspect; use the manual method below.

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/pr-fix-ms1aw5kg/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills