CtrlK
BlogDocsLog inGet started
Tessl Logo

load-skill

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.

Install with Tessl CLI

npx tessl i github:fpl9000/ai-skills --skill load-skill
What are skills?

89

Does it follow best practices?

Validation for skill structure

SKILL.md
Review
Evals

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:

  1. 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.

  2. Validate the file: Verify the file exists and has a .skill extension.

  3. Extract the skill: Use unzip to extract the skill to a temporary directory. Use a command like:

    unzip -o "SKILLFILE" -d "TEMPDIR"
  4. 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).

  5. Read the skill: Read the entire SKILL.md file to understand the skill's capabilities and instructions.

  6. 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.

  7. 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.

  8. 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.

Repository
fpl9000/ai-skills
Last updated
Created

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.