# Gumloop 官方文档 — Skills（完整版）

> 来源：https://docs.gumloop.com/core-concepts/skills.md
> 抓取日期：2026-06-03
> 关联版本：v9.11.0 "Huntsville"
> 关联 Spec：spec_shared-organization-skills.md

---

## Skills Overview

Skills are reusable knowledge packs — folders containing instructions, scripts, references, and assets — that teach agents how to do specific work.

## Skill Structure

```
skill-name/
  SKILL.md          ← Required: instructions & frontmatter
  scripts/          ← Optional: executable code
  references/       ← Optional: detailed docs
  assets/           ← Optional: templates, images
```

## Organization-Level Sharing

The Skills page has a tab structure:
- **Mine** — skills the user created
- **Shared with me** — skills that others have shared with you directly or via your organization
- **Organization** — All skills visible to your entire organization

Visibility rules:
- Personal skills: visible only to the creator
- Team skills: Visible to all team members
- Skills cannot be shared directly with individual users at this time

## Attaching Skills to Agents

- Personal assistant agents automatically have access to all skills in your space — using semantic search against skill descriptions
- Custom agents only see skills explicitly attached to them (listed in the system prompt, ~50-100 tokens per skill)
- Custom agent created skills auto-attach; general agent skills go to library but not auto-attached

## Permission Tiers

- **Creator**: can always rename and delete
- **Team/project member**: If author is the project, any member can manage
- **Everyone else**: View and use only, cannot modify or delete

Bulk delete available from Skills table (only skills you have permission to manage).

Soft delete: deleted skills marked inactive, potentially recoverable by support.

## Skill Editing & Creation Toggle

- Located in agent's Tools configuration
- Enabled by default
- Enabled: agent can create/update/fix skills (compound learning)
- Disabled: agent can still read and use skills, but cannot modify
- Global scope: applies to all skills on the agent, not per-skill
- Concurrent edit risk: last write wins

## Version History

The Edits tab shows a full timeline of file-level changes with attribution (which agent made each edit).

## Save Failure Edge Cases
- Invalid frontmatter (missing name/description or malformed YAML)
- Rename mismatch (folder name != name field)
- Concurrent edits (last-write-wins)

---
*文档由 Claude 竞品情报系统整理 · 原始来源：docs.gumloop.com*