MCP Server Builder
anthropics/skills
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
P4 file operations — query content, history, annotations, diffs, and modify files (add, edit, delete, move, sync, resolve) via P4 MCP tools.
Install P4 File Operations
$ npx skills add perforce/p4mcp-server --skill p4-file-operations -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install perforce/p4mcp-server p4-file-operations --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/perforce/p4mcp-server.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/p4-file-operations .claude/skills/p4-file-operations && rm -rf skills-srcUse ~/.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/
Install the "p4-file-operations" agent skill from https://github.com/perforce/p4mcp-server/tree/main/skills/p4-file-operations into .claude/skills/p4-file-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "p4-file-operations", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/perforce/p4mcp-server/tree/main/skills/p4-file-operationsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add perforce/p4mcp-server --skill p4-file-operations -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install perforce/p4mcp-server p4-file-operations --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/perforce/p4mcp-server.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/p4-file-operations .agents/skills/p4-file-operations && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "p4-file-operations" agent skill from https://github.com/perforce/p4mcp-server/tree/main/skills/p4-file-operations into .agents/skills/p4-file-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "p4-file-operations", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add perforce/p4mcp-server --skill p4-file-operations -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install perforce/p4mcp-server p4-file-operations --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/perforce/p4mcp-server.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/p4-file-operations .cursor/skills/p4-file-operations && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "p4-file-operations" agent skill from https://github.com/perforce/p4mcp-server/tree/main/skills/p4-file-operations into .cursor/skills/p4-file-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "p4-file-operations", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/perforce/p4mcp-server.git --path skills/p4-file-operations--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add perforce/p4mcp-server --skill p4-file-operations -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install perforce/p4mcp-server p4-file-operations --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/perforce/p4mcp-server.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/p4-file-operations .gemini/skills/p4-file-operations && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "p4-file-operations" agent skill from https://github.com/perforce/p4mcp-server/tree/main/skills/p4-file-operations into .gemini/skills/p4-file-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "p4-file-operations", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install perforce/p4mcp-server p4-file-operationsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add perforce/p4mcp-server --skill p4-file-operations -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/perforce/p4mcp-server.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/p4-file-operations .github/skills/p4-file-operations && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "p4-file-operations" agent skill from https://github.com/perforce/p4mcp-server/tree/main/skills/p4-file-operations into .github/skills/p4-file-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "p4-file-operations", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add perforce/p4mcp-server --skill p4-file-operations -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install perforce/p4mcp-server p4-file-operations --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/perforce/p4mcp-server.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/p4-file-operations .opencode/skills/p4-file-operations && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "p4-file-operations" agent skill from https://github.com/perforce/p4mcp-server/tree/main/skills/p4-file-operations into .opencode/skills/p4-file-operations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "p4-file-operations", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
p4-file-operations- GitHub stars
- 122
- Token cost
- ~930 tokens
- SKILL.md length
- 423 words
- Files
- 1
- Skills in repo
- 6
- Repo updated
- First seen
- Licence
- MIT
At a glance
P4 file operations — query content, history, annotations, diffs, and modify files (add, edit, delete, move, sync, resolve) via P4 MCP tools.
- Works in 4 steps: modify_changelists → create a pending… → modify_files → edit to open the file in… → Make your changes locally → …
- : reading file content
- SKILL.md covers Querying Files, Modifying Files, Common Workflows and Best Practices
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
P4 File Operations is an agent skill from perforce/p4mcp-server. P4 file operations — query content, history, annotations, diffs, and modify files (add, edit, delete, move, sync, resolve) via P4 MCP tools. Use when: reading file content, viewing history, comparing revisions, adding or editing files, syncing, resolving conflicts, or reconciling workspace changes in P4.
Its SKILL.md is about 930 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 Agent Workflows, covering 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
- : reading file content
- Viewing history
- Comparing revisions
- Resolving conflicts
Example prompts
- “/p4-file-operations”
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- modify_changelists → create a pending changelist
- modify_files → edit to open the file in the changelist
- Make your changes locally
- modify_changelists → submit to commit
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 File Operations loads about 930 tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 423 words of instructions outside code blocks.
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). 423 words, ~930 tokens.
Download SKILL.mdSave it as
.claude/skills/p4-file-operations/SKILL.md (or your agent's skills folder).- name
- p4-file-operations
- description
- P4 file operations — query content, history, annotations, diffs, and modify files (add, edit, delete, move, sync, resolve) via P4 MCP tools. Use when: reading file content, viewing history, comparing revisions, adding or editing files, syncing, resolving conflicts, or reconciling workspace changes in P4.
File Operations
Use the query_files and modify_files tools to work with files in P4 depots.
Querying Files
| Action | Purpose | Key Parameters |
|---|---|---|
content | Get file content at a revision | file_path |
history | Get revision history (filelog) | file_path, max_results |
info | Get file metadata (type, size, head revision) | file_path |
metadata | Get extended file metadata | file_path |
diff | Compare file revisions or depot vs workspace | file_path, file2, diff2 |
annotations | Get per-line blame/annotation | file_path |
search | Search for files by name pattern (wildcard) | file_path, pattern, max_results |
grep | Search for files by content pattern | file_path, pattern, case_insensitive, max_results |
Modifying Files
| Action | Purpose | Key Parameters |
|---|---|---|
add | Mark a new file for add | file_paths, changelist |
edit | Open an existing file for edit | file_paths, changelist |
delete | Mark a file for delete (requires approval) | file_paths, changelist |
move | Move/rename a file | source_paths, target_paths, changelist |
revert | Revert opened files to depot version | file_paths |
reconcile | Reconcile workspace with depot (detect offline edits) | file_paths |
resolve | Resolve file conflicts after integration | file_paths, mode |
sync | Sync files from depot to workspace | file_paths, force |
Common Workflows
Edit and submit a file
modify_changelists→createa pending changelistmodify_files→editto open the file in the changelist- Make your changes locally
modify_changelists→submitto commit
Add new files
modify_changelists→createa pending changelist- Create the file(s) locally in your workspace
modify_files→addto mark them for addmodify_changelists→submit
Investigate file history
query_files→historyto see revision logquery_files→diffto compare specific revisionsquery_files→annotationsto see per-line authorshipquery_files→contentto read a specific revision
Show full SKILL.md (166 more words)Show less
Find files by name or content
query_files→searchwith a wildcard pattern (e.g.,*.py) to find files by namequery_files→grepwith a text pattern to find files containing specific content- Use
query_files→contentto read files found from search results
Sync and resolve conflicts
modify_files→syncto get latest from depot- If conflicts exist,
modify_files→resolveto handle them modify_changelists→submitwhen resolved
Reconcile offline edits
- Make changes outside of P4 (e.g., IDE edits without opening files first)
modify_files→reconcileto detect and open changed files
Best Practices
- Always open files for
editbefore modifying them so changes are tracked. - Use
reconcileif you forgot to open files first — it detects offline edits, adds, and deletes. - Use
diffto verify changes before submitting. - Use
annotationsto understand who last changed each line (useful for debugging). - Specify
changelistwhen opening files to keep changes organized. - When moving files, both source and target must be in the same changelist.
© 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-file-operations of perforce/p4mcp-server.
Open the folder on GitHubat commit a8b284d
Compare with similar skills
P4 File Operations 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| P4 File Operations this skillperforce/p4mcp-server | 122 | — | ~930 | Automated safety check: Pass | MIT | |
| MCP Server Builderanthropics/skills | 180k | 64 repos | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| MCP Server BuildershareAI-lab/learn-claude-code | 78k | 5 repos | ~1.2k | Automated safety check: Pass | MIT | |
| MCP Integration for Pluginsanthropics/claude-plugins-official | 38k | 11 repos | ~3.1k | Automated safety check: Pass | Apache-2.0 | |
| Fastmcp Client CLIPrefectHQ/fastmcp | 28k | 1 repos | ~823 | Automated safety check: Pass | Apache-2.0 | |
| Crush Configurationcharmbracelet/crush | 29k | — | ~3.7k | Automated safety check: Pass | Custom licence |
Similar skills
- Official
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
- Official
MCP Integration for Plugins
anthropics/claude-plugins-official
Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.
Fastmcp Client CLI
PrefectHQ/fastmcp
Query and invoke tools on MCP servers using fastmcp list and fastmcp call.
Crush Configuration
charmbracelet/crush
Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.
Context Mode Output Sandbox
mksglu/context-mode
Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.
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.
P4 Changelist Management
perforce/p4mcp-server
P4 changelist workflows — create, list, submit, shelve, unshelve, and manage changelists and shelved files via P4 MCP tools.
P4 Code Review
perforce/p4mcp-server
P4 code review workflows — discover, create, vote, comment, transition, and manage reviews via P4 MCP tools.
P4 Stream Workflows
perforce/p4mcp-server
P4 stream workflows — creation, branching, merging, copying, integration, switching, and spec management via P4 MCP tools.
P4 Workspace Setup
perforce/p4mcp-server
P4 workspace setup and management — create, configure, sync, and switch workspaces via P4 MCP tools.
Related
Works with
Categories
Questions about P4 File Operations
What does P4 File Operations do?
P4 file operations — query content, history, annotations, diffs, and modify files (add, edit, delete, move, sync, resolve) via P4 MCP tools. P4 File Operations is an agent skill from perforce/p4mcp-server. P4 file operations — query content, history, annotations, diffs, and modify files (add, edit, delete, move, sync, resolve) via P4 MCP tools.
When should I use P4 File Operations?
P4 File Operations fits situations like: : reading file content; viewing history; comparing revisions; resolving conflicts.
How do I install P4 File Operations in Claude Code?
Run `npx skills add perforce/p4mcp-server --skill p4-file-operations -a claude-code`. Or copy the skill folder (skills/p4-file-operations in perforce/p4mcp-server) into .claude/skills/p4-file-operations in your project. Claude Code loads it when a task matches its description.
How do I install P4 File Operations in Codex?
Run `npx skills add perforce/p4mcp-server --skill p4-file-operations -a codex`. Or copy the skill folder (skills/p4-file-operations in perforce/p4mcp-server) into .agents/skills/p4-file-operations in your project. Codex loads it when a task matches its description.
Can I use P4 File Operations 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-file-operations -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-file-operations, .gemini/skills/p4-file-operations, .github/skills/p4-file-operations and .opencode/skills/p4-file-operations in your project.
What does P4 File Operations need to run?
SKILL.md names no scripts, command-line tools or credentials: P4 File Operations is instructions for the agent only.
Does P4 File Operations 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 File Operations 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 File Operations use?
P4 File Operations 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 File Operations use?
About 930 tokens (SKILL.md is roughly 3.7k 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 File Operations?
Skills that share tags, products or a category with P4 File Operations: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Fastmcp Client CLI (PrefectHQ/fastmcp, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains P4 File Operations?
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.