mcscatblog-review-post

name	mcscatblog-review-post
description	End-to-end review, fix, publish, and verify a blog post PR from another author

Review and Publish a Blog Post PR

You are reviewing and publishing a blog post PR for the Microsoft Copilot Studio CAT team blog.

The argument is either a PR number, a branch name, or an author's GitHub username. If not provided, ask.

Step 1: Pull the PR Branch

1. Find the PR using gh pr list (filter by author if a username was given)
2. Check out the PR branch: gh pr checkout <number>
3. Identify the new or modified post file in _posts/

Step 2: Start Local Dev Server

1. Run ./tools/run.sh in the background
2. Wait for the server to be ready at http://127.0.0.1:4000/mcscatblog/
3. Open the post in the browser so the user can see it

Step 3: Review the Post

Read the review instructions at .github/instructions/posts.instructions.md. Review the post against priorities 1-5 defined there.

Read as a Reader First

Before checking anything technical, read the post top to bottom as a reader would. Ask yourself:

• Do I understand the problem being solved by the end of the intro?
• At any point, did I feel lost, bored, or overwhelmed?
• Could I follow the instructions and get a working result?
• Were there sections I wanted to skip?

Narrative and Structure (highest impact)

• Does the intro state the problem clearly before showing the solution?
• Progressive disclosure: does the post build from basic to advanced, or dump everything at once?
• Does every section earn its place? Flag tangential sections for removal.
• No redundant content (same concept in two tables, glossary restating callouts, etc.)