Add Skill: blacknode-text-concatenation-workflow

Extracted from: https://github.com/temiroff/Blacknode.git
Score: 1.0

skills/blacknode-text-concatenation-workflow/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: blacknode-text-concatenation-workflow
+version: 1.0.0
+description: Concatenate two text strings using a Blacknode graph of Text, Concat,
+  and Output nodes.
+inputs:
+- 'text_a: string'
+- 'text_b: string'
+steps:
+- Initialize a Blacknode Graph object.
+- Add a Text node with parameter value set to text_a.
+- Add a second Text node with parameter value set to text_b.
+- Add a Concat node (no parameters required).
+- Add an Output node (no parameters required).
+- Connect the 'value' output port of the first Text node to the 'a' input port of
+  the Concat node.
+- Connect the 'value' output port of the second Text node to the 'b' input port of
+  the Concat node.
+- Connect the 'value' output port of the Concat node to the 'value' input port of
+  the Output node.
+- Evaluate the graph by cooking the Output node's 'value' port to obtain the concatenated
+  result.
+outputs:
+- 'concatenated_text: string'
+tags: []
+metadata:
+  source_repo: https://github.com/temiroff/Blacknode.git
+  extracted_at: ''
+  confidence: 0.95
+---
+
+# blacknode-text-concatenation-workflow
+
+Concatenate two text strings using a Blacknode graph of Text, Concat, and Output nodes.
+
+## Steps
+
+1. Initialize a Blacknode Graph object.
+2. Add a Text node with parameter value set to text_a.
+3. Add a second Text node with parameter value set to text_b.
+4. Add a Concat node (no parameters required).
+5. Add an Output node (no parameters required).
+6. Connect the 'value' output port of the first Text node to the 'a' input port of the Concat node.
+7. Connect the 'value' output port of the second Text node to the 'b' input port of the Concat node.
+8. Connect the 'value' output port of the Concat node to the 'value' input port of the Output node.
+9. Evaluate the graph by cooking the Output node's 'value' port to obtain the concatenated result.
+
+## Inputs
+
+- text_a: string
+- text_b: string
+
+## Outputs
+
+- concatenated_text: string
+
+## Failure Modes
+
+- Node types 'Text', 'Concat', or 'Output' not registered in Blacknode runtime
+- Port name mismatches during edge creation
+- Missing input values causing empty concatenation
+- Graph evaluation error if cycles or disconnected required ports
+
+## Source
+
+Extracted from: [https://github.com/temiroff/Blacknode.git](https://github.com/temiroff/Blacknode.git)
+Confidence: 0.95

skills/blacknode-text-concatenation-workflow/commands.md

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

skills/blacknode-text-concatenation-workflow/examples.md

@@ -0,0 +1,10 @@
+# Examples: blacknode-text-concatenation-workflow
+
+## Usage Example
+
+```python
+# How to use this skill
+# Inputs: text_a: string, text_b: string
+# Process: Initialize a Blacknode Graph object. → Add a Text node with parameter value set to text_a. → Add a second Text node with parameter value set to text_b.
+# Outputs: concatenated_text: string
+```

skills/blacknode-text-concatenation-workflow/metadata.json

@@ -0,0 +1,33 @@
+{
+  "name": "blacknode-text-concatenation-workflow",
+  "version": "1.0.0",
+  "goal": "Concatenate two text strings using a Blacknode graph of Text, Concat, and Output nodes.",
+  "inputs": [
+    "text_a: string",
+    "text_b: string"
+  ],
+  "steps": [
+    "Initialize a Blacknode Graph object.",
+    "Add a Text node with parameter value set to text_a.",
+    "Add a second Text node with parameter value set to text_b.",
+    "Add a Concat node (no parameters required).",
+    "Add an Output node (no parameters required).",
+    "Connect the 'value' output port of the first Text node to the 'a' input port of the Concat node.",
+    "Connect the 'value' output port of the second Text node to the 'b' input port of the Concat node.",
+    "Connect the 'value' output port of the Concat node to the 'value' input port of the Output node.",
+    "Evaluate the graph by cooking the Output node's 'value' port to obtain the concatenated result."
+  ],
+  "outputs": [
+    "concatenated_text: string"
+  ],
+  "failure_modes": [
+    "Node types 'Text', 'Concat', or 'Output' not registered in Blacknode runtime",
+    "Port name mismatches during edge creation",
+    "Missing input values causing empty concatenation",
+    "Graph evaluation error if cycles or disconnected required ports"
+  ],
+  "confidence": 0.95,
+  "explanation": "Extracted from examples/converted_text_pipeline.py and referenced templates/text-pipeline.json in the Blacknode repo. This workflow is a foundational, dependency-free pattern for building directed graphs of typed nodes and is applicable to any simple data combination task.",
+  "source_repo": "https://github.com/temiroff/Blacknode.git",
+  "score": 1.0
+}

skills/blacknode-text-concatenation-workflow/tests.md

@@ -1,4 +1,4 @@
-# Tests: literature-review-with-traceable-ai-evidence
+# Tests: blacknode-text-concatenation-workflow
 
 ## Test Checklist
 

skills/literature-review-with-traceable-ai-evidence/SKILL.md

@@ -1,77 +0,0 @@
----
-name: literature-review-with-traceable-ai-evidence
-version: 1.0.0
-description: Enable researchers to ingest documents, asynchronously index them, and
-  interact with multi-agent AI to answer questions with verifiable citations to original
-  text.
-inputs:
-- Documents in PDF, Office, image, or text formats
-- Research questions or topics of interest
-- 'Optional: user model configuration via .env or settings'
-steps:
-- Upload documents to a project (via desktop app or web UI)
-- System asynchronously converts Office docs to PDF if needed, runs OCR to extract
-  text with coordinates, chunks and embeds into vector store
-- User starts a main research session or creates exploration branches without waiting
-  for indexing to finish
-- Leader agent receives query and delegates subtasks to researcher, reviewer, writer
-  subagents
-- Subagents perform hybrid retrieval and rerank to find relevant chunks with source
-  coordinates
-- Agents synthesize answers and return evidence with clickable citations that highlight
-  original pages
-- User verifies conclusions by navigating to cited source locations and can save notes
-  to research memory or mind map
-outputs:
-- AI-generated answers with traceable evidence (coordinates, page highlights)
-- Research session history with branches
-- Indexed document library for future queries
-- Mind maps or structured notes
-- Persistent run events for resuming sessions
-tags: []
-metadata:
-  source_repo: https://github.com/0verL1nk/PaperSage.git
-  extracted_at: ''
-  confidence: 0.85
----
-
-# literature-review-with-traceable-ai-evidence
-
-Enable researchers to ingest documents, asynchronously index them, and interact with multi-agent AI to answer questions with verifiable citations to original text.
-
-## Steps
-
-1. Upload documents to a project (via desktop app or web UI)
-2. System asynchronously converts Office docs to PDF if needed, runs OCR to extract text with coordinates, chunks and embeds into vector store
-3. User starts a main research session or creates exploration branches without waiting for indexing to finish
-4. Leader agent receives query and delegates subtasks to researcher, reviewer, writer subagents
-5. Subagents perform hybrid retrieval and rerank to find relevant chunks with source coordinates
-6. Agents synthesize answers and return evidence with clickable citations that highlight original pages
-7. User verifies conclusions by navigating to cited source locations and can save notes to research memory or mind map
-
-## Inputs
-
-- Documents in PDF, Office, image, or text formats
-- Research questions or topics of interest
-- Optional: user model configuration via .env or settings
-
-## Outputs
-
-- AI-generated answers with traceable evidence (coordinates, page highlights)
-- Research session history with branches
-- Indexed document library for future queries
-- Mind maps or structured notes
-- Persistent run events for resuming sessions
-
-## Failure Modes
-
-- Missing local Office/LibreOffice converter causes document conversion failure
-- First-time model download may be slow or require network
-- OCR may have low confidence on poor quality scans
-- Retrieval might miss context if chunking splits semantics
-- Multi-agent coordination could produce conflicting intermediate results
-
-## Source
-
-Extracted from: [https://github.com/0verL1nk/PaperSage.git](https://github.com/0verL1nk/PaperSage.git)
-Confidence: 0.85

skills/literature-review-with-traceable-ai-evidence/commands.md

@@ -1,6 +0,0 @@
-# Commands: literature-review-with-traceable-ai-evidence
-
-## Available Commands
-
-- `/skill literature-review-with-traceable-ai-evidence` — Load this skill
-- `/run literature-review-with-traceable-ai-evidence` — Execute workflow

skills/literature-review-with-traceable-ai-evidence/examples.md

@@ -1,10 +0,0 @@
-# Examples: literature-review-with-traceable-ai-evidence
-
-## Usage Example
-
-```python
-# How to use this skill
-# Inputs: Documents in PDF, Office, image, or text formats, Research questions or topics of interest, Optional: user model configuration via .env or settings
-# Process: Upload documents to a project (via desktop app or web UI) → System asynchronously converts Office docs to PDF if needed, runs OCR to extract text with coordinates, chunks and embeds into vector store → User starts a main research session or creates exploration branches without waiting for indexing to finish
-# Outputs: AI-generated answers with traceable evidence (coordinates, page highlights), Research session history with branches, Indexed document library for future queries, Mind maps or structured notes, Persistent run events for resuming sessions
-```

skills/literature-review-with-traceable-ai-evidence/metadata.json

@@ -1,37 +0,0 @@
-{
-  "name": "literature-review-with-traceable-ai-evidence",
-  "version": "1.0.0",
-  "goal": "Enable researchers to ingest documents, asynchronously index them, and interact with multi-agent AI to answer questions with verifiable citations to original text.",
-  "inputs": [
-    "Documents in PDF, Office, image, or text formats",
-    "Research questions or topics of interest",
-    "Optional: user model configuration via .env or settings"
-  ],
-  "steps": [
-    "Upload documents to a project (via desktop app or web UI)",
-    "System asynchronously converts Office docs to PDF if needed, runs OCR to extract text with coordinates, chunks and embeds into vector store",
-    "User starts a main research session or creates exploration branches without waiting for indexing to finish",
-    "Leader agent receives query and delegates subtasks to researcher, reviewer, writer subagents",
-    "Subagents perform hybrid retrieval and rerank to find relevant chunks with source coordinates",
-    "Agents synthesize answers and return evidence with clickable citations that highlight original pages",
-    "User verifies conclusions by navigating to cited source locations and can save notes to research memory or mind map"
-  ],
-  "outputs": [
-    "AI-generated answers with traceable evidence (coordinates, page highlights)",
-    "Research session history with branches",
-    "Indexed document library for future queries",
-    "Mind maps or structured notes",
-    "Persistent run events for resuming sessions"
-  ],
-  "failure_modes": [
-    "Missing local Office/LibreOffice converter causes document conversion failure",
-    "First-time model download may be slow or require network",
-    "OCR may have low confidence on poor quality scans",
-    "Retrieval might miss context if chunking splits semantics",
-    "Multi-agent coordination could produce conflicting intermediate results"
-  ],
-  "confidence": 0.85,
-  "explanation": "The README describes PaperSage's core workflow: asynchronous document ingestion with OCR/indexing, followed by multi-agent question answering with cited evidence. This process is not tied to the specific codebase and can be reused as a general literature review methodology for any document-centric research using RAG and agent collaboration.",
-  "source_repo": "https://github.com/0verL1nk/PaperSage.git",
-  "score": 1.0
-}