agent-workflow-designer
Use when architecting a multi-step LLM or agent pipeline, choosing single vs multi-agent, or fixing context bloat and broken handoffs. Scaffolds the pattern, handoff contracts and failure handling with workflow_scaffolder.py.
How do I install this agent skill?
npx skills add https://github.com/alirezarezvani/claude-skills --skill agent-workflow-designerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a legitimate development utility for architecting multi-agent systems. It provides documentation on workflow patterns and a Python script to generate configuration templates. No malicious code, data exfiltration, or prompt injection patterns were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Agent Workflow Designer
Tier: POWERFUL
Category: Engineering
Domain: Multi-Agent Systems / AI Orchestration
Overview
Design production-grade multi-agent workflows with clear pattern choice, handoff contracts, failure handling, and cost/context controls.
Core Capabilities
- Workflow pattern selection for multi-step agent systems
- Skeleton config generation for fast workflow bootstrapping
- Context and cost discipline across long-running flows
- Error recovery and retry strategy scaffolding
- Documentation pointers for operational pattern tradeoffs
When to Use
- A single prompt is insufficient for task complexity
- You need specialist agents with explicit boundaries
- You want deterministic workflow structure before implementation
- You need validation loops for quality or safety gates
Quick Start
# Generate a sequential workflow skeleton
python3 scripts/workflow_scaffolder.py sequential --name content-pipeline
# Generate an orchestrator workflow and save it
python3 scripts/workflow_scaffolder.py orchestrator --name incident-triage --output workflows/incident-triage.json
Pattern Map
sequential: strict step-by-step dependency chainparallel: fan-out/fan-in for independent subtasksrouter: dispatch by intent/type with fallbackorchestrator: planner coordinates specialists with dependenciesevaluator: generator + quality gate loop
Detailed templates: references/workflow-patterns.md
Recommended Workflow
- Select pattern based on dependency shape and risk profile.
- Scaffold config via
scripts/workflow_scaffolder.py. - Define handoff contract fields for every edge.
- Add retry/timeouts and output validation gates.
- Dry-run with small context budgets before scaling.
Common Pitfalls
- Over-orchestrating tasks solvable by one well-structured prompt
- Missing timeout/retry policies for external-model calls
- Passing full upstream context instead of targeted artifacts
- Ignoring per-step cost accumulation
Best Practices
- Start with the smallest pattern that can satisfy requirements.
- Keep handoff payloads explicit and bounded.
- Validate intermediate outputs before fan-in synthesis.
- Enforce budget and timeout limits in every step.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/alirezarezvani/claude-skills/agent-workflow-designer">View agent-workflow-designer on skillZs</a>