| name | load-skill |
| description | Load, activate, and optionally install an AI skill from a .skill file. Use this skill when the user wants to load, activate, or use a skill file. The user can invoke this skill with slash command `/load-skill [ --install | -i ] SKILLFILE`, where SKILLFILE is the path to a .skill file. |
Load Skill
This skill loads, activates, and optionally installs another skill from a .skill file. Here's a screenshot of it being used in Claude Code, but it will work similarly in other AI agents.
Usage
/load-skill [ --install | -i ] SKILLFILE
Where:
SKILLFILE is the path to a .skill file (a ZIP archive containing skill content).--install or -i (optional) installs the skill permanently without prompting the user.
How to Process This Skill
When this skill is invoked, you (the AI agent) should:
-
Parse the arguments: Extract the skill file path and any switches from the arguments
provided. If --install or -i is present, note that the skill should be installed without
prompting. If no path is provided, ask the user for the path to the skill file.
-
Validate the file: Verify the file exists and has a .skill extension.
-
Extract the skill: Use unzip to extract the skill to a temporary directory. Use a
command like:
unzip -o "SKILLFILE" -d "TEMPDIR"
-
Locate SKILL.md: Find the SKILL.md file in the extracted contents. It may be at the
root level or inside a subdirectory (depending on how the skill was packaged).
-
Read the skill: Read the entire SKILL.md file to understand the skill's capabilities
and instructions.
-
Install the skill (if requested): If the --install or -i switch was provided and your
AI system has a designated skills folder where skills can be permanently installed, copy the
extracted skill folder there. This makes the skill available in future sessions without
needing to reload it. Do not prompt the user; proceed with installation automatically.
-
Activate the skill: Follow the instructions in the loaded skill's SKILL.md as if it
had been invoked directly. The loaded skill is now active for the remainder of the
conversation.
-
Clean up: After activating the skill, you may delete the temporary extraction directory.
Examples
User: /load-skill ./my-custom.skill
Agent: [Extracts skill, reads SKILL.md, activates skill]
User: /load-skill --install ./my-custom.skill
Agent: [Extracts skill, reads SKILL.md, installs skill, activates skill]
Notes
-
The .skill file format is a ZIP archive as defined by the Agent Skills specification at
https://agentskills.io.
-
If the skill file contains scripts in a scripts/ directory, those scripts become available
for use per the loaded skill's instructions.
-
If the skill file contains references in a references/ directory, read those files as
needed for additional context.
-
If the skill requires environment variables or prerequisites, inform the user before
proceeding.
