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
ID, NAME, TEAM, USAGE (usage count), and UPDATED. If the response is paginated, the next cursor is printed at the bottom.
| Flag | Description |
|---|
--search | Filter skills by query string. |
--server | Filter to skills related to a specific MCP server ID. |
--limit | Maximum number of skills to return. |
--cursor | Pagination cursor from a previous list call. |
--json | Print 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
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
-o:
| Flag | Description |
|---|
-o, --output | File or directory to write to. Use - to write to stdout. |
--version-id | Download a specific skill version. |
--json | Print 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
