fluid-pr

Creates GitHub pull requests following Fluid Framework title and body conventions.

4.9k|585|Updated Aug 22, 2019
One-click install
npx skills add https://github.com/microsoft/FluidFramework --skill fluid-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fluid-pr
Source: https://github.com/microsoft/FluidFramework/tree/main/.claude/skills/fluid-pr
Command: npx skills add https://github.com/microsoft/FluidFramework --skill fluid-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating pull requests in the Fluid Framework repository requires following specific title conventions and body templates, and contributors risk pushing to protected branches or the wrong remote. This Skill automates the PR creation workflow while enforcing those safety checks and conventions.

Core Features & Use Cases

  • Convention-Compliant PR Composition: Loads the fluid-pr-guide skill to generate PR titles and bodies that follow Fluid Framework conventions and templates.
  • Safety Guardrails: Blocks PR creation from protected branches (main, release branches) and prevents pushing directly to the microsoft/FluidFramework remote, with an exception for test/ branches needing Azure Pipelines testing.
  • Interactive Confirmation: Presents the proposed title and body, then asks the user to choose between creating a PR, creating a draft PR, editing, or canceling before pushing.
  • Use Case: A contributor finishes a bug fix on a feature branch and asks the assistant to create a PR; the Skill verifies the branch and remote, drafts a compliant title and body, gets confirmation, pushes the branch, and opens the PR with gh.

Quick Start

Ask the assistant to create a PR for your current branch in the Fluid Framework repo and confirm the proposed title and body when prompted.

Frequently Asked Questions about fluid-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a pull request in the Fluid Framework repo?

Switch to a feature branch, then ask the assistant to create a PR. The Skill composes a title and body following Fluid Framework conventions, asks for your confirmation, pushes the branch, and opens the PR using the gh CLI.

How do I create a draft PR on GitHub from the command line?

Use gh pr create with the --draft flag along with --title and --body. This Skill offers a "Create draft PR" option during its confirmation step, which pushes your branch and opens the pull request as a draft.

Why can't I create a PR from the main branch?

Pull requests must originate from feature branches, not protected branches like main or release branches. The Skill stops and instructs you to create or switch to a feature branch before proceeding.

Can I push a branch directly to microsoft/FluidFramework?

No, contributors should push branches to their own fork rather than the upstream repository. The only exception is branches prefixed with test/ that require Azure Pipelines testing.

How do I update an existing PR description on GitHub?

The Skill cannot edit PRs on the upstream microsoft/FluidFramework repo via the API. It writes the updated title or body to a temporary file so you can copy-paste it into the PR on GitHub manually.