Skip to content

dft skills

List packaged agent skills, or show one by name. Skills are the AI-facing knowledge packs that ship with Dataface — each one teaches an AI assistant a specific authoring pattern (e.g. kpi-row, top-n-with-detail, before-after-comparison).

dft skills [OPTIONS] [NAME]

Arguments

Argument Description
NAME Skill name to show. Omit to list all skills.

Options

Flag Description
-s TEXT, --search TEXT Search skill names, descriptions, and bodies.
--limit INTEGER Max search hits to return (default 10, max 25).
--json Output as JSON.

Examples

dft skills                  # List every packaged skill
dft skills kpi-row          # Show the kpi-row skill body (markdown)
dft skills kpi-row --json   # Same skill, JSON-shaped

How skills are used

  • File install (recommended). dft init skills copies CLI-rendered skills to your agent skill directories. After pip install -U dataface, re-run dft init skills to pick up new or updated skills.
  • MCP server. dft mcp serve exposes skills as tools that AI agents can call.
  • dft chat. The packaged terminal agent loads skills automatically.
  • Zero-install fallback. dft skills <name> prints a skill body without file install — useful in CI or when you only need to read the content.
  • Reading skill examples. Skills carry example YAML — dft skills <name> prints the body including any examples you can copy directly.