Repository navigation
feat(skills): add workflow-creator - #105
Merged
Merged
Conversation
Teaches an agent to compose a workflow with the `workflow_create` tool that LibreFang ships as a builtin: when a workflow beats a one-off `agent_send`, the four agent-binding shapes and why `{"type": …}` find-or-spawn makes a workflow portable, how `required_skills` fails a step before it bills an LLM call, and the creation-time validations an author is most likely to trip.
Written against the tool's implementation rather than its issue description, and the copy pinned in librefang/librefang's registry snapshot is loaded by `crates/librefang-runtime/tests/workflow_creator_skill.rs`, which checks the ceilings quoted here against the live tool schema.
Refs librefang/librefang#6934
This was referenced Aug 24, 2026
houko
enabled auto-merge (squash)
August 24, 2026 22:27
houko
disabled auto-merge
September 13, 2026 16:16
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds the
workflow-creatorprompt-only skill, the remaining scope item of librefang/librefang#6934 (theworkflow_createtool itself merged as librefang/librefang#7857).What it teaches
agent_sendis better — a workflow that never runs again is a name permanently taken on the daemon.name/agent/prompt_templaterequired,{{input}}vsoutput_varvs declared inputs,depends_onswitching execution from sequential to topological, and theerror_mode/modevocabularies.StepAgentshapes — bare string,{"name": …},{"id": …},{"type": …}— with guidance on which to reach for.{"type": …}is find-or-spawn, so it is what makes a workflow stand up on an instance where nothing is pre-registered.required_skillsbehaves: checked after agent resolution and before the prompt is built, resolved against the registry independently of the agent's allowlist, with the three failure classes its error text distinguishes.input_schema, including that the type key isparam_typerather thantype, and what the{{var}}-scanning fallback costs a caller when the schema is omitted.Provenance
Written against the implementation on
librefang/librefang@main—WorkflowStep,StepAgent,Workflow::validate, andbuild_created_workflow— rather than against the issue's sketch of the API, so the ceilings and key spellings are the ones the tool actually enforces.Verification
The copy pinned in librefang/librefang's registry snapshot is loaded in CI by
crates/librefang-runtime/tests/workflow_creator_skill.rs(librefang/librefang#7873): it registers as prompt-only through the sameSkillRegistry::load_allpath an operator's install takes, clears the load-boundary prompt-injection scan, is order-independent in the rendered skill block, and has its quoted ceilings checked against the liveworkflow_createschema rather than hardcoded numbers.SKILL.mdonly, noskill.toml— matching every other entry here, and deliberate: askill.tomlbeside aSKILL.mdsuppresses the auto-convert, and without a companionprompt_context.mdthe entire prompt body is dropped with no error.