From d40819cd939abf99fe8538e50611bd8b80d7719e Mon Sep 17 00:00:00 2001
From: Hermes Pipeline <hermes@agent.local>
Date: Wed, 5 Aug 2026 15:14:35 +0000
Subject: [PATCH] Add Skill: unifai-workflow-execution

Extracted from: https://github.com/redhat-community-ai-tools/UnifAI.git
Score: 1.0
---
 skills/unifai-workflow-execution/SKILL.md     | 96 +++++++++++++++++++
 skills/unifai-workflow-execution/commands.md  |  6 ++
 skills/unifai-workflow-execution/examples.md  | 10 ++
 .../unifai-workflow-execution/metadata.json   | 30 ++++++
 skills/unifai-workflow-execution/tests.md     |  9 ++
 5 files changed, 151 insertions(+)
 create mode 100644 skills/unifai-workflow-execution/SKILL.md
 create mode 100644 skills/unifai-workflow-execution/commands.md
 create mode 100644 skills/unifai-workflow-execution/examples.md
 create mode 100644 skills/unifai-workflow-execution/metadata.json
 create mode 100644 skills/unifai-workflow-execution/tests.md

diff --git a/skills/unifai-workflow-execution/SKILL.md b/skills/unifai-workflow-execution/SKILL.md
new file mode 100644
index 0000000..42e7218
--- /dev/null
+++ b/skills/unifai-workflow-execution/SKILL.md
@@ -0,0 +1,96 @@
+---
+name: unifai-workflow-execution
+version: 1.0.0
+description: Execute a multi-agent workflow on the UnifAI platform using a specified
+  blueprint and user prompt.
+inputs:
+- blueprint_id or blueprint_name
+- user_shortcut
+- user_question
+steps:
+- 'Step 1: Resolve the blueprint ID from either direct ID or name lookup (resolve_blueprint_id
+  method)'
+- 'Step 2: Create a new session from the blueprint (create_session method)'
+- 'Step 3: Submit the session for background execution with the user prompt (submit_session
+  method)'
+- 'Step 4: Poll session status until execution completes (poll_session_status method)'
+outputs:
+- session_id
+- workflow_id
+tags: []
+metadata:
+  source_repo: https://github.com/redhat-community-ai-tools/UnifAI.git
+  extracted_at: ''
+  confidence: 0.95
+---
+
+# unifai-workflow-execution
+
+Execute a multi-agent workflow on the UnifAI platform using a specified blueprint and user prompt.
+
+## Setup
+
+**Dependencies:**
+
+```text
+pip install requests urllib3
+```
+
+**Setup steps:**
+
+1. Install required dependencies using pip install requests urllib3
+1. Ensure the environment variables are set correctly (BLUEPRINT_ID, BLUEPRINT_NAME, USER_SHORTCUT, POLLING_INTERVAL, UNIFAI_BASE_URL)
+
+## Key Files
+
+- `scripts/execution_workflow.py - Main script for workflow execution`
+
+## Steps
+
+1. Step 1: Resolve the blueprint ID from either direct ID or name lookup (resolve_blueprint_id method)
+2. Step 2: Create a new session from the blueprint (create_session method)
+3. Step 3: Submit the session for background execution with the user prompt (submit_session method)
+4. Step 4: Poll session status until execution completes (poll_session_status method)
+
+## Implementation Details
+
+```python
+resolve_blueprint_id(client: UnifAIClient) -> str
+{...}
+# Resolve the blueprint ID from either direct ID or name lookup.
+```
+
+```python
+create_session(client: UnifAIClient, blueprint_id: str) -> str
+{...}
+# Create a new session from the blueprint.
+```
+
+```python
+submit_session(client: UnifAIClient, session_id: str) -> dict
+{...}
+# Submit the session for background execution with the user prompt.
+```
+
+## Inputs
+
+- blueprint_id or blueprint_name
+- user_shortcut
+- user_question
+
+## Outputs
+
+- session_id
+- workflow_id
+
+## Failure Modes
+
+- Blueprint name not found or not unique - error during blueprint resolution
+- Session creation fails - error from API response
+- Session submission fails - error from API response
+- Polling session status fails - error from API response
+
+## Source
+
+Extracted from: [https://github.com/redhat-community-ai-tools/UnifAI.git](https://github.com/redhat-community-ai-tools/UnifAI.git)
+Confidence: 0.95
diff --git a/skills/unifai-workflow-execution/commands.md b/skills/unifai-workflow-execution/commands.md
new file mode 100644
index 0000000..7f42284
--- /dev/null
+++ b/skills/unifai-workflow-execution/commands.md
@@ -0,0 +1,6 @@
+# Commands: unifai-workflow-execution
+
+## Available Commands
+
+- `/skill unifai-workflow-execution` — Load this skill
+- `/run unifai-workflow-execution` — Execute workflow
diff --git a/skills/unifai-workflow-execution/examples.md b/skills/unifai-workflow-execution/examples.md
new file mode 100644
index 0000000..34f1cbf
--- /dev/null
+++ b/skills/unifai-workflow-execution/examples.md
@@ -0,0 +1,10 @@
+# Examples: unifai-workflow-execution
+
+## Usage Example
+
+```python
+# How to use this skill
+# Inputs: blueprint_id or blueprint_name, user_shortcut, user_question
+# Process: Step 1: Resolve the blueprint ID from either direct ID or name lookup (resolve_blueprint_id method) → Step 2: Create a new session from the blueprint (create_session method) → Step 3: Submit the session for background execution with the user prompt (submit_session method)
+# Outputs: session_id, workflow_id
+```
diff --git a/skills/unifai-workflow-execution/metadata.json b/skills/unifai-workflow-execution/metadata.json
new file mode 100644
index 0000000..4d4a57e
--- /dev/null
+++ b/skills/unifai-workflow-execution/metadata.json
@@ -0,0 +1,30 @@
+{
+  "name": "unifai-workflow-execution",
+  "version": "1.0.0",
+  "goal": "Execute a multi-agent workflow on the UnifAI platform using a specified blueprint and user prompt.",
+  "inputs": [
+    "blueprint_id or blueprint_name",
+    "user_shortcut",
+    "user_question"
+  ],
+  "steps": [
+    "Step 1: Resolve the blueprint ID from either direct ID or name lookup (resolve_blueprint_id method)",
+    "Step 2: Create a new session from the blueprint (create_session method)",
+    "Step 3: Submit the session for background execution with the user prompt (submit_session method)",
+    "Step 4: Poll session status until execution completes (poll_session_status method)"
+  ],
+  "outputs": [
+    "session_id",
+    "workflow_id"
+  ],
+  "failure_modes": [
+    "Blueprint name not found or not unique - error during blueprint resolution",
+    "Session creation fails - error from API response",
+    "Session submission fails - error from API response",
+    "Polling session status fails - error from API response"
+  ],
+  "confidence": 0.95,
+  "explanation": "This workflow is specific to the UnifAI platform and its multi-agent system, but can be adapted for similar systems with a similar architecture.",
+  "source_repo": "https://github.com/redhat-community-ai-tools/UnifAI.git",
+  "score": 1.0
+}
\ No newline at end of file
diff --git a/skills/unifai-workflow-execution/tests.md b/skills/unifai-workflow-execution/tests.md
new file mode 100644
index 0000000..2d12683
--- /dev/null
+++ b/skills/unifai-workflow-execution/tests.md
@@ -0,0 +1,9 @@
+# Tests: unifai-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
-- 
2.43.0