| name | gds-materialize-workspace |
| description | Use this skill only when the owner explicitly asks to clone or materialize a selected repository set on a device. Resolve selectors, local roots, clone modes, submodules, and resource limits before applying. Do not use it to clone the whole estate by default or synchronize existing checkouts. |
| disable-model-invocation | true |
Contract
Materialize only the requested repository subset with verified identities and
bounded resources.
Use when
- Selected repositories or a portfolio profile must become local checkouts.
Do not use when
- Existing checkouts only need synchronization.
- No explicit repository selector or device root is available.
Inputs
- Device profile, repository selector, workspace root, and materialization mode.
Preconditions
- Discover existing checkouts and path conflicts.
- Resolve provider identities and access without treating failures as absence.
- Run
gds repository materialize --plan per selected repository and obtain
approval for network and filesystem writes.
Workflow
- Recheck target paths, free resources, access, and plan digest.
- Materialize repositories with bounded concurrency and declared clone mode.
- Initialize declared submodules or package state only when policy requires.
- Validate repository anchors and register observed checkout state.
Stop conditions
Stop on path collision, identity mismatch, inaccessible repository, partial clone
incompatibility, stale plan, resource limit, or unexpected existing data.
Verification
Run gds repository materialize --verify <operation-id> --json and validate each
checkout identity.
Output
Return materialized, skipped, failed, and pre-existing checkouts, exact paths,
clone modes, identities, and recovery steps.
References
No additional runtime reference is required; use current device and repository identities.
