Skip to content

dft new

Scaffold new Dataface files from packaged skill examples. Each skill ships one or more example faces; dft new face materializes one of those examples into your project.

dft new [OPTIONS] COMMAND [ARGS]

Subcommands

Command Purpose
dft new face Scaffold a face YAML file from a skill example.

dft new face

dft new face [OPTIONS]

Options

Flag Description
--from TEXT Skill name to scaffold from. Required.
--example TEXT Example slug within the skill. Defaults to the first.
--out PATH Write target path. Default: print to stdout.
--force Overwrite existing file.

Examples

# Print a kpi-row example to stdout
dft new face --from kpi-row

# Write to a file
dft new face --from kpi-row --out faces/kpis.yml

# Overwrite an existing file
dft new face --from kpi-row --out faces/kpis.yml --force

# Pick a specific example from a multi-example skill
dft new face --from top-n-with-detail --example top-n-with-detail

Discovering skills

List the skills available to scaffold from:

dft skills

Show the body and examples of one skill:

dft skills kpi-row