Agent skill

P4 Code Review

by perforce in perforce/p4mcp-server

P4 code review workflows — discover, create, vote, comment, transition, and manage reviews via P4 MCP tools.

MITAuto-check passedDevelopment

Install P4 Code Review

skills CLI
$ npx skills add perforce/p4mcp-server --skill p4-code-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install perforce/p4mcp-server p4-code-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/perforce/p4mcp-server.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/p4-code-review .claude/skills/p4-code-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
p4-code-review
GitHub stars
122
Token cost
~1.1k tokens
SKILL.md length
429 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

P4 code review workflows — discover, create, vote, comment, transition, and manage reviews via P4 MCP tools.

  • Works in 4 steps: modify_changelists → create a pending… → modify_shelves → shelve the changelist → modify_reviews → create a review from… → …
  • : creating reviews
  • SKILL.md covers Querying Reviews, Modifying Reviews, Common Workflows and Best Practices
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

P4 Code Review is an agent skill from perforce/p4mcp-server. P4 code review workflows — discover, create, vote, comment, transition, and manage reviews via P4 MCP tools. Use when: creating reviews, voting, commenting, transitioning review states, managing participants, or tracking review activity in P4.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Code review and MCP servers. It works with Model Context Protocol. The repository describes itself as: [Community Supported] Perforce P4 MCP Server is a Model Context Protocol (MCP) server that integrates with the Perforce P4 version control system. The licence is MIT.

When your agent uses it

  • : creating reviews
  • Transitioning review states
  • Managing participants
  • Tracking review activity in P4

Example prompts

  • “/p4-code-review”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. modify_changelists → create a pending changelist with your edits
  2. modify_shelves → shelve the changelist
  3. modify_reviews → create a review from the changelist
  4. modify_reviews → append_participants to add reviewers

What it can do on your machine

Read from SKILL.md and the folder at commit a8b284d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

P4 Code Review loads about 1.1k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 429 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from perforce/p4mcp-server at commit a8b284d, republished under its MIT licence (© perforce). 429 words, ~1,102 tokens.

Download SKILL.mdSave it as .claude/skills/p4-code-review/SKILL.md (or your agent's skills folder).
name
p4-code-review
description
P4 code review workflows — discover, create, vote, comment, transition, and manage reviews via P4 MCP tools. Use when: creating reviews, voting, commenting, transitioning review states, managing participants, or tracking review activity in P4.

Code Review Workflows

Use the query_reviews and modify_reviews tools to manage P4 Code Review code reviews.

Querying Reviews

ActionPurposeKey Parameters
listList reviews with filtersreview_fields, max_results
dashboardGet review dashboard for current user—
getGet full review detailsreview_id
transitionsGet available state transitionsreview_id
filesList files in a reviewreview_id
files_readbyCheck which files have been read by reviewersreview_id
commentsGet all comments on a reviewreview_id
activityGet review activity logreview_id

Modifying Reviews

Lifecycle
ActionPurposeKey Parameters
createCreate a new review from a changelistchange_id, description
transitionMove review to a new statereview_id, transition
archive_inactiveArchive stale reviewsnot_updated_since, max_reviews
obliteratePermanently remove a review (requires approval)review_id
Voting & Participation
ActionPurposeKey Parameters
voteVote on a review (up/down/clear)review_id, vote_value
append_participantsAdd reviewersreview_id, users, groups
replace_participantsReplace all reviewersreview_id, users, groups
delete_participantsRemove reviewersreview_id, users, groups
joinJoin a review as participantreview_id
leaveLeave a reviewreview_id
Comments
ActionPurposeKey Parameters
add_commentAdd a new commentreview_id, body, context
reply_commentReply to an existing commentreview_id, comment_id, body
mark_comment_readMark a comment as readreview_id, comment_id
mark_comment_unreadMark a comment as unreadreview_id, comment_id
mark_all_comments_readMark all comments as readreview_id
mark_all_comments_unreadMark all comments as unreadreview_id
Changelist Management
ActionPurposeKey Parameters
append_changeAdd a changelist to a reviewreview_id, change_id
replace_with_changeReplace review content with a new changelistreview_id, change_id
Metadata
ActionPurposeKey Parameters
update_authorChange the review authorreview_id, new_author
update_descriptionUpdate review descriptionreview_id, new_description
refresh_projectsRefresh project associationsreview_id
Show full SKILL.md (165 more words)Show less

Common Workflows

Submit code for review
  1. modify_changelists → create a pending changelist with your edits
  2. modify_shelves → shelve the changelist
  3. modify_reviews → create a review from the changelist
  4. modify_reviews → append_participants to add reviewers
Review code
  1. query_reviews → dashboard to see reviews assigned to you
  2. query_reviews → get to see review details
  3. query_reviews → files to see changed files
  4. query_reviews → comments to see existing discussion
  5. modify_reviews → add_comment to provide feedback
  6. modify_reviews → vote to approve or request changes
  7. query_reviews → transitions to see available state changes
  8. modify_reviews → transition to approve/reject
Update a review
  1. Make edits and shelve the updated changelist
  2. modify_reviews → replace_with_change to update review content
  3. Review comments and address feedback

Best Practices

  • Check transitions before calling transition to verify the target state is valid.
  • Use files_readby to track which reviewers have seen the latest changes.
  • Always shelve changes before creating a review so reviewers can see the diff.
  • Use append_participants rather than replace_participants to avoid removing existing reviewers.

© perforce, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/p4-code-review of perforce/p4mcp-server.

Open the folder on GitHubat commit a8b284d

Compare with similar skills

P4 Code Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

P4 Code Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
P4 Code Review this skillperforce/p4mcp-server122—~1.1kAutomated safety check: PassMIT
Code Reviewimbenrabi/Financial-Modeling-Prep-MCP-Server150—~2.6kAutomated safety check: PassApache-2.0
Code Reviewsbroenne/mcp-windows106—~1.6kAutomated safety check: PassMIT
Code Reviewoaslananka/kicad-mcp-pro120—~3.9kAutomated safety check: PassMIT
Analyze Logsactivepieces/activepieces25k1 repos~1.6kAutomated safety check: PassMIT
ReleasePrefectHQ/fastmcp28k—~2.9kAutomated safety check: PassApache-2.0

Similar skills

  • Code Review

    imbenrabi/Financial-Modeling-Prep-MCP-Server

    Review a PR or working diff against this repo's intent layer (the AGENTS.md hierarchy), toolception pitfalls, and core invariants.

    150 GitHub stars~2.6k tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • Code Review

    sbroenne/mcp-windows

    Review pull requests in mcp-windows for concrete bugs in MCP and CLI contracts, Windows UI automation, element identity, snapshots, bounded searches, and service lifetime.

    106 GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Code Review

    oaslananka/kicad-mcp-pro

    A skill your agent uses for GitHub Copilot pull request and code reviews in oaslananka/kicad-mcp-pro.

    120 GitHub stars~3.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Analyze Logs

    activepieces/activepieces

    Analyze application logs from the .evlog/logs/ directory. An agent skill from activepieces/activepieces.

    25k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Release

    PrefectHQ/fastmcp

    Cut a FastMCP release end to end. An agent skill from PrefectHQ/fastmcp.

    28k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • LangBot Plugin Development

    langbot-app/LangBot

    Guides building, debugging and testing LangBot plugins: components, SDK calls, README and locale rules, SDK pitfalls and WebSocket-based testing.

    18k GitHub stars~3.9k tokensUpdated today
    DevelopmentAuto-check passed

More from perforce/p4mcp-server

  • P4 Dam Workflows

    perforce/p4mcp-server

    P4 DAM (Digital Asset Management) workflows — search, browse, tag, review, and manage digital assets via P4 MCP tools.

    122 GitHub stars~4.1k tokensUpdated 12 days ago
    Auto-check passed
  • P4 Changelist Management

    perforce/p4mcp-server

    P4 changelist workflows — create, list, submit, shelve, unshelve, and manage changelists and shelved files via P4 MCP tools.

    122 GitHub stars~848 tokensUpdated 12 days ago
    Auto-check passed
  • P4 File Operations

    perforce/p4mcp-server

    P4 file operations — query content, history, annotations, diffs, and modify files (add, edit, delete, move, sync, resolve) via P4 MCP tools.

    122 GitHub stars~930 tokensUpdated 12 days ago
    Auto-check passed
  • P4 Stream Workflows

    perforce/p4mcp-server

    P4 stream workflows — creation, branching, merging, copying, integration, switching, and spec management via P4 MCP tools.

    122 GitHub stars~1.1k tokensUpdated 12 days ago
    Auto-check passed
  • P4 Workspace Setup

    perforce/p4mcp-server

    P4 workspace setup and management — create, configure, sync, and switch workspaces via P4 MCP tools.

    122 GitHub stars~581 tokensUpdated 12 days ago
    Auto-check passed

Categories

Questions about P4 Code Review

What does P4 Code Review do?

P4 code review workflows — discover, create, vote, comment, transition, and manage reviews via P4 MCP tools. P4 Code Review is an agent skill from perforce/p4mcp-server. P4 code review workflows — discover, create, vote, comment, transition, and manage reviews via P4 MCP tools.

When should I use P4 Code Review?

P4 Code Review fits situations like: : creating reviews; transitioning review states; managing participants; tracking review activity in P4.

How do I install P4 Code Review in Claude Code?

Run `npx skills add perforce/p4mcp-server --skill p4-code-review -a claude-code`. Or copy the skill folder (skills/p4-code-review in perforce/p4mcp-server) into .claude/skills/p4-code-review in your project. Claude Code loads it when a task matches its description.

How do I install P4 Code Review in Codex?

Run `npx skills add perforce/p4mcp-server --skill p4-code-review -a codex`. Or copy the skill folder (skills/p4-code-review in perforce/p4mcp-server) into .agents/skills/p4-code-review in your project. Codex loads it when a task matches its description.

Can I use P4 Code Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add perforce/p4mcp-server --skill p4-code-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/p4-code-review, .gemini/skills/p4-code-review, .github/skills/p4-code-review and .opencode/skills/p4-code-review in your project.

What does P4 Code Review need to run?

SKILL.md names no scripts, command-line tools or credentials: P4 Code Review is instructions for the agent only.

Does P4 Code Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is P4 Code Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does P4 Code Review use?

P4 Code Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does P4 Code Review use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to P4 Code Review?

Skills that share tags, products or a category with P4 Code Review: Code Review (imbenrabi/Financial-Modeling-Prep-MCP-Server, 150 stars), Code Review (sbroenne/mcp-windows, 106 stars), Code Review (oaslananka/kicad-mcp-pro, 120 stars) and Analyze Logs (activepieces/activepieces, 25k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains P4 Code Review?

perforce (a GitHub organization) maintains it in perforce/p4mcp-server, which has 122 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on September 25, 2026.

Source: perforce/p4mcp-server on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.