Skip to main content

file-pr: Open a Concise Why-First PR

Files a concise PR after checking no duplicate exists and reviewing the local diff against the base branch.

Source facts

Repository
t3dotgg/tstack
Last source activity
October 24, 2026 at 05:00
Detected SKILL.md language
English
Stars
3,296
Forks
248

Uses

Use when asked to file, open, or create a PR.

Prerequisites

Local branch with the intended diff; follow recent repo title conventions.

How to use

Check for an existing PR, review the diff vs base, write a why-focused title and description, then open.

Limitations

Titles become commit messages—prefer human-readable why over jargon-only how.

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
file-pr
description
File a concise pull request. Use when the user asks to file, open, or create a PR.
# File PR Before filing, check whether a PR for this branch already exists. Review the diff locally against the base branch (usually `origin/main`) to make sure its contents match the goal. PR titles usually become commit messages, so follow the repository's title conventions. Look at recently merged PRs and Git history for examples. Prefer a concise, human-readable title that explains why the change matters: BAD > ❌ perf(server): negotiate permessage-deflate on the websocket GOOD > ✅ perf(server): cut websocket frame size by 70%+ with gzipping Open the description with a simple explanation of the problem based on the user's original prompt, then briefly explain the solution. Do not lead with an implementation inventory: BAD > ❌ Removed implicit workspace carry-over from every "new thread" entry point (cmd+n / cmd+shift+o, sidebar v1/v2 buttons, command palette). New threads inherit only the project from context; branch, worktree, and env mode always come from the configured defaults. Deleted buildContextualThreadOptions, startNewThreadInProjectFromContext, and the v1 sidebar's seed-context machinery. GOOD > ✅ My "new worktree" default was ignored when starting new threads on existing worktrees. Super unintuitive. Now your preferences always apply. End the description with the public model name and harness that made the changes, for example `Created with <model> in <harness>.` Include subagent models that wrote part of the change. Use the model name the harness reports. If model identity is unavailable, name the harness without guessing a model. Before submission, check the title, description, quotes, and attachments for secrets and private details. Open a real PR rather than a draft so review bots run. If `gh pr create` fails because the GraphQL rate limit is used up, open it through REST with `gh api repos/<owner>/<repo>/pulls -f title=... -f head=... -f base=... -F body=@<file>`. If the user also asked to babysit it, continue with the `babysit-pr` skill. Do not post a follow-up PR comment unless it serves the user's request. When a comment is needed, use the `leaving-pr-comments` skill.
View on GitHub