Upload, update, and download agent skills as files.
gumloop skills lets you manage agent skills as files on disk. Each skill is one or more files (markdown, JSON, anything) that an agent can read at runtime.
List skills
gumloop skills listgumloop skills list --search retrieval --limit 50
Prints ID, NAME, TEAM, USAGE (usage count), and UPDATED. If there are more results, the CLI prints the next cursor at the bottom.
Flag
Description
--search
Filter skills by query string.
--server
Filter to skills related to a specific MCP server ID.
The CLI creates the skill with all of the provided files atomically and prints the new skill ID on success.
Update a skill
Replace the files attached to an existing skill:
gumloop skills update skill_abc ./new-version.md
update is a full replace, not a merge. The update removes any existing file that isn’t in the new upload. To add a file without losing the existing ones, pass all of them: gumloop skills update skill_abc existing.md new.md.
Grab the skill ID from gumloop skills list.
Download a skill
gumloop skills download skill_abc
By default the CLI writes the file to the current directory under its original filename. Override the destination with -o:
Flag
Description
-o, --output
File or directory to write to. Use - to write to stdout.