Add Skill: langgraph-workflow-creation

Extracted from: https://github.com/jkmaina/LangGraphProjects.git
Score: 1.0

config/settings.yaml

@@ -34,8 +34,8 @@ scout:
     - 'rag agent workflow'
     - 'tool calling workflow'
   filters:
-    stars_min: 10
-    pushed_after: 2026-02-01
+    stars_min: 15
+    pushed_after: 2026-05-01
     language: Python
     archived: false
     size_max_kb: 10000

skills/agent-supervisor/SKILL.md

@@ -1,84 +0,0 @@
----
-name: agent-supervisor
-version: 1.0.0
-description: Demonstrate a supervisor-worker architecture for intelligent task delegation
-  and real-time decision-making.
-inputs:
-- name: OPENAI_API_KEY
-  description: OpenAI API key for language models.
-- name: TAVILY_API_KEY
-  description: Tavily API key for search functionality.
-steps:
-- step: 1
-  action: Load environment variables.
-  details: Set the OPENAI_API_KEY and TAVILY_API_KEY environment variables.
-- step: 2
-  action: Configure LangChain tools.
-  details: Initialize TavilySearchResults and PythonREPLTool.
-- step: 3
-  action: Define agent nodes.
-  details: Create functions for the Researcher and Coder agents that process state
-    through their respective tasks.
-- step: 4
-  action: Set up supervisor agent.
-  details: Create a supervisor agent function that decides which worker should act
-    next based on user input.
-- step: 5
-  action: Build state graph.
-  details: Construct the state graph with nodes for each agent and edges connecting
-    them to the supervisor node.
-- step: 6
-  action: Add conditional edges.
-  details: Define conditions for transitioning between agents based on their responses.
-- step: 7
-  action: Compile graph.
-  details: Compile the state graph into a runnable workflow.
-- step: 8
-  action: Run example queries.
-  details: Stream through the workflow with example inputs to demonstrate its functionality.
-outputs:
-- name: 'Example 1: Code Hello World'
-  description: A demonstration of coding a simple hello world program.
-- name: 'Example 2: Research Report'
-  description: A demonstration of researching and writing a brief report on pikas.
-tags: []
-metadata:
-  source_repo: https://github.com/extrawest/multi_agent_workflow_demo_in_langgraph.git
-  extracted_at: ''
-  confidence: 0.9
----
-
-# agent-supervisor
-
-Demonstrate a supervisor-worker architecture for intelligent task delegation and real-time decision-making.
-
-## Steps
-
-1. {'step': 1, 'action': 'Load environment variables.', 'details': 'Set the OPENAI_API_KEY and TAVILY_API_KEY environment variables.'}
-2. {'step': 2, 'action': 'Configure LangChain tools.', 'details': 'Initialize TavilySearchResults and PythonREPLTool.'}
-3. {'step': 3, 'action': 'Define agent nodes.', 'details': 'Create functions for the Researcher and Coder agents that process state through their respective tasks.'}
-4. {'step': 4, 'action': 'Set up supervisor agent.', 'details': 'Create a supervisor agent function that decides which worker should act next based on user input.'}
-5. {'step': 5, 'action': 'Build state graph.', 'details': 'Construct the state graph with nodes for each agent and edges connecting them to the supervisor node.'}
-6. {'step': 6, 'action': 'Add conditional edges.', 'details': 'Define conditions for transitioning between agents based on their responses.'}
-7. {'step': 7, 'action': 'Compile graph.', 'details': 'Compile the state graph into a runnable workflow.'}
-8. {'step': 8, 'action': 'Run example queries.', 'details': 'Stream through the workflow with example inputs to demonstrate its functionality.'}
-
-## Inputs
-
-- {'name': 'OPENAI_API_KEY', 'description': 'OpenAI API key for language models.'}
-- {'name': 'TAVILY_API_KEY', 'description': 'Tavily API key for search functionality.'}
-
-## Outputs
-
-- {'name': 'Example 1: Code Hello World', 'description': 'A demonstration of coding a simple hello world program.'}
-- {'name': 'Example 2: Research Report', 'description': 'A demonstration of researching and writing a brief report on pikas.'}
-
-## Failure Modes
-
-- {'mode': 'Invalid API keys', 'description': 'The workflow may fail if the provided API keys are invalid or expired.'}
-- {'mode': 'Insufficient permissions', 'description': 'The workflow may fail if the user does not have sufficient permissions to use the Tavily search functionality.'}
-
-## Source
-
-Extracted from: [https://github.com/extrawest/multi_agent_workflow_demo_in_langgraph.git](https://github.com/extrawest/multi_agent_workflow_demo_in_langgraph.git)
-Confidence: 0.9

skills/agent-supervisor/commands.md

@@ -1,6 +0,0 @@
-# Commands: agent-supervisor
-
-## Available Commands
-
-- `/skill agent-supervisor` — Load this skill
-- `/run agent-supervisor` — Execute workflow

skills/agent-supervisor/examples.md

@@ -1,10 +0,0 @@
-# Examples: agent-supervisor
-
-## Usage Example
-
-```python
-# How to use this skill
-# Inputs: {'name': 'OPENAI_API_KEY', 'description': 'OpenAI API key for language models.'}, {'name': 'TAVILY_API_KEY', 'description': 'Tavily API key for search functionality.'}
-# Process: {'step': 1, 'action': 'Load environment variables.', 'details': 'Set the OPENAI_API_KEY and TAVILY_API_KEY environment variables.'} → {'step': 2, 'action': 'Configure LangChain tools.', 'details': 'Initialize TavilySearchResults and PythonREPLTool.'} → {'step': 3, 'action': 'Define agent nodes.', 'details': 'Create functions for the Researcher and Coder agents that process state through their respective tasks.'}
-# Outputs: {'name': 'Example 1: Code Hello World', 'description': 'A demonstration of coding a simple hello world program.'}, {'name': 'Example 2: Research Report', 'description': 'A demonstration of researching and writing a brief report on pikas.'}
-```

skills/agent-supervisor/metadata.json

@@ -1,81 +0,0 @@
-{
-  "name": "agent-supervisor",
-  "version": "1.0.0",
-  "goal": "Demonstrate a supervisor-worker architecture for intelligent task delegation and real-time decision-making.",
-  "inputs": [
-    {
-      "name": "OPENAI_API_KEY",
-      "description": "OpenAI API key for language models."
-    },
-    {
-      "name": "TAVILY_API_KEY",
-      "description": "Tavily API key for search functionality."
-    }
-  ],
-  "steps": [
-    {
-      "step": 1,
-      "action": "Load environment variables.",
-      "details": "Set the OPENAI_API_KEY and TAVILY_API_KEY environment variables."
-    },
-    {
-      "step": 2,
-      "action": "Configure LangChain tools.",
-      "details": "Initialize TavilySearchResults and PythonREPLTool."
-    },
-    {
-      "step": 3,
-      "action": "Define agent nodes.",
-      "details": "Create functions for the Researcher and Coder agents that process state through their respective tasks."
-    },
-    {
-      "step": 4,
-      "action": "Set up supervisor agent.",
-      "details": "Create a supervisor agent function that decides which worker should act next based on user input."
-    },
-    {
-      "step": 5,
-      "action": "Build state graph.",
-      "details": "Construct the state graph with nodes for each agent and edges connecting them to the supervisor node."
-    },
-    {
-      "step": 6,
-      "action": "Add conditional edges.",
-      "details": "Define conditions for transitioning between agents based on their responses."
-    },
-    {
-      "step": 7,
-      "action": "Compile graph.",
-      "details": "Compile the state graph into a runnable workflow."
-    },
-    {
-      "step": 8,
-      "action": "Run example queries.",
-      "details": "Stream through the workflow with example inputs to demonstrate its functionality."
-    }
-  ],
-  "outputs": [
-    {
-      "name": "Example 1: Code Hello World",
-      "description": "A demonstration of coding a simple hello world program."
-    },
-    {
-      "name": "Example 2: Research Report",
-      "description": "A demonstration of researching and writing a brief report on pikas."
-    }
-  ],
-  "failure_modes": [
-    {
-      "mode": "Invalid API keys",
-      "description": "The workflow may fail if the provided API keys are invalid or expired."
-    },
-    {
-      "mode": "Insufficient permissions",
-      "description": "The workflow may fail if the user does not have sufficient permissions to use the Tavily search functionality."
-    }
-  ],
-  "confidence": 0.9,
-  "explanation": "This workflow demonstrates a hierarchical multi-agent system where a supervisor agent makes routing decisions based on user input, delegating tasks to specialized worker agents (Researcher and Coder). It is designed to be reusable for similar task delegation scenarios.",
-  "source_repo": "https://github.com/extrawest/multi_agent_workflow_demo_in_langgraph.git",
-  "score": 1.0
-}

skills/agent-supervisor/tests.md

@@ -1,9 +0,0 @@
-# Tests: agent-supervisor
-
-## Test Checklist
-
-- [ ] Workflow has at least 3 steps
-- [ ] All inputs are defined
-- [ ] All outputs are defined
-- [ ] Failure modes are documented
-- [ ] Skill can be loaded without errors

skills/multi-agent-workflow-execution/SKILL.md

@@ -1,113 +0,0 @@
----
-name: multi-agent-workflow-execution
-version: 1.0.0
-description: Execute multi-agent AI workflows defined in YAML blueprints by creating
-  sessions, submitting user prompts, and polling for completion until final answers
-  are returned.
-inputs:
-- Blueprint ID or name (to identify the workflow to execute)
-- User shortcut (authentication identifier for the user)
-- User question or prompt (input to the workflow)
-- Base URL of the UnifAI API (endpoint for session management)
-- Polling interval (seconds between status checks during execution)
-steps:
-- Resolve the blueprint ID from either direct ID or name lookup via the API, handling
-  cases where the blueprint is not found or not unique
-- Create a new session from the resolved blueprint using the session creation endpoint
-- Submit the session with the user's prompt to start the multi-agent workflow execution
-- Poll the session status at regular intervals until the session completes, fails,
-  or is cancelled
-- Retrieve and return the final answer from the completed workflow
-outputs:
-- Final workflow result or answer (text or structured data)
-- Session status (completed, failed, or cancelled)
-- Error details if the workflow execution fails or times out
-tags: []
-metadata:
-  source_repo: https://github.com/redhat-community-ai-tools/UnifAI.git
-  extracted_at: ''
-  confidence: 0.95
----
-
-# multi-agent-workflow-execution
-
-Execute multi-agent AI workflows defined in YAML blueprints by creating sessions, submitting user prompts, and polling for completion until final answers are returned.
-
-## Setup
-
-**Dependencies:**
-
-```text
-pip install requests urllib3 python-langgraph temporalio
-```
-
-**Setup steps:**
-
-1. Install Python 3.11+ and required packages (requests, langgraph, temporalio)
-1. Configure API base URL and user credentials in environment variables or config
-1. Define or select a blueprint from the available workflows in the system
-1. Run the execution_workflow.py script with blueprint ID/name and user prompt
-
-## Key Files
-
-- `scripts/execution_workflow.py - Main workflow execution script`
-- `multi-agent/lib/mas/engine/ - LangGraph-based orchestration modules`
-- `multi-agent/lib/mas/elements/ - Node definitions (custom_agent_node, merger_node, etc.)`
-- `multi-agent/lib/mas/blueprints/ - Blueprint resolution and validation logic`
-
-## Steps
-
-1. Resolve the blueprint ID from either direct ID or name lookup via the API, handling cases where the blueprint is not found or not unique
-2. Create a new session from the resolved blueprint using the session creation endpoint
-3. Submit the session with the user's prompt to start the multi-agent workflow execution
-4. Poll the session status at regular intervals until the session completes, fails, or is cancelled
-5. Retrieve and return the final answer from the completed workflow
-
-## Implementation Details
-
-```python
-resolve_blueprint_id() - Resolves blueprint by ID or name lookup with error handling
-```
-
-```python
-create_session() - Creates a new session from a blueprint via POST /user.session.create
-```
-
-```python
-submit_session() - Submits user prompt to start workflow via POST /user.session.submit
-```
-
-```python
-poll_session_status() - Polls session.stream.status at configurable intervals
-```
-
-```python
-get_final_answer() - Retrieves final output via GET /session.chat.get
-```
-
-## Inputs
-
-- Blueprint ID or name (to identify the workflow to execute)
-- User shortcut (authentication identifier for the user)
-- User question or prompt (input to the workflow)
-- Base URL of the UnifAI API (endpoint for session management)
-- Polling interval (seconds between status checks during execution)
-
-## Outputs
-
-- Final workflow result or answer (text or structured data)
-- Session status (completed, failed, or cancelled)
-- Error details if the workflow execution fails or times out
-
-## Failure Modes
-
-- Blueprint not found or not unique - script exits with an error listing available blueprints
-- Session creation fails - may be due to invalid blueprint ID, authentication issues, or rate limiting
-- Session submission fails - could be due to network issues, invalid parameters, or API rate limits
-- Polling loop times out - session may be stuck in a long-running state without progress
-- Final answer retrieval fails - could be due to session cleanup or network issues after completion
-
-## Source
-
-Extracted from: [https://github.com/redhat-community-ai-tools/UnifAI.git](https://github.com/redhat-community-ai-tools/UnifAI.git)
-Confidence: 0.95

skills/multi-agent-workflow-execution/commands.md

@@ -1,6 +0,0 @@
-# Commands: multi-agent-workflow-execution
-
-## Available Commands
-
-- `/skill multi-agent-workflow-execution` — Load this skill
-- `/run multi-agent-workflow-execution` — Execute workflow

skills/multi-agent-workflow-execution/examples.md

@@ -1,10 +0,0 @@
-# Examples: multi-agent-workflow-execution
-
-## Usage Example
-
-```python
-# How to use this skill
-# Inputs: Blueprint ID or name (to identify the workflow to execute), User shortcut (authentication identifier for the user), User question or prompt (input to the workflow), Base URL of the UnifAI API (endpoint for session management), Polling interval (seconds between status checks during execution)
-# Process: Resolve the blueprint ID from either direct ID or name lookup via the API, handling cases where the blueprint is not found or not unique → Create a new session from the resolved blueprint using the session creation endpoint → Submit the session with the user's prompt to start the multi-agent workflow execution
-# Outputs: Final workflow result or answer (text or structured data), Session status (completed, failed, or cancelled), Error details if the workflow execution fails or times out
-```

skills/multi-agent-workflow-execution/metadata.json

@@ -1,35 +0,0 @@
-{
-  "name": "multi-agent-workflow-execution",
-  "version": "1.0.0",
-  "goal": "Execute multi-agent AI workflows defined in YAML blueprints by creating sessions, submitting user prompts, and polling for completion until final answers are returned.",
-  "inputs": [
-    "Blueprint ID or name (to identify the workflow to execute)",
-    "User shortcut (authentication identifier for the user)",
-    "User question or prompt (input to the workflow)",
-    "Base URL of the UnifAI API (endpoint for session management)",
-    "Polling interval (seconds between status checks during execution)"
-  ],
-  "steps": [
-    "Resolve the blueprint ID from either direct ID or name lookup via the API, handling cases where the blueprint is not found or not unique",
-    "Create a new session from the resolved blueprint using the session creation endpoint",
-    "Submit the session with the user's prompt to start the multi-agent workflow execution",
-    "Poll the session status at regular intervals until the session completes, fails, or is cancelled",
-    "Retrieve and return the final answer from the completed workflow"
-  ],
-  "outputs": [
-    "Final workflow result or answer (text or structured data)",
-    "Session status (completed, failed, or cancelled)",
-    "Error details if the workflow execution fails or times out"
-  ],
-  "failure_modes": [
-    "Blueprint not found or not unique - script exits with an error listing available blueprints",
-    "Session creation fails - may be due to invalid blueprint ID, authentication issues, or rate limiting",
-    "Session submission fails - could be due to network issues, invalid parameters, or API rate limits",
-    "Polling loop times out - session may be stuck in a long-running state without progress",
-    "Final answer retrieval fails - could be due to session cleanup or network issues after completion"
-  ],
-  "confidence": 0.95,
-  "explanation": "The UnifAI repository contains a concrete, reusable workflow pattern for executing multi-agent AI workflows. The scripts/execution_workflow.py script demonstrates a complete pipeline: resolving blueprints by ID or name, creating sessions from blueprints, submitting user prompts to start workflows, polling session status until completion, and retrieving final answers. This pattern can be adapted to any multi-agent workflow defined in the YAML blueprint system, making it reusable across different use cases and teams.",
-  "source_repo": "https://github.com/redhat-community-ai-tools/UnifAI.git",
-  "score": 1.0
-}

skills/multi-agent-workflow-execution/tests.md

@@ -1,9 +0,0 @@
-# Tests: multi-agent-workflow-execution
-
-## Test Checklist
-
-- [ ] Workflow has at least 3 steps
-- [ ] All inputs are defined
-- [ ] All outputs are defined
-- [ ] Failure modes are documented
-- [ ] Skill can be loaded without errors