Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/restore-environment-skill-management.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@roomote/web': patch
---

Restore admin management of environment-scoped skills under a collapsed Settings section.
20 changes: 12 additions & 8 deletions apps/docs/skills.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,18 +38,22 @@ Instance skills are stored once for the Roomote instance, independently of
environments. Any member can create or read them. Only the creator or an admin
can edit or delete them; these permissions also apply to conversational creation.

Environment skills and marketplace installation controls are not shown in
**Settings > Skills**. Existing environment skills remain stored and available
to Roomote within their authorized environment scope. Admins manage them in
the environment editor's **YAML** view: use `manualSkills` for inline custom
instructions and `skills` for published skills. See the
[environment definition reference](/environments/definition#skills) for examples.
They are not automatically migrated, copied, or removed.
Admins can expand **Environment skills** below the shared catalog to create,
view, edit, or delete inline skills and choose the environments where they are
available. The section stays hidden from members and when no environments are
configured. Marketplace search and installation are separate from this
environment management section.

Admins can also manage environment skills in an environment's **YAML** view:
use `manualSkills` for inline custom instructions and `skills` for published
skills. See the [environment definition reference](/environments/definition#skills)
for examples. Existing environment skills are not automatically migrated,
copied, or removed.

| Skill type | How it is added | Availability |
| ----------------- | ---------------------------------------------------- | ---------------------------------------------------------------------- |
| Instance skill | Ask in conversation or use Add Skill in Settings | All Sessions and coding tasks on this instance |
| Environment skill | Admins edit `manualSkills` or `skills` in environment YAML | Selected environments only |
| Environment skill | Admins use Settings or edit `manualSkills` in environment YAML | Selected environments only |
| Repository skill | Maintain a skill in the repository | The authorized repository or environment scope |

Instance skills do not have an environment selection. Environment skills apply
Expand Down
223 changes: 223 additions & 0 deletions apps/web/src/components/settings/EnvironmentSkills.client.test.tsx

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading