I Can’t Edit My Skill in the Gumloop UI — Where Is the Edit Option?

Last updated: April 9, 2026

There's no inline editor for skill files in the Gumloop UI yet. To edit a skill after creating it, either ask your agent to make the changes in chat (with AI Skill Editing enabled), or download the skill files, edit them locally, and reupload.

Symptoms

  • You created a skill and want to change something in SKILL.md or another skill file.
  • You see an Edits tab on the skill detail page, but it only shows a history of past changes — there's no edit button or text editor.
  • You can preview the skill's file contents but can't modify them directly in the UI.

Why There's No Edit Button

The skill detail page is currently read-only. You can view the file tree (SKILL.md, references/, scripts/, assets/) and preview file contents, but the UI does not yet include an inline text editor. The Edits tab shows a timeline of all file-level changes (added, modified, removed) — it's a history log, not an editing interface.

A direct inline skill editor is on the roadmap.

How to Edit a Skill

Option 1: Ask Your Agent in Chat (Recommended)

Your agent can read, modify, and save skill files directly in its sandbox. This is the fastest approach and doesn't require you to download anything.

Prerequisites:

  • AI Skill Editing must be enabled on the agent. Open the agent, go to the Skills section, and make sure the skill editing toggle is turned on. When enabled, the agent can create new skills, update existing ones, and fix its own mistakes.

Example prompts you can try right now:

  • "Update my outreach-emails skill to always sign off with 'Thanks' instead of 'Best'."
  • "Add a new section to my support-triage skill for handling billing questions."
  • "Change the description in my weekly-report skill to mention it runs every Monday."

The agent will rewrite the relevant files and save them. You can verify the changes in the Edits tab on the skill detail page afterward.

Option 2: Download, Edit Locally, and Reupload

If you prefer to edit the markdown yourself or need to make precise changes:

  1. Go to the Skills page.
  2. Click the three-dot menu (⋮) on the skill you want to edit.
  3. Select Download to save the skill files to your computer.
  4. Open the SKILL.md file (and any other files) in a text editor and make your changes.
  5. Back on the Skills page, click Create Skill → Upload Files.
  6. Upload your edited files. The skill name in the SKILL.md frontmatter must match the original skill's folder name exactly — otherwise the upload creates a new skill instead of updating the existing one.

Tip: Skill names must be lowercase, use only letters, digits, and hyphens (no spaces or underscores), and can't exceed 64 characters. If the name: field in your SKILL.md doesn't match the folder name, the save will be skipped silently.

Common Gotchas

  • "My agent's skill edit didn't save." — Check that SKILL.md has valid YAML frontmatter (both name and description are required). If the frontmatter is malformed or missing a required field, the update is skipped and the previous version stays intact.
  • "I see my edit in the Edits tab but the agent still uses the old version." — Start a new conversation. Skills are loaded at conversation start. An in-progress conversation may be using the version that was loaded when it began.
  • "Two people edited the same skill and one change was lost." — If two conversations edit the same skill at the same time, the last one to finish wins. Coordinate edits to avoid conflicts.

Related Docs

Still Need Help?

If this didn't resolve your issue, reach out to support at support@gumloop.com.