Skip to content

conductor-oss/conductor-skills

BranchesTags

Repository files navigation

Conductor

Conductor Skills

Teach your AI coding agent to create, run, monitor, and manage Conductor workflow orchestrations.

Star Conductor  ·  Join Slack  ·  License

What You Get

Once installed, your AI agent can:

  • Create workflow definitions with any task type (HTTP, SWITCH, FORK, WAIT, etc.)
  • Run workflows synchronously or asynchronously
  • Monitor executions and search by status, time, or correlation ID
  • Manage workflows — pause, resume, terminate, retry, restart
  • Signal WAIT and HUMAN tasks for human-in-the-loop patterns
  • Write workers in Python, JavaScript, Java, Go, C#, Ruby, or Rust
  • Visualize workflows as Mermaid diagrams
  • Manage schedules, secrets, and webhooks (Orkes enterprise)

Quick Install

Claude Code Plugin (recommended for Claude users)

Install as a Claude Code plugin from the marketplace:

/plugin marketplace add conductor-oss/conductor-skills
/plugin install conductor@conductor-skills

Or test locally during development:

claude --plugin-dir ./conductor-skills

Install for all detected agents

One command to auto-detect every supported agent on your system and install globally where possible. Re-run anytime — it only installs for newly detected agents.

macOS / Linux

curl -sSL https://conductor-oss.github.io/conductor-skills/install.sh | bash -s -- --all

Windows (PowerShell)

irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -All

Windows (cmd)

powershell -c "irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -All"

Install for a specific agent

These agents don't support global install — run the command from your project directory.

macOS / Linux

Agent Command
Cline curl -sSL https://conductor-oss.github.io/conductor-skills/install.sh | bash -s -- --agent cline
GitHub Copilot curl -sSL https://conductor-oss.github.io/conductor-skills/install.sh | bash -s -- --agent copilot
Amazon Q curl -sSL https://conductor-oss.github.io/conductor-skills/install.sh | bash -s -- --agent amazonq

Windows (PowerShell)

Agent Command
Cline irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -Agent cline
GitHub Copilot irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -Agent copilot
Amazon Q irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -Agent amazonq

Windows (cmd)

Agent Command
Cline powershell -c "irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -Agent cline"
GitHub Copilot powershell -c "irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -Agent copilot"
Amazon Q powershell -c "irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -Agent amazonq"

All other agents are installed globally via the install all command above. You can also use --agent <name> for any agent to do a project-level install.

That's it — ask your agent to connect to your server (see Try It below).

Try It

After installing, try these prompts with your agent:

Configure

  • "Connect to my Conductor server at https://play.orkes.io/api"
  • "Save my Conductor server config as a profile called production"
  • "Switch to my staging Conductor profile"

Create & Run

  • "Create a workflow that calls the GitHub API to get open issues and sends a Slack notification"
  • "Run the my-workflow workflow with input {"userId": 123}"

Monitor

  • "Show me all failed workflow executions from the last hour"
  • "What's the status of execution abc-123?"

Manage

  • "Retry all failed executions of my-workflow"
  • "Pause the running execution xyz-456"

Human-in-the-Loop

  • "Signal the wait task in execution abc-123 with approval: true"

Modify

  • "Add an error-handling branch to the order-processing workflow"
  • "Add a WAIT task before the payment step in my checkout workflow"

Workers

  • "Write a Python worker that processes image thumbnails"
  • "Write a JavaScript worker that validates email addresses"
  • "Generate a Go worker that fetches data from a REST API and transforms the response"

Visualize

  • "Show me a diagram of the order-processing workflow"

Examples

Example Description
Create and Run a Workflow Define a workflow, register it, and execute it end-to-end
Monitor and Retry Search executions, diagnose failures, and batch-retry
Signal a Wait Task Human-in-the-loop with WAIT tasks and external signals

References

Reference Description
Workflow Definition Schema Full JSON schema, all task types, input expressions
Writing Workers SDK examples in Python, JavaScript, Java, Go, and more
API Reference REST endpoints for direct API access

Evaluations

The evaluations/ directory contains automated test scenarios to validate the skill works correctly with your agent. See evaluations/README.md for details.

python3 scripts/run_evals.py --verbose

Upgrade

Check for a newer version and upgrade all installed agents:

macOS / Linux

curl -sSL https://conductor-oss.github.io/conductor-skills/install.sh | bash -s -- --all --upgrade

Windows

irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -All -Upgrade

Or upgrade a single agent: --agent <name> --upgrade

Supported Agents

Agent Flag Global install Project install
Claude Code claude Native skill (via claude skill add) —
Codex CLI codex ~/.codex/AGENTS.md AGENTS.md
Gemini CLI gemini ~/.gemini/GEMINI.md GEMINI.md
Cursor cursor ~/.cursor/skills/conductor/SKILL.md .cursor/rules/conductor.mdc
Windsurf windsurf ~/.codeium/windsurf/memories/global_rules.md .windsurfrules
Cline cline — .clinerules
GitHub Copilot copilot — .github/copilot-instructions.md
Aider aider ~/.conductor-skills/ + ~/.aider.conf.yml .conductor-skills/ + .aider.conf.yml
Amazon Q amazonq — .amazonq/rules/conductor.md
Roo Code roo ~/.roo/rules/conductor.md .roo/rules/conductor.md
Amp amp ~/.config/AGENTS.md .amp/instructions.md
OpenCode opencode ~/.config/opencode/skills/conductor/SKILL.md AGENTS.md

Uninstall

macOS / Linux

# Remove a global install
curl -sSL https://conductor-oss.github.io/conductor-skills/install.sh | bash -s -- --agent <name> --global --uninstall

# Remove a project-level install
curl -sSL https://conductor-oss.github.io/conductor-skills/install.sh | bash -s -- --agent <name> --uninstall

Windows (PowerShell)

# Remove a global install
irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -Agent <name> -Global -Uninstall

# Remove a project-level install
irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -Agent <name> -Uninstall

Windows (cmd)

powershell -c "irm https://conductor-oss.github.io/conductor-skills/install.ps1 -OutFile install.ps1; .\install.ps1 -Agent <name> -Global -Uninstall"

License

Apache 2.0 — see LICENSE.txt.

Built for Conductor OSS. Enterprise features powered by Orkes.

About

SKILLS.md for Conductor

Resources

Readme

License

Apache-2.0 license
Activity
Custom properties

Stars

6 stars

Watchers

0 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages