sequenceDiagram
    participant User
    participant SkillModal
    participant SkillInput
    participant useEditorSubblockLayout
    participant WorkflowBlock
    participant PermissionConfig
    participant SkillsAPI

    Note over User,SkillsAPI: Skill Creation/Edit Flow
    User->>SkillModal: Opens modal to create/edit skill
    SkillModal->>SkillModal: Validates name (kebab-case, max 64 chars)
    SkillModal->>SkillModal: Validates description (required)
    SkillModal->>SkillModal: Validates content (required)
    alt Validation Fails
        SkillModal->>User: Shows field-specific error messages
    else Validation Succeeds
        SkillModal->>SkillsAPI: createSkill or updateSkill mutation
        SkillsAPI-->>SkillModal: Success/Error response
        SkillModal->>User: Closes modal or shows general error
    end

    Note over User,SkillsAPI: Permission Check Flow
    User->>useEditorSubblockLayout: Opens editor panel
    useEditorSubblockLayout->>PermissionConfig: Check disableSkills flag
    alt Skills Disabled
        useEditorSubblockLayout->>User: Hides skill-input subblock
    else Skills Enabled
        useEditorSubblockLayout->>SkillInput: Renders skill-input component
    end

    Note over User,SkillsAPI: Skill Selection & Display Flow
    User->>SkillInput: Selects skill from dropdown
    SkillInput->>SkillsAPI: Fetch workspace skills
    SkillsAPI-->>SkillInput: Returns skill list
    SkillInput->>SkillInput: Stores {skillId, name} in value
    SkillInput->>User: Displays skill card with name and icon

    Note over User,SkillsAPI: Skill Name Hydration Flow
    User->>WorkflowBlock: Views block in workflow canvas
    WorkflowBlock->>SkillsAPI: Fetch workspace skills
    SkillsAPI-->>WorkflowBlock: Returns fresh skill data
    WorkflowBlock->>WorkflowBlock: Resolves skill names with priority:<br/>1. Fresh data from API<br/>2. Stored name (fallback)<br/>3. skillId (last resort)
    WorkflowBlock->>User: Displays hydrated skill names