workflow-chain-submit

Submits chained Invoker workflows gated on each previous workflow's merge gate.

18|5|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Neko-Catpital-Labs/Invoker --skill workflow-chain-submit-neko-catpital-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-chain-submit
Source: https://github.com/Neko-Catpital-Labs/Invoker/tree/main/skills/workflow-chain-submit
Command: npx skills add https://github.com/Neko-Catpital-Labs/Invoker --skill workflow-chain-submit-neko-catpital-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Submitting multiple dependent Invoker workflows headlessly requires manually copying workflow IDs between plans and wiring cross-workflow merge-gate dependencies by hand, which is error-prone and slow from the CLI. ## Core Features & Use Cases - Headless chain submission: Submits a sequence of workflow plans where each downstream workflow is gated on the previous workflow's merge gate, using --no-track so submissions return immediately. - Automatic ID resolution: Renders template placeholders like __UPSTREAM_WORKFLOW_ID__ with persisted workflow IDs resolved by name, avoiding transient ID races. - Stacking onto running workflows: The --onto-workflow flag attaches the chain head onto an already-running upstream by setting plan[0] baseBranch to that workflow's featureBranch. - Use Case: You have a feature split across three stacked workflows. Provide the first full plan plus two templates with the externalDependencies placeholder, run the script once, and receive the persisted IDs WF1, WF2, WF3 in chain order. ## Quick Start Run the submit-workflow-chain script with my first workflow plan and the downstream template files to submit the whole gated chain headlessly.

Frequently Asked Questions about workflow-chain-submit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I submit dependent workflows from the CLI in Invoker?

Run scripts/submit-workflow-chain.sh with the first full workflow plan followed by template plans containing an externalDependencies placeholder. The script renders each template with the upstream workflow's persisted ID and submits the chain with --no-track.

How do I stack a new workflow onto an already running workflow?

Pass --onto-workflow <id> so plan[0] baseBranch is set to that workflow's featureBranch before submission. A concrete externalDependency alone is gate-only waiting; true stacking also requires matching the baseBranch to the upstream featureBranch.

What is the difference between completed and review_ready gate policies?

The completed policy (default) makes downstream workflows wait until the upstream merge gate reaches completed status. The review_ready policy lets downstream start once the upstream merge gate is review_ready, awaiting_approval, or completed.

Why does the script resolve workflow IDs by name instead of using submit output?

Resolving IDs from persisted workflows by name avoids transient ID races that can occur when reading IDs directly from submission responses. This ensures each downstream template receives the correct upstream workflow ID.

Does this skill publish GitHub pull requests for the stacked branches?

No, it only manages Invoker workflow stacking, not GitHub PR publication policy. For the Invoker repo itself, publish the PR stack separately with mergify stack push once branch commits are ready.