sharpps-pipeline

Registers, runs, inspects, and patches SharpPS.Shells PowerShell pipelines and their processors.

Updated Jul 24, 2026
One-click install
npx skills add https://github.com/gweone/agent-plugins --skill sharpps-pipeline-gweone
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sharpps-pipeline
Source: https://github.com/gweone/agent-plugins/tree/main/plugin/sharpps-dotnet/skills/sharpps-pipeline
Command: npx skills add https://github.com/gweone/agent-plugins --skill sharpps-pipeline-gweone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with the SharpPS.Shells PowerShell module requires knowing its pipeline conventions — folder-per-pipeline registration, numbered processor scripts, the shared $arguments hashtable, and the Update-Pipeline patch workflow — and mistakes can trigger real side effects like deployments, DB migrations, and software installs. ## Core Features & Use Cases - Pipeline execution guidance: Run shipped pipelines (artifact, install, publish, sif, sitecore, startup, traefik) via Start-Pipeline with the correct $arguments hashtable, predecessors, and -Help short-circuit behavior. - Runtime patching: Reshape an already-registered pipeline with Update-Pipeline using Replace, InsertBefore, InsertAfter, MoveTo, or Remove without editing shipped .ps1 files. - Module setup: Register the SharpPSGallery MyGet repository and install the module idempotently, choosing the right PowerShell host (pwsh vs powershell) per platform. - Use Case: You need a Slack notification step after the publish step of the sitecore pipeline. Get the processor with Get-Pipeline, then call Update-Pipeline -Processor $publishStep -Path "C:\custom\01b-NotifySlack.ps1" -Action InsertAfter to splice it in for the session. ## Quick Start Ask the assistant to run the SharpPS sitecore pipeline with a custom PublishUrl argument using pwsh, after confirming the plan and arguments.

Frequently Asked Questions about sharpps-pipeline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a SharpPS pipeline with Start-Pipeline?

Call Start-Pipeline with the pipeline name and a shared arguments hashtable, for example Start-Pipeline sitecore @{ PublishUrl = 'C:\Custom\Path' } -Verbose. Predecessor pipelines run first with the same hashtable, and processors execute in numeric filename order.

How do I patch a registered pipeline without editing the shipped scripts?

Use Update-Pipeline with a Processor object from Get-Pipeline. It supports Replace, InsertBefore, InsertAfter, MoveTo, and Remove actions, mutating the in-memory pipeline for the current session only.

How do I install the SharpPS.Shells PowerShell module?

Register the SharpPSGallery MyGet repository (https://www.myget.org/F/sharpps/api/v2) with InstallationPolicy Trusted, then run Install-Module SharpPS.Shells from that repository. It is not published to PSGallery or nuget.org.

Does SharpPS.Shells work on Linux or macOS?

Yes, the module targets netstandard2.0 and is cross-platform, but only pwsh (PowerShell 7+) exists outside Windows. On Windows both powershell (5.1) and pwsh work, with pwsh preferred.

Why do my pipeline steps get skipped after an early processor runs?

Processors are skipped when $arguments["Aborted"] is set to $true, which the 00-Help.ps1 script does when the Help key is present. Only processors whose filename contains AlwaysRun still execute after an abort.

Do Update-Pipeline changes persist across PowerShell sessions?

No, patches live only in the in-memory Pipeline.Stores dictionary for the current session. To make changes durable, add numbered .ps1 files to the pipeline folder and re-run Register-Pipeline -Force, or re-apply Update-Pipeline from a profile script.