Quick Ref / Command

Marketing Kit

/ak:ckm-storage

S3 storage router

Routes S3 storage work to list, sync, upload, or URL retrieval references, then executes the remaining arguments.

01

Parse subcommand

02

Route reference

03

List assets

04

Sync folders

Rule 01

Keep the command as a thin router over documented S3 operations.

Rule 02

Use only the listed storage subcommands: list, sync, upload, and url.

Rule 03

Load the matching reference before executing action-specific behavior.

Execution Map

Core lanes from input to output, aligned with the command's real execution path.

01

Start

Input, scope, route

  1. 1 Parse subcommand Read the first word from the arguments as the intended storage action.
  2. 2 Route reference Load references/list.md, sync.md, upload.md, or url.md according to the subcommand.
02

Work

Agent / skill execution

  1. 3 List assets Use list when the user needs to inspect available S3 objects or storage state.
  2. 4 Sync folders Use sync <folder> [remote-prefix] [--dry-run] [--extensions=.png,.jpg] when local and bucket contents need to be reconciled. Dry-run returns proposed object keys; a live run uploads matching files.
03

Verify

Gate, review, validation

  1. 5 Upload files Use upload for one-off file or asset publication to S3.
  2. 6 Return URLs Use url when the user needs retrievable links for stored objects.
04

Close

Report, handoff, artifact

  1. 7 Execute remainder Pass the remaining arguments to the loaded reference workflow.

Sample Prompt

Concrete invocations for each flag, subcommand, mode, or route available in the live workflow.

List storage Recommended
/ak:ckm-storage list
Use when:
Use when you need to inspect objects or bucket contents.
Expected:
The list reference is loaded and the storage listing action runs.
Dry-run filtered sync
/ak:ckm-storage sync assets/ --dry-run --extensions=.png,.jpg
Use when:
Use when a local asset folder should be previewed and filtered before upload.
Expected:
The sync workflow scans matching files and reports proposed object keys without uploading.
Upload file
/ak:ckm-storage upload assets/banner.png
Use when:
Use to publish a specific file to storage.
Expected:
The upload reference guides the file upload.
Get object URL
/ak:ckm-storage url assets/banner.png
Use when:
Use when a stored object needs a retrievable link.
Expected:
The URL reference returns or builds the object link.

Handled Scope

  • Parse subcommand
  • Route reference
  • List assets
  • Sync folders
  • Upload files
  • Return URLs

Next