FlameInTheDark/llm-tool-edge-rules
internal/skills/defaults/skills/llm-tool-edge-rules/SKILL.md
Rules for connecting `llm:agent` nodes to `tool:*` nodes in Emerald. Use when adding, moving, or validating agent tool wiring or explaining why a tool edge is invalid.
tools
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add FlameInTheDark/emerald llm-tool-edge-rulesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 29, 2026, 4:21 PM10.1s1 file scanned
SKILL.md
- name:
- llm-tool-edge-rules
- description:
- Rules for connecting `llm:agent` nodes to `tool:*` nodes in Emerald. Use when adding, moving, or validating agent tool wiring or explaining why a tool edge is invalid.
Use this skill when the task is specifically about agent tool wiring.
Connect Agent Tools Correctly
- Only
llm:agentnodes may connect totool:*nodes. - Use the agent node's
toolsource handle. - Set
sourceHandle: "tool"on the edge. - Target a real
tool:*node id.
Keep Tool Nodes Out Of The Main Flow
- Do not place tool nodes inline on the normal execution path.
- Do not connect normal action nodes to tool nodes.
- Do not connect tool nodes to logic or return nodes with normal edges.
Preserve Existing Tool Wiring
- Keep existing tool edge ids when editing unless replacement is required.
- When moving tool nodes visually, preserve the handle rules.
- When removing a tool node, also remove its agent tool edge.
Recognize Invalid Examples
action:http->tool:pipeline_runllm:prompt->tool:httpllm:agent->tool:httpwithoutsourceHandle: "tool"- Any normal edge that targets a
tool:*node
Keep Agent Setups Readable
- Group tool nodes near the agent visually.
- Keep the main flow easy to scan.
- Add only the tools the agent truly needs.
Related Skills
FlameInTheDark/templating-guide
devops
VerifiedTrustedCommunity
Guide for Emerald template interpolation, runtime context lookup, and pipeline parameter passing. Use when writing prompts, config fields, JSON params, or explaining how `input`, `arguments`, and other template values resolve.
SKILL.mdUpdated Apr 16, 2026
FlameInTheDark/pipeline-graph-rules
devops
VerifiedTrustedCommunity
Reference for valid Emerald node and edge topology, branching handles, and live-edit safety rules. Use when reasoning about graph structure, adding or removing nodes, reconnecting edges, or validating pipeline edits.
SKILL.mdUpdated Apr 16, 2026
FlameInTheDark/pipeline-builder
tools
VerifiedTrustedCommunity
Design, create, and safely edit Emerald pipelines. Use this skill when an LLM needs to produce valid nodes/edges JSON for pipeline tools or reason about existing workflows.
SKILL.mdUpdated Apr 16, 2026
FlameInTheDark/node-catalog
development
VerifiedTrustedCommunity
Compact reference for important Emerald node families, common config shapes, and when to use each category. Use when choosing nodes, understanding existing nodes, or mapping a user request to pipeline components.
SKILL.mdUpdated Apr 16, 2026