# Preparing PR

> Preparing PR is an Agent Skill for development published in the flutter/devtools repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Prepare a pull request by running presubmit with fixes. Use when preparing to commit or send a PR.

- Skill name: `preparing-pr`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/flutter/devtools/blob/HEAD/.agents/skills/preparing-pr/SKILL.md
- Repository: flutter/devtools (1,723 GitHub stars when collected)

## SKILL.md

# Preparing a Pull Request

Follow these steps to prepare a pull request for DevTools:

1.  **Verify `dt` configuration**:
    -   Ensure `dt` is available on the path by running `dt --help` or verifying its alias.
    -   If not available, refer to the [CONTRIBUTING guide](../../../CONTRIBUTING.md#L64-L80) for instructions on how to set up the `dt` executable on your path.
2.  **Update Flutter SDK**:
    -   Run `dt update-flutter-sdk` to ensure the SDK is up to date.
3.  **Run Presubmit with Fixes**:
    -   Run `dt presubmit --fix` to address automated fixes.
    -   If any issues remain or if the command fails, fix the issues manually and run `dt presubmit --fix` again to verify the fix.
4.  **Run Tests for Affected Code**:
    -   Use `git status` or `git diff upstream/master` to find changed files.
    -   Run tests that are associated with the changed code. For example, if you edited `packages/devtools_app/lib/src/screens/logging/logging_screen.dart`, run the logging tests under `packages/devtools_app/test/screens/logging/`.

## Verification

If any step fails, stop and address the issue, and then verify the issue is fixed before proceeding.

> [!IMPORTANT]
> Do NOT commit or push changes without getting explicit user approval first.

---

Source: https://www.openparable.com/skill/development/preparing-pr (OpenParable). Cite the canonical URL above.
