Add Skill: agent-supervisor

Extracted from: https://github.com/extrawest/multi_agent_workflow_demo_in_langgraph.git
Score: 1.0

skills/agent-supervisor/SKILL.md

@@ -0,0 +1,84 @@
+---
+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

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

skills/agent-supervisor/examples.md

@@ -0,0 +1,10 @@
+# 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

@@ -0,0 +1,81 @@
+{
+  "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,4 +1,4 @@
-# Tests: langgraph-workflow-creation
+# Tests: agent-supervisor
 
 ## Test Checklist
 

skills/langgraph-workflow-creation/SKILL.md

@@ -1,83 +0,0 @@
----
-name: langgraph-workflow-creation
-version: 1.0.0
-description: Create a LangGraph workflow to gather facts using SerperDevTool and process
-  them with an AI agent.
-inputs:
-- API Key for SerperDevTool
-- Search Query
-steps:
-- 'Step 1: Import necessary modules from langgraph and langchain libraries'
-- 'Step 2: Create a LangGraph agent using `langgraph.create_react_agent` function
-  with SerperDevTool as the tool node'
-- 'Step 3: Define the search query and pass it to the agent for fact gathering'
-- 'Step 4: Process the gathered facts within the AI agent'
-outputs:
-- Processed Facts
-tags: []
-metadata:
-  source_repo: https://github.com/jkmaina/LangGraphProjects.git
-  extracted_at: ''
-  confidence: 0.95
----
-
-# langgraph-workflow-creation
-
-Create a LangGraph workflow to gather facts using SerperDevTool and process them with an AI agent.
-
-## Setup
-
-**Dependencies:**
-
-```text
-pip install langchain serperdev
-```
-
-**Setup steps:**
-
-1. Install required libraries: pip install langchain serperdev
-1. Add API key to .env file: OPENAPI_API_KEY=your_api_key
-
-## Key Files
-
-- `agent.py - Contains the LangGraph agent creation logic`
-- `tool_node.py - Defines the SerperDevTool node`
-
-## Steps
-
-1. Step 1: Import necessary modules from langgraph and langchain libraries
-2. Step 2: Create a LangGraph agent using `langgraph.create_react_agent` function with SerperDevTool as the tool node
-3. Step 3: Define the search query and pass it to the agent for fact gathering
-4. Step 4: Process the gathered facts within the AI agent
-
-## Implementation Details
-
-```python
-import langgraph
-from serperdev import SerperDevTool
-
-def create_agent(api_key, query):
-    tool = SerperDevTool(api_key)
-    agent = langgraph.create_react_agent(tool=tool)
-    facts = agent.run(query)
-    return process_facts(facts)
-```
-
-## Inputs
-
-- API Key for SerperDevTool
-- Search Query
-
-## Outputs
-
-- Processed Facts
-
-## Failure Modes
-
-- API Key not provided
-- Invalid Search Query
-
-## Source
-
-Extracted from: [https://github.com/jkmaina/LangGraphProjects.git](https://github.com/jkmaina/LangGraphProjects.git)
-Confidence: 0.95

skills/langgraph-workflow-creation/commands.md

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

skills/langgraph-workflow-creation/examples.md

@@ -1,10 +0,0 @@
-# Examples: langgraph-workflow-creation
-
-## Usage Example
-
-```python
-# How to use this skill
-# Inputs: API Key for SerperDevTool, Search Query
-# Process: Step 1: Import necessary modules from langgraph and langchain libraries → Step 2: Create a LangGraph agent using `langgraph.create_react_agent` function with SerperDevTool as the tool node → Step 3: Define the search query and pass it to the agent for fact gathering
-# Outputs: Processed Facts
-```

skills/langgraph-workflow-creation/metadata.json

@@ -1,26 +0,0 @@
-{
-  "name": "langgraph-workflow-creation",
-  "version": "1.0.0",
-  "goal": "Create a LangGraph workflow to gather facts using SerperDevTool and process them with an AI agent.",
-  "inputs": [
-    "API Key for SerperDevTool",
-    "Search Query"
-  ],
-  "steps": [
-    "Step 1: Import necessary modules from langgraph and langchain libraries",
-    "Step 2: Create a LangGraph agent using `langgraph.create_react_agent` function with SerperDevTool as the tool node",
-    "Step 3: Define the search query and pass it to the agent for fact gathering",
-    "Step 4: Process the gathered facts within the AI agent"
-  ],
-  "outputs": [
-    "Processed Facts"
-  ],
-  "failure_modes": [
-    "API Key not provided",
-    "Invalid Search Query"
-  ],
-  "confidence": 0.95,
-  "explanation": "This workflow is specific to fact gathering and can be adapted for different search queries or tools.",
-  "source_repo": "https://github.com/jkmaina/LangGraphProjects.git",
-  "score": 1.0
-}