Agent skill

P4 Stream Workflows

by perforce in perforce/p4mcp-server

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

MITAuto-check passedAgent Workflows

Install P4 Stream Workflows

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

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

GitHub CLI
$ gh skill install perforce/p4mcp-server p4-stream-workflows --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-stream-workflows .claude/skills/p4-stream-workflows && 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-stream-workflows
GitHub stars
122
Token cost
~1.1k tokens
SKILL.md length
441 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 3 steps: modify_streams → create a new… → modify_streams → populate to seed the… → modify_streams → create_workspace bound…
  • : creating streams
  • SKILL.md covers Querying Streams, Modifying Streams, Stream Propagation (Branching… and Common Workflows, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

P4 Stream Workflows is an agent skill from perforce/p4mcp-server. P4 stream workflows — creation, branching, merging, copying, integration, switching, and spec management via P4 MCP tools. Use when: creating streams, branching, merging, copying between streams, integrating changes, switching workspaces, or managing stream specs 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 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

  • : creating streams
  • Copying between streams
  • Integrating changes
  • Switching workspaces

Example prompts

  • “/p4-stream-workflows”

Workflow steps

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

  1. modify_streams → create a new development stream with parent = mainline
  2. modify_streams → populate to seed the new stream with parent files
  3. modify_streams → create_workspace bound to the new stream

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 Stream Workflows loads about 1.1k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 441 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
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). 441 words, ~1,084 tokens.

Download SKILL.mdSave it as .claude/skills/p4-stream-workflows/SKILL.md (or your agent's skills folder).
name
p4-stream-workflows
description
P4 stream workflows — creation, branching, merging, copying, integration, switching, and spec management via P4 MCP tools. Use when: creating streams, branching, merging, copying between streams, integrating changes, switching workspaces, or managing stream specs in P4.

Stream Workflows

Use the query_streams and modify_streams tools to manage P4 streams.

Querying Streams

ActionPurposeKey Parameters
listList streams under a depot pathstream_path, filter, fields, max_results
getGet a single stream specstream_name
childrenList child streamsstream_name
parentGet parent streamstream_name
graphGet full stream hierarchystream_path
integration_statusCheck pending integrations between stream and parentstream_name, both_directions, force_refresh
get_workspaceGet workspace bound to a streamstream_name, workspace
list_workspacesList all workspaces for a streamstream_name, user
validate_fileCheck if a file path is valid in a streamstream_name, file_paths, workspace
validate_submitVerify a changelist is ready to submit in stream contextworkspace, changelist
check_resolveCheck if resolve is needed after integrationstream_name
interchangesList changes not yet integrated between stream and parentstream_name, reverse, limit

Modifying Streams

ActionPurposeKey Parameters
createCreate a new streamstream_name, stream_type, parent, description
updateUpdate stream spec fieldsstream_name, updated fields
deleteDelete a stream (requires approval)stream_name
edit_specOpen stream spec for editingstream_name, changelist
resolve_specResolve spec conflictsstream_name, resolve_mode
revert_specRevert spec changesstream_name
shelve_specShelve stream spec changesstream_name, changelist
unshelve_specUnshelve stream spec changesstream_name, target_changelist

Stream Propagation (Branching & Merging)

ActionPurposeKey Parameters
copyCopy changes between parent/child streamsstream_name, changelist, parent_stream
mergeMerge changes between parent/child streamsstream_name, changelist, parent_stream
integrateIntegrate with custom source/target (advanced)stream_name, changelist, parent_stream
populateSeed a new stream with files from parentstream_name
switchSwitch a workspace to a different streamstream_name, workspace
create_workspaceCreate a workspace bound to a streamstream_name, workspace_name, root

Common Workflows

Show full SKILL.md (180 more words)Show less
Create a feature branch
  1. modify_streams → create a new development stream with parent = mainline
  2. modify_streams → populate to seed the new stream with parent files
  3. modify_streams → create_workspace bound to the new stream
Propagate changes to main
  1. query_streams → interchanges to see what hasn't been merged yet
  2. query_streams → integration_status to check current state
  3. modify_streams → copy from child to parent (copies up)
  4. query_streams → check_resolve to see if resolves are needed
  5. modify_streams → resolve_spec if needed
Merge from parent to child
  1. query_streams → interchanges to see pending changes
  2. modify_streams → merge from parent to child (merges down)
  3. Resolve any conflicts
Switch workspace streams
  1. query_streams → list_workspaces to find existing workspaces
  2. modify_streams → switch the workspace to the target stream

Best Practices

  • Always check interchanges before merging or copying to understand what will be propagated.
  • Use copy for upward propagation (child → parent) and merge for downward (parent → child).
  • Use validate_submit before submitting to catch stream-related issues early.
  • Use check_resolve after integration to ensure all conflicts are handled.
  • populate should only be used once when seeding a newly created stream.

© 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-stream-workflows of perforce/p4mcp-server.

Open the folder on GitHubat commit a8b284d

Compare with similar skills

P4 Stream Workflows 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 Stream Workflows compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
P4 Stream Workflows this skillperforce/p4mcp-server122—~1.1kAutomated safety check: PassMIT
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
PicoClaw Agentsipeed/picoclaw30k—~7.2kAutomated safety check: NotesMIT
Chatgpt AppsHaohao-end/openagent8071 repos~4.9kAutomated safety check: PassApache-2.0
Chatgpt App Builderalpic-ai/skybridge2.1k—~1kAutomated safety check: PassMIT
Agent Setup Health Audittw93/Waza7.2k—~5.2kAutomated safety check: NotesMIT

Similar skills

  • 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.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • PicoClaw Agent

    sipeed/picoclaw

    Answers questions about running and changing PicoClaw, from onboarding and model selection to MCP server setup, skill loading and scheduled jobs.

    30k GitHub stars~7.2k tokensUpdated 13 days ago
    Agent WorkflowsAuto-check: notes
  • Chatgpt Apps

    Haohao-end/openagent

    Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI.

    807 GitHub starsUsed in 1 repo~4.9k tokens
    Agent WorkflowsAuto-check passed
  • Chatgpt App Builder

    alpic-ai/skybridge

    Guide developers through creating and updating ChatGPT plugins.

    2.1k GitHub stars~1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Audits a project's agent configuration, instruction drift, hooks, MCP and AI maintainability, then reports prioritized findings with evidence and next actions.

    7.2k GitHub stars~5.2k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Record Demo

    apify/mcpc

    Official

    Record or regenerate the mcpc demo GIFs (the README hero docs/images/mcpc-demo.gif and the focused tapes in docs/vhs/) with VHS.

    981 GitHub stars~3.3k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

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 Code Review

    perforce/p4mcp-server

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

    122 GitHub stars~1.1k 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 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

Questions about P4 Stream Workflows

What does P4 Stream Workflows do?

P4 stream workflows — creation, branching, merging, copying, integration, switching, and spec management via P4 MCP tools. P4 Stream Workflows is an agent skill from perforce/p4mcp-server. P4 stream workflows — creation, branching, merging, copying, integration, switching, and spec management via P4 MCP tools.

When should I use P4 Stream Workflows?

P4 Stream Workflows fits situations like: : creating streams; copying between streams; integrating changes; switching workspaces.

How do I install P4 Stream Workflows in Claude Code?

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

How do I install P4 Stream Workflows in Codex?

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

Can I use P4 Stream Workflows 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-stream-workflows -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-stream-workflows, .gemini/skills/p4-stream-workflows, .github/skills/p4-stream-workflows and .opencode/skills/p4-stream-workflows in your project.

What does P4 Stream Workflows need to run?

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

Does P4 Stream Workflows 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 Stream Workflows 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 Stream Workflows use?

P4 Stream Workflows 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 Stream Workflows use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Stream Workflows?

Skills that share tags, products or a category with P4 Stream Workflows: Crush Configuration (charmbracelet/crush, 29k stars), PicoClaw Agent (sipeed/picoclaw, 30k stars), Chatgpt Apps (Haohao-end/openagent, 807 stars) and Chatgpt App Builder (alpic-ai/skybridge, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains P4 Stream Workflows?

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.