From 03b5beba17ee4361256604030143b6fa6c5d908e Mon Sep 17 00:00:00 2001 From: Hermes Pipeline Date: Wed, 5 Aug 2026 15:53:32 +0000 Subject: [PATCH] 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 | 84 +++++++++++++++++++++++++++ skills/agent-supervisor/commands.md | 6 ++ skills/agent-supervisor/examples.md | 10 ++++ skills/agent-supervisor/metadata.json | 81 ++++++++++++++++++++++++++ skills/agent-supervisor/tests.md | 9 +++ 5 files changed, 190 insertions(+) create mode 100644 skills/agent-supervisor/SKILL.md create mode 100644 skills/agent-supervisor/commands.md create mode 100644 skills/agent-supervisor/examples.md create mode 100644 skills/agent-supervisor/metadata.json create mode 100644 skills/agent-supervisor/tests.md diff --git a/skills/agent-supervisor/SKILL.md b/skills/agent-supervisor/SKILL.md new file mode 100644 index 0000000..d644365 --- /dev/null +++ b/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 diff --git a/skills/agent-supervisor/commands.md b/skills/agent-supervisor/commands.md new file mode 100644 index 0000000..9215767 --- /dev/null +++ b/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 diff --git a/skills/agent-supervisor/examples.md b/skills/agent-supervisor/examples.md new file mode 100644 index 0000000..6fae8dc --- /dev/null +++ b/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.'} +``` diff --git a/skills/agent-supervisor/metadata.json b/skills/agent-supervisor/metadata.json new file mode 100644 index 0000000..9b70a2f --- /dev/null +++ b/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 +} \ No newline at end of file diff --git a/skills/agent-supervisor/tests.md b/skills/agent-supervisor/tests.md new file mode 100644 index 0000000..57e9aee --- /dev/null +++ b/skills/agent-supervisor/tests.md @@ -0,0 +1,9 @@ +# 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 -- 2.43.0