# Author Workflows (https://www.shipfox.io/docs/how-to/author-workflows)

Description: Start workflows, run commands and agents, pass results, and check the work.

Use these guides to change a workflow file and get a clear result. Each guide
also lists the provider, integration connection, or repository access it needs.

Use the [integrations catalog](https://www.shipfox.io/docs/integrations) to find and connect a provider
when a guide needs one.

A guide that works with only one provider is in that provider's section. For
example, see the [GitHub guides](https://www.shipfox.io/docs/integrations/github/guides). For a complete
workflow, such as an agent feedback loop, start from a
[recipe](https://www.shipfox.io/docs/how-to/recipes).

## Write with an agent [#write-with-an-agent]

### [Write a workflow with an agent](https://www.shipfox.io/docs/how-to/author-workflows/write-a-workflow)

Turn a goal into workflow YAML from your workspace's facts.

### [Start from a template](https://www.shipfox.io/docs/how-to/author-workflows/create-workflow-from-template)

Adapt a Shipfox workflow template to your repository.

## Start runs [#start-runs]

### [Run a workflow manually](https://www.shipfox.io/docs/how-to/author-workflows/run-manually)

Add an on-demand Run action to a workflow.

### [Schedule a workflow](https://www.shipfox.io/docs/how-to/author-workflows/schedule-workflows)

Start recurring work from a Cron schedule.

### [Filter trigger events](https://www.shipfox.io/docs/how-to/author-workflows/trigger-ready-pull-requests)

Stop unwanted events from creating a run.

### [Set inputs per trigger](https://www.shipfox.io/docs/how-to/author-workflows/pass-trigger-inputs)

Run the same jobs with different settings for each start path.

### [Start another workflow](https://www.shipfox.io/docs/how-to/author-workflows/start-another-workflow)

Chain workflows across projects without waiting for the child run.

### [Run after another workflow](https://www.shipfox.io/docs/how-to/author-workflows/run-after-another-workflow)

Start a workflow when a run of another workflow completes.

## Run commands [#run-commands]

### [Run project commands](https://www.shipfox.io/docs/how-to/author-workflows/run-shell-commands)

Run tests, builds, and other command-line tools.

### [Choose runners](https://www.shipfox.io/docs/how-to/author-workflows/choose-runners)

Route jobs to runners with matching labels and resolve pending jobs.

### [Group command logs](https://www.shipfox.io/docs/how-to/author-workflows/group-command-logs)

Make long install and test output easier to scan.

## Use agents [#use-agents]

### [Add an agent step](https://www.shipfox.io/docs/how-to/author-workflows/add-agent-steps)

Run work that needs investigation or judgment.

### [Get typed agent outputs](https://www.shipfox.io/docs/how-to/author-workflows/use-structured-agent-outputs)

Route later work with a typed decision from an agent.

### [Continue an agent session](https://www.shipfox.io/docs/how-to/author-workflows/share-agent-sessions)

Continue one agent conversation across jobs and listening executions.

### [Let agents read runs](https://www.shipfox.io/docs/how-to/author-workflows/inspect-other-runs)

Give an agent read-only access to workflow runs, logs, and annotations.

## Pass data and call tools [#pass-data-and-call-tools]

### [Pass values between jobs](https://www.shipfox.io/docs/how-to/author-workflows/pass-outputs)

Move a small typed value to later work.

### [Publish workflow outputs](https://www.shipfox.io/docs/how-to/author-workflows/publish-workflow-outputs)

Hand values from a successful run to the next workflow.

### [Call a tool without an agent](https://www.shipfox.io/docs/how-to/author-workflows/call-integration-tool)

Call one integration operation with known inputs.

## Listen for events [#listen-for-events]

### [Set listener success rules](https://www.shipfox.io/docs/how-to/author-workflows/define-listener-success)

Decide how listener executions roll up into the job result.