dc-cli-skill

Copilot skill that wraps the Amplience dc-cli, teaching an agent what the CLI can do, how to invoke it, and when to confirm before mutating anything.

Safety model

Commands are classified into five tiers, each with its own confirmation requirement:

• Read-only — run freely
• Local-only write — confirm once
• Hub-mutating — confirm with explicit source/destination summary
• Destructive — confirm + a second confirmation
• Catastrophic (hub clean, hub clone, unfiltered *-archive/*-delete, anything with --force or --revertLog) — confirm twice + require an explicit phrase (hub ID or operation word)

Hard rules:

• Never invent hub IDs, client IDs, secrets, or PATs
• Never add --force / -f or --silent / -s without explicit opt-in
• Always preserve the --logFile (so rollback via --revertLog stays possible)
• Never run a two-hub command without confirming source and destination
• Treat --ignoreSchemaValidation, --allowDelete, --media as opt-in only

Installation

Clone this folder where your Copilot client picks up skills (typically ~/.copilot/skills/dc-cli/). It auto-loads on mentions of Amplience Dynamic Content management, dc-cli, exporting/importing content, hub migration, or bulk operations.

The skill assumes dc-cli is installed and configured:

npm i -g @amplience/dc-cli
dc-cli configure --patToken <YOUR_PAT> --hubId <YOUR_HUB_ID>
# or
dc-cli configure --clientId <ID> --clientSecret <SECRET> --hubId <HUB_ID>

@amplience/dc-cli is published on npmjs.org. If your npm/pnpm config has a scoped registry override (e.g. @amplience:registry=https://npm.pkg.github.com/), pass --registry=https://registry.npmjs.org/.

Coverage

All 12 dc-cli command categories:

Category	Capabilities
configure	Save credentials (client id/secret or PAT) to ~/.amplience/dc-cli-config.json
hub	add, list/ls, use, clone, clean
content-type-schema	list, get, create, update, import, export, archive, unarchive
content-type	list, get, register, update, sync, import, export, archive, unarchive
content-item	export, import, copy, move, archive, unarchive, tree, publish, unpublish, sync
content-repository	list, get, assign-content-type, unassign-content-type
linked-content-repository	list, create, update, delete (PAT only)
event	export, import, archive
settings	export, import
extension	export, import, delete
search-index	export, import
webhook	export, import, delete
job	get (PAT only)

Repository layout

dc-cli-skill/
├── README.md                # this file
├── SKILL.md                 # skill entry point — safety rules, workflow checklist
└── references/
    ├── command-reference.md # every flag for every command, classified by tier
    ├── facets.md            # facet syntax, regex, presets
    ├── mapping-files.md     # create-vs-update behaviour
    ├── file-formats.md      # export/import JSON shapes
    ├── workflows.md         # recipe-style end-to-end workflows
    └── safety.md            # destructive catalogue, rollback patterns, snapshot limits