Skip to content
cccskills
FreePublished on GitHub

pr

INVOKE THIS SKILL before creating any PR to ensure compliance with branch naming, changelog requirements, and reviewer assignment.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

ATmosphere PR Workflow

Quick-reference for opening a PR. Full reference: docs/pull-request.md.

Branch Naming

PrefixUse
add/{feature}New feature.
update/{feature}Iterating on an existing feature.
fix/{bug}Bug fix.
try/{idea}Experimental — open as draft.

Reserved: release/{X.Y.Z} (owned by the release script), trunk.

git checkout trunk && git pull origin trunk
git checkout -b fix/something

Required Before Opening

  1. Lint + tests must pass.

    composer lint
    npm run env-test
    
  2. Changelog entry or Skip Changelog label.

    composer changelog:add
    

    Commit the entry on the same branch as the code change. End the message with punctuation. Write for end users — no class names, no internal jargon.

    If neither a changelog entry nor a Skip Changelog label applies, stop and ask the user which they prefer. Don't open the PR with neither.

  3. Code review. Delegate the diff to the code-review agent. Address every critical finding before opening the PR.

Opening the PR

# Create PR (includes required assignment/reviewer).
gh pr create --assignee @me --reviewer Automattic/atmosphere

Copilot is requested as a reviewer automatically by the trunk branch ruleset — don't add it manually.

Use .github/PULL_REQUEST_TEMPLATE.md as-is — don't invent custom formatting. The body must include:

  • Summary explaining why (not just what — the diff covers that).
  • Testing instructions a reviewer can reproduce locally.
  • Screenshots for any visual change (before / after).

Changelog Messages

Write for end users; they appear in the WordPress update screen.

✅ Fix posts not appearing on Bluesky when published via Quick Edit.
✅ Add option to disable standard.site document records.
❌ Refactor Publisher class to handle edge case in applyWrites batch.
❌ Fix TID collision in transformer output.

End with punctuation. Never mention AI tools or coding assistants.

When to Read the Full Docs

Read docs/pull-request.md when you need:

  • The full pre-PR checklist (code preparation, testing, documentation, review).
  • Commit message format (the Type: prefix table).
  • Special situations — Hotfix, Breaking Change, New Feature, Bug Fix, Experimental, Multi-PR Feature checklists.
  • Common review feedback patterns — what reviewers typically ask for and how to respond.
  • Label reference.

Related Skills

  • release — release script, patch releases, GitHub Release UI.
  • dev — running tests, linting, troubleshooting wp-env.
  • code-style — PHP conventions the reviewer will be checking against.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

PHP coding standards and WordPress patterns for ATmosphere plugin. Use when writing PHP code, creating classes, implementing WordPress hooks, or structuring plugin files.

The English summary is being prepared. Showing the original description.

Automattic/wordpress-atmosphere54Updated Oct 19, 2026

dev

Free

Development workflows for WordPress ATmosphere plugin including wp-env setup, testing commands, linting, and build processes. Use when setting up development environment, running tests, checking code quality, or working with wp-env.

The English summary is being prepared. Showing the original description.

Automattic/wordpress-atmosphere54Updated Oct 19, 2026

pr

Free

MUST be invoked before creating any PR, pushing a branch for review, or running `gh pr create`. Covers changelog entries, branch naming, PHPCS/PHPUnit checks, and reviewer assignment.

The English summary is being prepared. Showing the original description.

Automattic/wordpress-atmosphere54Updated Oct 19, 2026

Version management and release processes using Jetpack Changelogger. Use when creating releases, managing changelogs, bumping versions, or preparing releases.

The English summary is being prepared. Showing the original description.

Automattic/wordpress-atmosphere54Updated Oct 19, 2026

test

Free

Testing patterns for PHPUnit tests. Use when writing tests, debugging test failures, setting up test coverage, or implementing test patterns for ATmosphere features.

The English summary is being prepared. Showing the original description.

Automattic/wordpress-atmosphere54Updated Oct 19, 2026

See all skills by Automattic

Report a problem with this skill