# Benefit Groups Setup Task Guidance

> Provides task-specific setup guidance for Benefit Groups under the Benefits General Configuration functional area.

- Skill: `oracle/benefit-groups-setup-task-guidance` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx get-skill add oracle/benefit-groups-setup-task-guidance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oracle/benefit-groups-setup-task-guidance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: Oracle (https://skillmd.com/u/oracle)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/oracle/benefit-groups-setup-task-guidance

---


# Benefit Groups Setup Task Guidance

## Purpose

Provides task-specific setup planning, routing, export, import, and validation guidance for `Benefit Groups` under `Benefits General Configuration`.

## Setup Task Skill Contract

- task_code: `BEN_MANAGE_BENEFIT_GROUPS`
- task_name: `Benefit Groups`
- parent_skill_id: `hcm.benefits-configuration.benefits-general-configuration`
- pillar: `HCM`
- offering: `Benefits Configuration`
- functional_area: `Benefits General Configuration`
- functional_area_code: `ORA_BENEFITS_GENERAL_CONFIGURATION`
- available_flag: `Y`
- export_import_supported_flag: `N`
- csv_export_import_supported_flag: `N`
- dataloader_import_mode: `HDL`
- businessObject: `benefitGroups`
- source_catalog: `knowledge/setup-task-catalog/effective/setupTasksAll.json`

## Usage

Use this skill when planning, sequencing, exporting, importing, or validating setup data for `Benefit Groups` under `Benefits General Configuration`.

## Setup Task Metadata

- Task name: `Benefit Groups`
- Task code: `BEN_MANAGE_BENEFIT_GROUPS`
- Available: `Y`
- Export/import supported: `N`
- CSV export/import supported: `N`
- CSV export/import routing: `not supported`
- Data Loader import mode: `HDL`
- Business Object: `benefitGroups`

## HDL Business Object

Use `benefitGroups` as the HDL business object for this task. `Benefit Groups`
is the setup-task display name; use the current Fusion Data Loader sample to
confirm the DAT filename, section header, attributes, keys, and supported
operations before preparing an artifact.

When a `benefitGroups.LegalEmployer` value is supplied, validate it through
the read-only [legal employer lookup](ora-resource/ora_reference_lookups.md)
using `core.fusion-api.rest-api-client` only when the active project workflow
selects that lookup step. Query `legalEmployersLov` with `q=Name` and require
an exact `Name` match; preserve the supplied value. A 403 records
`unverified_forbidden` without failing field validation. It does not verify
the value, so resolve access or use another workflow-approved authoritative
check before a live load. If only `LegalEntityId` is supplied, do not infer a
`LegalEmployer` name or run this name lookup.

Read [input validation](ora-resource/ora_input_validation.md),
[reference lookups](ora-resource/ora_reference_lookups.md),
[dependency readiness](ora-resource/ora_dependency_readiness.md),
[defaulting](ora-resource/ora_defaulting_rules.md),
[design enforcement](ora-resource/ora_design_enforcement.md), and
[error handling](ora-resource/ora_error_handling.md) before preflight or live
activity. Keep DAT validation and loading on `core.data-loader`.

## CSV Export, Import, and Validation Workflow

`CSVExportImportSupportedFlag` is `N`, so this task is not marked as CSV export/import supported in the effective setup-task catalog.

Do not route CSV export work to `shared.setup-export.task-level-export` or CSV import work to `core.data-loader` unless live Fusion metadata or Oracle guidance confirms support. Use `shared.validation.setup-data-validator` only when a setup data artifact is available for review. Use `shared.validation.reference-data-validator` when the task depends on cross-pillar reference data.




## Inputs

- `implementation_objective`
- `project_context`
- `setup_task_scope`
- `setup_data_artifacts`

## Outputs

- `setup_task_plan`
- `setup_data_routing`
- `validation_checkpoints`
- `skill_run_record`
- `token_usage_record`

## Implementation Notes

Use the parent functional-area skill `hcm.benefits-configuration.benefits-general-configuration` for functional-area sequencing and scope decisions. Track token usage for any generated project artifact or skill-run record using the manifest policy.

