Skip to main content

hubify workflow

Commands for managing multi-step workflows.

Usage

hubify workflow <subcommand> [options]

Subcommands

CommandDescription
listList available workflows
info <name>View workflow details
run <name>Execute a workflow
createCreate a new workflow
validateValidate a workflow definition

Examples

List Workflows

hubify workflow list
Output:
Available Workflows

  pr-review
    Description: Complete pull request review workflow
    Steps: 4
    Skills: github-pr-review, security-checklist

  new-feature
    Description: Feature development workflow
    Steps: 6
    Skills: architecture-review, typescript-strict-mode

  code-audit
    Description: Comprehensive code audit
    Steps: 5
    Skills: security-checklist, performance-review

View Workflow Details

hubify workflow info pr-review
Output:
Workflow: pr-review

  Description: Complete pull request review workflow

  Steps:
    1. Fetch PR details (github)
    2. Run security checklist (security-checklist)
    3. Check code patterns (code-quality)
    4. Generate review summary (pr-summary)

  Required Tools:
    - github (oauth)

  Required Skills:
    - github-pr-review
    - security-checklist
    - code-quality

  Estimated Time: 5-10 minutes

Run Workflow

hubify workflow run pr-review --pr 123
Output:
Running workflow: pr-review

  Step 1/4: Fetch PR details
    ✓ Fetched PR #123 from repo

  Step 2/4: Run security checklist
    ✓ No security issues found

  Step 3/4: Check code patterns
    ⚠ 2 suggestions found

  Step 4/4: Generate review summary
    ✓ Summary generated

Workflow complete!

Results:
  - Security: PASS
  - Code Quality: 2 suggestions
  - Summary: ./pr-review-123.md

Create Workflow

hubify workflow create
Interactive wizard:
Creating new workflow...

? Workflow name: my-workflow
? Description: My custom workflow

? Add step 1:
  Name: setup
  Skill: typescript-strict-mode
  Required: true

? Add another step? (y/n) y

? Add step 2:
  Name: verify
  Skill: lint-check
  Required: true

? Add another step? (y/n) n

Created: .hubify/workflows/my-workflow.yaml

Run with Options

# Dry run
hubify workflow run pr-review --pr 123 --dry-run

# Skip steps
hubify workflow run pr-review --pr 123 --skip security

# Verbose output
hubify workflow run pr-review --pr 123 --verbose

Validate Workflow

hubify workflow validate ./my-workflow.yaml

Workflow Definition

name: pr-review
description: Complete pull request review

inputs:
  - name: pr
    type: number
    required: true
    description: PR number

steps:
  - name: fetch
    skill: github-pr-review
    inputs:
      pr: "{{inputs.pr}}"
    outputs:
      - diff
      - files

  - name: security
    skill: security-checklist
    inputs:
      files: "{{steps.fetch.outputs.files}}"
    outputs:
      - findings

  - name: quality
    skill: code-quality
    inputs:
      diff: "{{steps.fetch.outputs.diff}}"
    outputs:
      - suggestions

  - name: summary
    skill: pr-summary
    inputs:
      security: "{{steps.security.outputs.findings}}"
      quality: "{{steps.quality.outputs.suggestions}}"

tools:
  required:
    - github

Step Options

OptionDescription
nameStep identifier
skillSkill to execute
inputsInput mappings
outputsOutput variables
conditionWhen to run this step
retryRetry configuration
timeoutStep timeout

Conditional Steps

steps:
  - name: security
    skill: security-checklist
    condition: "{{inputs.check_security}}"

Retry Configuration

steps:
  - name: fetch
    skill: github-fetch
    retry:
      attempts: 3
      delay: 1000  # ms

See Also