Load llama.cpp Skill:
LLamaCppSkill loads a skill from a folder and packages its instructions and supporting material into a structured value for other compatible nodes. It reads the folder’s SKILL.md as the main instruction, and can also collect supported text files and image paths from the folder and its subfolders. This helps you keep a skill’s guidance and related assets together rather than assembling them separately in your workflow. The node loads these materials; it does not generate images or run a model by itself.
Load llama.cpp Skill Input Parameters:
skill
The required skill-folder selection. The dropdown shows folders found by the extension’s skill scan; its available options depend on what is installed in your environment, so there is no fixed list. Its default is the first available option, or an empty selection if none are found. Choose the folder containing the skill you want to load. You can use the dropdown’s built-in search to narrow a long list. The selected folder must exist and contain a file named SKILL.md; capitalization of that filename does not matter.
skill_override
An optional string that lets you enter a skill-directory path manually, including a folder outside the scanned locations. The default is an empty string, which leaves the skill dropdown selection in effect; when you provide an override, it takes priority. The tooltip also identifies none as a way to turn off the skill selection, but this node cannot return an empty skill: running it with no effective selection raises an error. There is no specified length limit for this field.
include_files
An optional Boolean setting, defaulting to True. When enabled, the node searches the skill folder and its subfolders for files with supported text extensions, reads them as UTF-8, and combines their contents into the output’s reference text. Each included file is labeled with its path relative to the skill folder. Set this to False if you need only the main instruction and, optionally, images. This setting does not control whether SKILL.md is read as the main instruction.
include_images
An optional Boolean setting, defaulting to True. When enabled, the node searches the skill folder and its subfolders for files with supported image extensions and adds their file paths to the output. Set it to False when you do not need image paths. The images are listed as paths; this node does not convert them into image data.
max_file_chars
An optional integer setting that limits the number of characters read from each included text reference. Its default is 8000, its minimum is 0, and its maximum is 100000. If a reference is longer than a positive limit, the node keeps its beginning and appends ...[truncated]. Set a smaller positive value to keep lengthy references concise, or set 0 to disable this truncation. This limit applies to collected reference files, not to the main SKILL.md instruction.
Load llama.cpp Skill Output Parameters:
skill
A single LLAMACPP_SKILL value containing the loaded skill information. Its name is the skill folder’s name, and its instruction is the full text read from SKILL.md. Its references value is one combined text string containing any successfully read, supported text files, with relative-path headings; it is empty when no references are collected. Its images value is a list of paths to supported image files and is empty when none are collected. Connect this output to a node that accepts LLAMACPP_SKILL.
Load llama.cpp Skill Usage Tips:
- Keep a readable UTF-8
SKILL.mdin the skill folder. The node requires it even when both optional collection settings are off. - Use the
skilldropdown’s search for folders already found by the extension. Useskill_overridewhen your skill folder is elsewhere; an entered override takes precedence over the dropdown. - Turn off
include_filesorinclude_imageswhen you do not need those materials. This also avoids scanning and collecting that type of supporting content. - Start with the default
max_file_charsof8000for references. Lower it when long files add more text than you need, raise it when important details are cut off, or use0when you need complete reference files. - Check the contents of the skill folder before loading it: supported text files, including
SKILL.mdif its extension is recognized as text, may also appear inreferenceswheninclude_filesis enabled.
Load llama.cpp Skill Common Errors and Solutions:
no skill selected (dropdown empty, or someone typed 'none' into 'skill_override')
- Explanation: The node has no effective skill folder to load. The dropdown may be empty, or
skill_overridemay be set tonone. - Solution: Select an available skill folder, or enter the path to a valid skill directory in
skill_override. Removenonebefore running this node.
skill directory not found: <path>
- Explanation: The selected or overridden path does not point to an existing directory.
- Solution: Check the folder path for spelling mistakes, confirm the folder still exists, and remember that a nonempty
skill_overridetakes precedence over the dropdown selection.
no SKILL.md found in <path>
- Explanation: The skill directory exists, but the node could not find
SKILL.mddirectly inside it. Filename capitalization does not matter. - Solution: Put
SKILL.mdin the selected folder itself, not only in a subfolder, and confirm thatskill_overridepoints to the intended folder.
UnicodeDecodeError while reading SKILL.md
- Explanation: The node reads the main instruction as UTF-8; a file saved with an incompatible encoding may fail to load.
- Solution: Open
SKILL.mdin a text editor and save it as UTF-8, then run the node again.
PermissionError or another file-access error
- Explanation: The node may be unable to list the skill directory, open
SKILL.md, or walk its subfolders because of file permissions or an inaccessible location. - Solution: Make sure the application can access the folder and read
SKILL.md. If the skill is on a disconnected or restricted drive, move it to an accessible location or restore access.
A reference file is missing from references
- Explanation: The node collects only files with supported text extensions when
include_filesis on. It also skips a reference file if opening or decoding that file fails. - Solution: Enable
include_files, check that the file uses a supported text extension, and save it as readable UTF-8 text. Check access permissions if it still does not appear.
Reference text ends with ...[truncated]
- Explanation: A collected text file exceeded the positive
max_file_charslimit. This is expected truncation, not a loading failure. - Solution: Increase
max_file_charswithin its allowed range, or set it to0to include the complete reference file.
images is empty or an expected image is missing
- Explanation: Image collection may be turned off, or the file may not have an extension recognized by the node’s supported image list.
- Solution: Enable
include_imagesand check the image file’s extension and location within the selected skill folder.
