# Orchardcore Workflows

> Skill for creating and managing Orchard Core workflows. Covers workflow type definitions, custom activities, events, workflow expressions, and workflow triggers.

- Skill: `majiayu000/orchardcore-workflows` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/orchardcore-workflows`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/orchardcore-workflows/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- License: Apache-2.0
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/orchardcore-workflows

---


# Orchard Core Workflows - Prompt Templates

## Create a Workflow

You are an Orchard Core expert. Generate workflow definitions and custom activities for Orchard Core.

### Guidelines

- Workflows automate processes in response to events or manual triggers.
- Enable the `OrchardCore.Workflows` feature to use workflows.
- Workflow types define reusable workflow templates with activities and transitions.
- Activities are the building blocks: tasks (actions) and events (triggers).
- Use JavaScript or Liquid expressions in workflow activities for dynamic behavior.
- Workflows can be triggered by content events, HTTP requests, timers, or signals.
- Each activity has an `ActivityId` and can have multiple outcomes (branches).

### Enabling Workflows

```json
{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "OrchardCore.Workflows",
        "OrchardCore.Workflows.Http",
        "OrchardCore.Workflows.Timers"
      ],
      "disable": []
    }
  ]
}
```

### Built-in Event Activities

- `ContentCreatedEvent` - Triggered when a content item is created.
- `ContentPublishedEvent` - Triggered when a content item is published.
- `ContentUpdatedEvent` - Triggered when a content item is updated.
- `ContentDeletedEvent` - Triggered when a content item is deleted.
- `HttpRequestEvent` - Triggered by an incoming HTTP request.
- `TimerEvent` - Triggered on a schedule (cron expression).
- `SignalEvent` - Triggered by a named signal.
- `UserRegisteredEvent` - Triggered when a new user registers.

### Built-in Task Activities

- `NotifyTask` - Displays a notification message.
- `LogTask` - Writes to the application log.
- `SetPropertyTask` - Sets a workflow property.
- `IfElseTask` - Conditional branching.
- `ForLoopTask` - Loop over a collection.
- `ForkTask` - Parallel execution branches.
- `JoinTask` - Wait for parallel branches to complete.
- `HttpRequestTask` - Make an outbound HTTP request.
- `HttpRedirectTask` - Redirect the user to a URL.
- `ContentCreateTask` - Create a new content item.
- `ContentPublishTask` - Publish a content item.
- `SendEmailTask` - Send an email notification.
- `ScriptTask` - Execute a JavaScript expression.

### Creating a Custom Activity

```csharp
using OrchardCore.Workflows.Abstractions.Models;
using OrchardCore.Workflows.Activities;
using OrchardCore.Workflows.Models;

public sealed class MyCustomTask : TaskActivity
{
    private readonly IStringLocalizer S;

    public MyCustomTask(IStringLocalizer<MyCustomTask> localizer)
    {
        S = localizer;
    }

    public override string Name => "MyCustomTask";

    public override LocalizedString DisplayText => S["My Custom Task"];

    public override LocalizedString Category => S["Custom"];

    public override IEnumerable<Outcome> GetPossibleOutcomes(
        WorkflowExecutionContext workflowContext,
        ActivityContext activityContext)
    {
        return Outcomes(S["Done"], S["Failed"]);
    }

    public override async Task<ActivityExecutionResult> ExecuteAsync(
        WorkflowExecutionContext workflowContext,
        ActivityContext activityContext)
    {
        try
        {
            // Custom logic here
            return Outcomes("Done");
        }
        catch
        {
            return Outcomes("Failed");
        }
    }
}
```

### Creating a Custom Event

```csharp
using OrchardCore.Workflows.Activities;
using OrchardCore.Workflows.Models;

public sealed class MyCustomEvent : EventActivity
{
    private readonly IStringLocalizer S;

    public MyCustomEvent(IStringLocalizer<MyCustomEvent> localizer)
    {
        S = localizer;
    }

    public override string Name => "MyCustomEvent";

    public override LocalizedString DisplayText => S["My Custom Event"];

    public override LocalizedString Category => S["Custom"];

    public override bool CanExecute(
        WorkflowExecutionContext workflowContext,
        ActivityContext activityContext)
    {
        return true;
    }

    public override IEnumerable<Outcome> GetPossibleOutcomes(
        WorkflowExecutionContext workflowContext,
        ActivityContext activityContext)
    {
        return Outcomes(S["Done"]);
    }
}
```

### Registering Custom Activities

```csharp
public sealed class Startup : StartupBase
{
    public override void ConfigureServices(IServiceCollection services)
    {
        services.AddActivity<MyCustomTask, MyCustomTaskDisplayDriver>();
        services.AddActivity<MyCustomEvent, MyCustomEventDisplayDriver>();
    }
}
```

### Workflow Expressions

Workflows support JavaScript and Liquid expressions:

**JavaScript expressions:**
```javascript
// Access workflow input
var contentItem = input("ContentItem");

// Access workflow properties
var count = property("LoopCount");

// Set output
setOutcome("Done");
```

**Liquid expressions:**
```liquid
{{ Workflow.Input.ContentItem.DisplayText }}
{{ Workflow.Properties.MyProperty }}
```

### Timer Cron Expressions

Timer events use cron expressions:

- `*/5 * * * *` - Every 5 minutes.
- `0 * * * *` - Every hour.
- `0 0 * * *` - Every day at midnight.
- `0 0 * * 1` - Every Monday at midnight.
- `0 0 1 * *` - First day of every month.