Does this skill prevent infinite loops in workflows?

Yes, the connection rules strictly prohibit cycles (back-references) to ensure all workflows are directed and acyclic.

Is there a limit to the size of a workflow?

The current schema specification supports a maximum of 50 nodes per workflow to ensure maintainability and performance.

Can I integrate external tools using this schema?

Yes, the 'mcp' node type is specifically designed to call external Model Context Protocol (MCP) server tools within a workflow.

How does the workflow handle conditional branching?

It provides two specialized nodes: 'ifElse' for binary true/false logic and 'switch' for multi-directional branching with up to 10 distinct paths.

What node types are supported by the workflow-schema?

The schema supports 10 specialized node types: start, end, prompt, subAgent, askUserQuestion, ifElse, switch, skill, mcp, and subAgentFlow.

Claude Code Workflow Schema

Name: Claude Code Workflow Schema
Author: hclleee

byhclleee

0•

생산성 및 워크플로

Defines structured workflow schemas for Claude Code using 10 specialized node types and strict connection rules for agent orchestration.

The Workflow Schema skill provides a robust framework for architecting complex, multi-step automation sequences within Claude Code. It utilizes a comprehensive JSON-based schema that supports 10 distinct node types, including AI sub-agents, conditional branching (If/Else and Switch), user interaction points, and external MCP tool integrations. By enforcing strict structural validation—such as mandatory start/end points and the prevention of cyclical dependencies—it ensures that developers can build reliable, maintainable, and sophisticated agentic workflows that scale with project complexity.

주요 기능

01Standardized JSON structure for predictable agent behavior and simplified debugging

02Strict validation rules for workflow connectivity to prevent cycles and orphan nodes

03Modular architecture allowing for nested sub-agent flows and cross-skill calls

04Comprehensive schema for 10 specialized node types including AI sub-agents and MCP tools

05Built-in support for complex logic with if-else and multi-way switch nodes

060 GitHub stars

사용 사례

01Integrating external MCP tools and custom skills into structured developer workflows

02Creating interactive decision points and user prompts within long-running AI tasks

03Designing complex multi-agent coding pipelines with automated conditional branching

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hclleee/cc-plugin workflow-schema

For use in Claude.ai and ChatGPT

Download Skill