durable-workflow-runtime:register

Installs .flow workflow archives into a durable workflow runtime and registers binding metadata.

Updated May 13, 2026
One-click install
npx skills add https://github.com/onesmash/slm-as-harness --skill durable-workflow-runtime-register-onesmash
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: durable-workflow-runtime:register
Source: https://github.com/onesmash/slm-as-harness/tree/main/skills/durable-workflow-runtime/register
Command: npx skills add https://github.com/onesmash/slm-as-harness --skill durable-workflow-runtime-register-onesmash

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? It automates the manual, error-prone process of installing a packaged durable workflow into a runtime bundle, ensuring the workflow directory, binding entry, and slash-command shortcut are all created consistently and atomically. ## Core Features & Use Cases - Archive Validation: Verifies that a .flow zip archive contains matching workflow IDs across package-manifest.json, binding-entry.json, and workflow/manifest.json, and rejects unsafe archive paths. - Atomic Installation: Unpacks the workflow into workflow-runtime/workflows/<workflow_id>/, updates workflow-binding.json, and rolls back on failure. - Shortcut Skill Creation: Generates a slash-only shortcut skill under workflow-shortcuts/<workflow_id>/ and mirrors it to .claude/skills/ so Claude Code can discover /<workflow_id>. - Use Case: A team receives a demo-prompt-loop.flow package from a colleague and needs it installed into their durable workflow runtime with a working /demo-prompt-loop command, without touching run state or executing the workflow. ## Quick Start Ask the assistant to register the workflow archive by running the bundled register script with the path to your .flow file, for example: register my demo-prompt-loop.flow file into the durable workflow runtime.

Frequently Asked Questions about durable-workflow-runtime:register

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

FAQPage Schema
How do I register a .flow workflow file into the durable workflow runtime?▼

Run the bundled register script with python scripts/register.py --flow-file path/to/workflow.flow. The script validates the archive, unpacks the workflow directory, updates workflow-binding.json, and creates a slash shortcut skill.

What is a .flow file and what does it contain?▼

A .flow file is a zip archive containing package-manifest.json, binding-entry.json, and a workflow/ directory with manifest.json and workflow code. All three manifests must declare the same workflow_id for registration to succeed.

How do I replace an existing registered workflow?▼

Pass the --force flag to register.py to replace an existing workflow directory and binding entry. Without --force, the script rejects registration when the workflow ID already exists.

Does registering a workflow also run or preflight it?▼

No. Registration is import-only: it does not run dependency preflight, allocate host I/O paths, create run state, or invoke bridge.py start or resume. Those checks belong to the runtime's execution surfaces.

Why does registration fail with a workflow_id mismatch error?▼

The script requires package-manifest.json, binding-entry.json, and workflow/manifest.json to declare identical workflow IDs. It also rejects IDs with characters outside letters, numbers, dot, dash, and underscore, or path traversal segments.

What should I do after a workflow is registered successfully?▼

Run the sibling inject script with the same runtime skill root and target repo root to refresh AGENTS.md and CLAUDE.md with the updated workflow catalog. Registration intentionally does not modify repository instruction files itself.