Vault Management

​

Vault Types

​

Personal Vaults

• Owner: Individual user account
• Visibility: Private to the owner
• Use case: Personal skill libraries, private notes, experimental work
• Collaboration: Not supported (use enterprise vaults instead)

​

Enterprise Vaults

• Owner: Organization or team
• Visibility: Shared among invited members
• Use case: Team knowledge bases, company skills, collaborative documentation
• Collaboration: Full support with role-based access control
• Customization: Custom colors for visual identification

​

System Default

• Owner: Better Skills platform
• Visibility: Read-only for all users
• Use case: Built-in skills, examples, templates
• Collaboration: Not applicable (read-only)

​

Creating Vaults

# Create a personal vault
better-skills vault create my-vault

# Create an enterprise vault
better-skills vault create team-vault --type enterprise

​

Vault Settings

​

Viewing Vault Memberships

• Vault name - Primary identifier
• Type badge - Personal, Enterprise, or Default
• Role badge - Your role (owner, admin, member)
• Slug - URL-friendly identifier (e.g., /my-vault)
• Color indicator - Enterprise vault color (if set)
• Status badges - Read-only, Disabled states

​

Vault Metadata

{
  name: string                    // Display name
  slug: string                    // URL identifier
  type: "personal" | "enterprise" | "system_default"
  color: string | null            // Hex color for enterprise vaults
  isEnabled: boolean              // Active/disabled state
  isReadOnly: boolean             // Write permission
  isSystemManaged: boolean        // Platform-managed flag
  role: "owner" | "admin" | "member" // Your membership role
}

​

Enabling and Disabling Vaults

​

Vault Enable/Disable Toggle

• Enabled vaults (default):
  • Skills appear in search results
  • Show in the graph visualization
  • Sync with CLI and API
  • Button shows “Disable”
• Disabled vaults:
  • Skills remain in the database but hidden from UI
  • Excluded from search and graph
  • CLI sync skips disabled vaults
  • Button shows “Enable” with primary styling

​

How to Disable a Vault

1. Navigate to /settings
2. Scroll to the Vaults section
3. Find the vault you want to disable
4. Click the Disable button
5. Confirm the action (vault status updates immediately)

​

How to Re-enable a Vault

1. Navigate to /settings
2. Scroll to the Vaults section
3. Find the disabled vault
4. Click the Enable button
5. Vault becomes active again

​

Managing Memberships

​

Viewing Members (Enterprise Vaults)

1. Navigate to /settings
2. Scroll to Enterprise Mailbox section
3. Select your enterprise vault from the dropdown (if managing multiple)
4. View the Members list showing:
   • Member name
   • Email address
   • Current role (owner, admin, member)
   • Action buttons (Set admin/member, Remove)

​

Member Roles

• Full control over the vault
• Cannot be removed or demoted
• Only one owner per vault

• Invite new members
• Manage member roles
• Update vault settings (color, etc.)
• Cannot remove the owner

• Read and write access to skills
• Cannot invite or manage other members
• Cannot change vault settings

​

Updating Member Roles

1. Locate the member in the Members list
2. Click Set admin or Set member button
3. Confirm the role change in the dialog
4. Member’s permissions update immediately

​

Removing Members

1. Locate the member in the Members list
2. Click the Remove button (red text)
3. Confirm removal in the dialog
4. Member loses access immediately

​

Inviting Collaborators

​

Sending Invitations

1. Navigate to /settings
2. Scroll to Enterprise Mailbox → Enterprise Admin
3. Enter the recipient’s email address
4. Select a role (Member or Admin)
5. Click Invite

​

Invitation Form

┌─────────────────────────────────────────────┐
│ [email protected]  │  [Member ▼]  │ [Invite] │
└─────────────────────────────────────────────┘

• Email input - Recipient’s email (required)
• Role selector - Member or Admin
• Invite button - Submit invitation

​

Managing Pending Invitations

1. Navigate to /settings
2. Scroll to Enterprise Mailbox → Pending Invitations
3. See all invitations with:
   • Vault name
   • Vault type and slug
   • Assigned role
   • Accept and Decline buttons

• Click Accept (green checkmark icon)
• You gain immediate access to the vault
• Vault appears in your Vaults list

• Click Decline (red X icon)
• Invitation is removed
• You do not gain access to the vault

​

Vault Colors

​

Setting Enterprise Vault Colors

1. Navigate to /settings
2. Scroll to Enterprise Admin panel
3. Select your enterprise vault (if managing multiple)
4. Click the color picker input
5. Choose a color from the picker or enter a hex value
6. Click Save color

• Vault badges in the UI
• Graph node colors
• Skill list indicators
• Settings panel vault entries

​

Color Picker Interface

┌─────────────────────────────────────────────┐
│ Vault color is used across badges and graph nodes. │
│ [Color Picker] [#6b7280] [Save color]      │
└─────────────────────────────────────────────┘

• Visual preview - See the color in real-time
• Hex input - Enter precise color codes
• Save button - Apply the color to the vault

​

Vault Visibility in the UI

​

Graph Visualization

• Color-coded nodes (using vault color for enterprise vaults)
• Vault legend in the graph panel
• Visual distinction between vault types

​

Skills List

• Vault type badges
• Color indicators for enterprise vaults
• Vault name on skill detail pages

​

Search Results

• Include skills from all enabled vaults
• Exclude disabled vaults
• Show vault context for each result

​

Read-Only Vaults

• System default vaults are always read-only
• Enterprise vaults can be set to read-only by the owner
• Personal vaults owned by you are never read-only

• Allow viewing skills and resources
• Prevent editing, creating, or deleting content
• Show a “Read only” badge in the UI