Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

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 list
gumloop skills list --search retrieval --limit 50
Prints ID, NAME, TEAM, USAGE (usage count), and UPDATED. If the response is paginated, the next cursor is printed at the bottom.
FlagDescription
--searchFilter skills by query string.
--serverFilter to skills related to a specific MCP server ID.
--limitMaximum number of skills to return.
--cursorPagination cursor from a previous list call.
--jsonPrint the raw response payload.

​
Create a skill

Upload one or more files as a new skill: 
gumloop skills create ./my-skill.md
gumloop skills create skills/*.md
The skill is created with all of the provided files atomically. The new skill ID is printed 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. Any file that was attached to the skill but isn’t in the new upload is removed. 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 file is written to the current directory under its original filename. Override the destination with -o:
FlagDescription
-o, --outputFile or directory to write to. Use - to write to stdout.
--version-idDownload a specific skill version.
--jsonPrint download metadata as JSON (path + bytes).
gumloop skills download skill_abc -o ./local-name.md
gumloop skills download skill_abc -o -                    # write to stdout
gumloop skills download skill_abc --version-id skv_xyz