Source profileQuality 92/100

WYRE-AI/msp-claude-plugins/msp-claude-plugins/immybot/immybot/skills/software-deployment/SKILL.md

ImmyBot Software Deployment

ImmyBot's desired-state software deployment model end-to-end: the software catalog, deployment, maintenance-session and computer tool surfaces; the canonical select → scope → assert → reconcile → verify workflow; and the pinned-vs-latest, conflicting-deployment, and reboot edge cases.

Source repository stars
42
Declared platforms
0
Static risk flags
0
Last source update
2026-08-28
Source checked
2026-08-28

Decision brief

What it does: where it fits

This is ImmyBot's headline capability. The model is desired-state: you assert what should be installed, then a maintenance session brings the endpoint into compliance. This skill walks the canonical deployment workflow end-to-end.

Best for

    Not for

    • Tasks that require unconfirmed production actions or broad system permissions.
    • Environments where the pinned source and install steps cannot be inspected.

    Compatibility matrix

    Platform support, with evidence labels

    PlatformStatusEvidenceWhat to check
    CodexNot declaredNo explicit evidencePortability before use
    Claude CodeNot declaredNo explicit evidencePortability before use
    CursorNot declaredNo explicit evidencePortability before use
    Gemini CLINot declaredNo explicit evidencePortability before use
    Open the compatibility checker

    Installation

    Inspect first. Install second.

    The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

    Source-detected install commandSource
    npx skills add https://github.com/WYRE-AI/msp-claude-plugins --skill "msp-claude-plugins/immybot/immybot/skills/software-deployment"
    Safe inspection promptEditorial

    Inspect the Agent Skill "ImmyBot Software Deployment" from https://github.com/WYRE-AI/msp-claude-plugins/blob/5005f73ba2f52cd299f58aa6bb79f4e70ae87103/msp-claude-plugins/immybot/immybot/skills/software-deployment/SKILL.md at commit 5005f73ba2f52cd299f58aa6bb79f4e70ae87103. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

    Workflow

    What the source asks the agent to do

    1. 01

      The Canonical Deployment Workflow

      Confirm the software exists in the catalog and what version you intend to deploy.

      Confirm the software exists in the catalog and what version you intend to deploy.For tenant-wide rollouts:Call immybotdeploymentscreate with the chosen software, version, and scope. The deployment now exists, but nothing has happened on the endpoint yet.
    2. 02

      Anti-triggers

      Making the install actually happen — creating a deployment changes

      Making the install actually happen — creating a deployment changesOS and security patching — ImmyBot deploys applications, notA one-off command on one machine — use
    3. 03

      API Tools

      Review the “API Tools” section in the pinned source before continuing.

      Review and apply the “API Tools” source section.
    4. 04

      Discover the catalog

      Review the “Discover the catalog” section in the pinned source before continuing.

      Review and apply the “Discover the catalog” source section.
    5. 05

      Configure desired state

      Review the “Configure desired state” section in the pinned source before continuing.

      Review and apply the “Configure desired state” source section.

    Permission review

    Static risk signals and limitations

    No configured static risk pattern was detected

    This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

    Evidence record

    Why each signal appears

    EvidenceSourceComputedTestedEditorial
    SignalValueEvidence typeMeaning
    Quality score92/100ComputedDocumentation, specificity, maintenance, and trust rules
    Repository stars42SourceRepository attention, not individual Skill quality
    Compatibility0 platformsSourceDeclared in the catalog source record
    Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

    Pinned source

    Provenance and original SKILL.md

    Repository
    WYRE-AI/msp-claude-plugins
    Skill path
    msp-claude-plugins/immybot/immybot/skills/software-deployment/SKILL.md
    Commit
    5005f73ba2f52cd299f58aa6bb79f4e70ae87103
    License
    Apache-2.0
    Collected
    2026-08-28
    Default branch
    main
    View the original SKILL.md

    ImmyBot Software Deployment

    This is ImmyBot's headline capability. The model is desired-state: you assert what should be installed, then a maintenance session brings the endpoint into compliance. This skill walks the canonical deployment workflow end-to-end.

    Anti-triggers

    • Making the install actually happen — creating a deployment changes nothing on any endpoint; the reconciliation run that acts on it is immybot-maintenance-sessions.
    • OS and security patching — ImmyBot deploys applications, not Windows Update. Patch compliance lives in the RMM: superops-assets, syncro-assets, or ncentral-devices.
    • A one-off command on one machine — use immybot-script-execution.
    • Whether a tenant is compliant overall — rollups and scorecards are immybot-tenant-compliance.

    API Tools

    Discover the catalog

    ToolPurpose
    immybot_software_listPer-tenant software catalog
    immybot_software_list_globalGlobal ImmyBot software catalog
    immybot_software_searchSearch by name
    immybot_software_getFull detail for one software
    immybot_software_versionsAvailable versions for a software
    immybot_software_latest_versionThe current "latest" version
    immybot_software_categoriesBrowse by category
    immybot_software_publishersBrowse by publisher
    immybot_software_statsUsage stats across the fleet

    Configure desired state

    ToolPurpose
    immybot_deployments_listCurrent deployments
    immybot_deployments_getDetail for a deployment
    immybot_deployments_createAssert new desired state
    immybot_deployments_for_computerDeployments scoped to a computer
    immybot_deployments_for_softwareDeployments scoped to a software
    immybot_deployments_complianceCompliance report for a deployment
    immybot_deployments_triggerForce immediate reconciliation (destructive)
    immybot_software_installInstall a software via desired state (destructive)

    Reconcile

    ToolPurpose
    immybot_maintenance_sessions_listRecent sessions
    immybot_maintenance_sessions_getOne session snapshot
    immybot_maintenance_sessions_startStart a session (destructive)
    immybot_maintenance_sessions_pausePause a running session
    immybot_maintenance_sessions_resumeResume a paused session
    immybot_maintenance_sessions_cancelCancel a session
    immybot_maintenance_sessions_logsLog stream
    immybot_maintenance_sessions_resultsFinal outcome
    immybot_maintenance_sessions_activeCurrently active sessions
    immybot_maintenance_sessions_summarySummary metrics

    Computers in scope

    ToolPurpose
    immybot_computers_listEnrolled computers
    immybot_computers_getOne computer detail
    immybot_computers_searchSearch by name
    immybot_computers_inventoryInstalled software on a computer
    immybot_computers_deploymentsDeployments hitting a computer
    immybot_computers_trigger_checkinForce a check-in

    The Canonical Deployment Workflow

    1. Identify the software

    immybot_software_search → immybot_software_get → immybot_software_latest_version
    

    Confirm the software exists in the catalog and what version you intend to deploy.

    2. Identify the scope

    For tenant-wide rollouts:

    immybot_tenants_get → immybot_tenants_computers
    

    For a single computer:

    immybot_computers_search → immybot_computers_get
    

    3. Configure desired state

    Call immybot_deployments_create with the chosen software, version, and scope. The deployment now exists, but nothing has happened on the endpoint yet.

    4. Reconcile

    Either wait for the next scheduled maintenance window, or trigger immediately:

    immybot_maintenance_sessions_start
    

    This is destructive — get human approval first.

    5. Watch the session

    Poll immybot_maintenance_sessions_get and tail immybot_maintenance_sessions_logs. Stop polling once the session is in a terminal state.

    6. Confirm compliance

    Call immybot_deployments_compliance to see which computers in scope reached the desired state and which failed.

    Other Common Workflows

    Per-computer audit

    1. immybot_computers_get for the computer
    2. immybot_computers_inventory for installed software
    3. immybot_computers_deployments for what desired-state expects
    4. Reconcile differences

    Per-tenant compliance scorecard

    1. immybot_tenants_get
    2. immybot_tenants_compliance for the rollup
    3. Drill into failing deployments via immybot_deployments_compliance

    Investigate a failed install

    1. Identify the maintenance session: immybot_maintenance_sessions_list
    2. immybot_maintenance_sessions_results for outcome
    3. immybot_maintenance_sessions_logs for the failing log lines
    4. Cross-reference with immybot_tasks_logs for lower-level detail

    Edge Cases

    • Pinned versions vs latest - A deployment can pin a specific version or track latest. Always confirm which mode you are in before changing the desired version.
    • Conflicting deployments - Two deployments hitting the same software on the same scope can fight. Use immybot_deployments_for_computer to spot conflicts before adding a new one.
    • Reboot requirements - Some installs require a reboot. Maintenance sessions handle this, but expect the session to span longer than the install itself.

    Best Practices

    • Prefer tenant-scoped deployments over per-computer deployments for fleet-wide software; reserve per-computer for exceptions.
    • Always run a small pilot (one or two computers) before triggering a fleet-wide maintenance session.
    • For destructive operations, log the approver, the scope, and the expected outcome.

    Related Skills

    Frequently asked questions

    What to verify before installation and use

    What does the ImmyBot Software Deployment source document cover?

    This is ImmyBot's headline capability. The model is desired-state: you assert what should be installed, then a maintenance session brings the endpoint into compliance. This skill walks the canonical deployment workflow end-to-end.

    How do I install ImmyBot Software Deployment?

    The source record exposes this install command: npx skills add https://github.com/WYRE-AI/msp-claude-plugins --skill "msp-claude-plugins/immybot/immybot/skills/software-deployment". Inspect the command and pinned source before running it.

    Alternatives

    Compare before choosing