repl/skills/flowai-workflow-adapt-agents/SKILL.md
Adapt flowai-workflow agents to the current project after a framework update. Merges upstream agent changes with project-specific customizations.
npx skillsauth add korchasa/flowai-workflow flowai-workflow-adapt-agentsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
When the flowai-workflow framework is updated, agent definitions may change. This skill merges upstream changes with your project-specific adaptations, preserving your customizations while incorporating new features and fixes.
Narration rule: before every step below, print one short sentence telling the user what you are about to do (what will be read, which file will be diffed or written). The goal is no surprises — the user should always know the next action before it happens. Do not bundle multiple steps into one announcement; narrate each one as you reach it.
Announce first, e.g.:
"Listing files in .flowai-workflow/agents/ to see which agents you
have installed (read-only)."
Detect installed agents in .flowai-workflow/agents/.
Announce first, e.g.: "Comparing each installed agent against its upstream template version. Read-only — I'm only computing diffs, nothing is written yet."
Compare each agent against the upstream template version.
For each agent with upstream changes, repeat:
Announce the diff. Example:
"Showing the upstream diff for agent-<name>.md. No file is touched
until you approve."
Display the upstream diff.
Announce the proposal. Example:
"Proposing a merged version of agent-<name>.md that keeps your
project-specific sections and folds in upstream changes. Still
read-only — waiting for your approval."
Show the proposed merge.
Announce the write. Example:
"Writing the merged version to .flowai-workflow/agents/<name>.md.
Only this single file is modified."
Apply the merge after the user confirms.
Announce first, e.g.: "All agents processed. Printing a summary of which files were adapted; no further changes."
Report summary of adapted agents.
flowai-workflow framework updates (e.g., after
deno install pulls a new version).development
Supervisor for one flowai-workflow run (Codex). Starts or resumes a single workflow, diagnoses failures from run artifacts, patches root causes, resumes the same run. Run inside an isolated Codex worker subagent spawned by the `supervise`/`orchestrate` skill.
development
Long-cycle flowai-workflow orchestrator (Codex). Reads project orchestration policy, selects the next workflow, and returns a structured supervisor delegation request. Run inside an isolated Codex worker subagent spawned by the `orchestrate` skill.
data-ai
Live flowai-workflow run supervisor. Use only for requests to run, monitor, continue, or resume a current workflow now. Exclude last-night, finished, post-mortem, root-cause-report, and conceptual questions.
data-ai
Scaffold or adapt flowai-workflow DAGs in a project. Use for adding flowai-workflow, adapting an existing .flowai-workflow/<name>, validating workflow.yaml, or wiring agent prompts/scripts.