id: https://nde.nl/ontology/hc/class/LanguageProficiency
name: language_proficiency_class
title: Language Proficiency Class
version: 1.0.0
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  dct: http://purl.org/dc/terms/
imports:
  - linkml:types
  - ../enums/LanguageProficiencyEnum
  - ../metadata
  - ../slots/has_or_had_score
  - ../slots/language_code
  - ../slots/language_name
  - ../slots/language_raw
  - ../slots/proficiency_level
default_range: string
default_prefix: hc
classes:
  LanguageProficiency:
    class_uri: hc:LanguageProficiency
    description: "A language skill with proficiency level.\n\nModels language abilities as extracted from LinkedIn profiles,\nwith both raw string and parsed components.\n\n**Schema.org Alignment**:\n- Represents schema:knowsLanguage relation\n- Language is schema:Language\n\n**Use Cases**:\n- LinkedIn profile language sections\n- Multilingual staff identification\n- Heritage institution language capabilities\n\n**Example JSON Values**:\n```json\n[\n  \"English - Native or bilingual\",\n  \"Dutch - Native or bilingual\",\n  \"French - Professional working proficiency\"\n]\n```\n\n**LinkedIn Proficiency Levels**:\n- Native or bilingual proficiency\n- Full professional proficiency  \n- Professional working proficiency\n- Limited working proficiency\n- Elementary proficiency\n"
    close_mappings:
    - schema:knowsLanguage
    - dct:language
    slots:
    - language_code
    - language_name
    - language_raw
    - proficiency_level
    - has_or_had_score
    slot_usage:
      language_raw:
        range: string
        examples:
        - value: English - Native or bilingual
        - value: Dutch - Professional working proficiency
      language_name:
        range: string
        examples:
        - value: English
        - value: Dutch
        - value: French
      language_code:
        range: string
        pattern: ^[a-z]{2}$
        examples:
        - value: en
        - value: nl
        - value: fr
      proficiency_level:
        range: LanguageProficiencyEnum
        examples:
        - value: NATIVE_BILINGUAL
    comments:
    - Inlined in LinkedInProfile.languages[] as multivalued list
    - Preserves raw LinkedIn format for provenance
    - ISO 639-1 codes enable language-based filtering
    see_also:
    - https://schema.org/knowsLanguage
    - https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: "['*']"