Agent skill

Dfcx Framework Ingestor

by GoogleCloudPlatform in GoogleCloudPlatform/cxas-scrapi

Parsing and Ingestion directives for the Dialogflow CX (DFCX) agent structure.

Apache-2.0Auto-check passedBackend & APIs

Install Dfcx Framework Ingestor

skills CLI
$ npx skills add GoogleCloudPlatform/cxas-scrapi --skill dfcx-framework-ingestor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install GoogleCloudPlatform/cxas-scrapi dfcx-framework-ingestor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/GoogleCloudPlatform/cxas-scrapi.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/cxas-cuj-report-generator/ingestors/frameworks/dfcx .claude/skills/dfcx-framework-ingestor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dfcx-framework-ingestor
GitHub stars
107
Token cost
~1.7k tokens
SKILL.md length
583 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
Apache-2.0

At a glance

Parsing and Ingestion directives for the Dialogflow CX (DFCX) agent structure.

  • Works in 3 steps: DFCX Export Package Layout → Ingestion & Flow Tracing Directives → Dialogue Simulation & Transcript…
  • Backend & APIs work in your project
  • SKILL.md covers 1. DFCX Export Package Layout, 2. Ingestion & Flow Tracing… and 3. Dialogue Simulation &…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Dfcx Framework Ingestor is an agent skill from GoogleCloudPlatform/cxas-scrapi. Parsing and Ingestion directives for the Dialogflow CX (DFCX) agent structure.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs. The repository describes itself as: A powerful Python API, CLI, and set of Agent Skills for CX Agent Studio to automate, evaluate, and scale your agents with ease. The licence is Apache-2.0.

When your agent uses it

  • Backend & APIs work in your project

Example prompts

  • “/dfcx-framework-ingestor”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. DFCX Export Package Layout
  2. Ingestion & Flow Tracing Directives
  3. Dialogue Simulation & Transcript Guidelines

What it can do on your machine

Read from SKILL.md and the folder at commit ffba639. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dfcx Framework Ingestor loads about 1.7k tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 583 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from GoogleCloudPlatform/cxas-scrapi at commit ffba639, republished under its Apache-2.0 licence (© GoogleCloudPlatform). 583 words, ~1,694 tokens.

Download SKILL.mdSave it as .claude/skills/dfcx-framework-ingestor/SKILL.md (or your agent's skills folder).
name
dfcx-framework-ingestor
description
Parsing and Ingestion directives for the Dialogflow CX (DFCX) agent structure.

Dialogflow CX Ingestor Skill

This skill standardizes the ingestion, parsing, and behavior extraction of conversational agents exported in the official, public Dialogflow CX (DFCX) format.


1. DFCX Export Package Layout

An official Dialogflow CX agent export is packaged as a .zip archive. When extracted, it conforms to the following public directory layout:

<agent_zip_root>/
├── agent.json                       # Global agent metadata (default language, timezone, display name)
├── intents/                         # Declared intents and training phrases
│   └── <intent_name>/
│       └── <intent_name>.json       # Intent configuration
├── entityTypes/                     # Custom entity declarations
│   └── <entity_name>/
│       └── <entity_name>.json       # Entity configuration and synonyms
├── transitionRouteGroups/           # Shared flow-level transition groups
├── webhooks/                        # Declared webhooks and backend REST integrations
│   └── <webhook_name>.json          # Webhook configuration (defining target URI and credentials)
└── flows/                           # Subfolders representing individual Flows
    └── <flow_name>/                 # Flow directory (e.g., Default Start Flow, Billing)
        ├── <flow_name>.json         # Flow configuration listing flow-level transition routes and entry points
        ├── transitionRouteGroups/   # Shared transition route groups specific to this flow
        └── pages/                   # Directory containing individual page configurations
            └── <page_name>.json     # Page definition containing entry prompts, form parameters, and transitions

2. Ingestion & Flow Tracing Directives

The Ingestor Agent MUST parse the extracted file structures using standard directory traversal and JSON parsing, mapping them to the primary coverage checklist:

A. CUJ Mapping
  • CUJ Discovery: Treat each Flow folder under flows/ (e.g., flows/Default Start Flow/ or flows/Billing Flow/) as a high-level Parent CUJ. The folder's directory name represents the CUJ title.
B. Sub-intent & Trigger Extraction

For each Flow, traverse <flow_name>.json and all .json files inside its pages/ subdirectory:

  1. Flow-Level Transition Routes:
    • Parse the "transitionRoutes" array inside <flow_name>.json.
    • Identify each transition triggered by an intent (where "intent" is declared, e.g., projects/.../intents/<intent_id>).
    • Map each unique triggered transition as a Sub-intent / Scenario (using the target page/flow name to synthesize its name).
  2. Page-Level Transition Routes:
    • For each page .json inside pages/, parse the "transitionRoutes" array to map conversational branches and trigger conditions.
  3. Form Parameter nodes:
    • Parse the "form.parameters" array inside a page JSON.
    • Each parameter collected (e.g., email_address, postal_code) represents a sub-intent step in the conversational walkthrough.
  4. Fulfillment Webhooks:
    • Identify "triggerFulfillment.webhook" inside transition routes or page configs.
    • Resolve the webhook's target endpoint destination URI by looking up its matching configuration file inside the global webhooks/ directory (e.g. webhooks/<webhook_name>.json's "genericWebService.uri").
    • Note: Webhooks represent standard REST integrations defined as toolsets (indexed via OpenAPI specifications open_api_schema.yaml under the toolsets/ directory).
C. Alignment with Canonical cxas-agent-migration Standards

When parsing Dialogflow CX layouts, the Ingestor Agent SHOULD align the extracted behaviors with the open-source cxas-agent-migration topology (N->M agents consolidation):

  1. Playbook/Flow to Agent Persona: Each extracted Flow directory represents a distinct sub-agent boundary. Treat the flow's transitions and event handlers as the sub-agent's private prompt limits and routing callbacks.
  2. Deduplicate & Group Variables: Consolidate intent parameters and page forms variables using cxas-agent-migration Stage 1 rules (variable deduplication) to avoid parameter bloat in transcripts.
  3. Topological Rewiring: Track the source dependency graph (parent flows -> children flows) using cxas-agent-migration Stage 3 rules, ensuring that transitions from steering accurately reflect the legacy DFCX intent routing.

Show full SKILL.md (206 more words)Show less

3. Dialogue Simulation & Transcript Guidelines

When simulating conversation transcripts based on parsed DFCX folder packages, enforce the following rules:

A. Verbatim Prompts Extraction

To guarantee the simulated agent speaks the exact developer-defined prompts, parse the fulfillment blocks:

  1. Page Entry Prompts:
    • Read "entryFulfillment.messages" inside pages/<page_name>.json.
    • Extract speech variants under "text": {"text": [...]}. The simulated Agent turn MUST output this string verbatim.
  2. Form Slot-Filling Prompts:
    • Read "initialPromptFulfillment.messages" inside "form.parameters[].fillBehavior" in the page JSON.
    • The simulated Agent turn asking for the parameter MUST output these prompt strings verbatim.
  3. Transition Prompts:
    • Read "triggerFulfillment.messages" inside transition routes.
B. Programmatic Flow Traversal & Intent Discovery

To discover conversational paths and map execution sequences:

  1. Flow Start Point: Access flows/<flow_name>/<flow_name>.json and locate the "transitionRoutes" inside the root flow config. These define the entry intents (e.g. "intent": "support_request").
  2. State Traversal:
    • For each route, trace the target node: if the target is a sub-flow (e.g. "targetFlow": "flows/Billing/"), pivot to that sub-flow config.
    • If the target is a page (e.g. "targetPage": "Collect Email"), load and parse the page configuration file pages/Collect Email.json.
  3. Fulfillment Sequence Tracking:
    • Trace visited pages in chronological order along the path to extract the sequential webhook invocations (triggerFulfillment.webhook) and parameter mappings, mapping each valid end-to-end path as a scenario sequence.

© GoogleCloudPlatform, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/cxas-cuj-report-generator/ingestors/frameworks/dfcx of GoogleCloudPlatform/cxas-scrapi.

Open the folder on GitHubat commit ffba639

Compare with similar skills

Dfcx Framework Ingestor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dfcx Framework Ingestor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dfcx Framework Ingestor this skillGoogleCloudPlatform/cxas-scrapi107—~1.7kAutomated safety check: PassApache-2.0
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api43k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    43k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed

More from GoogleCloudPlatform/cxas-scrapi

All 14 skills in this repo
  • Cxas Agent Foundry

    GoogleCloudPlatform/cxas-scrapi

    End-to-end GECX/CXAS/CES conversational agent lifecycle -- build agents from requirements (PRD-to-agent), create and run evals (goldens, simulations, tool tests, callback tests), debug failures, and…

    107 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Cxas Autolabel Rules

    GoogleCloudPlatform/cxas-scrapi

    Author, validate, and manage Contact Center AI (CCAI) Insights Autolabeling Rules.

    107 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Cxas Configurable Dashboards

    GoogleCloudPlatform/cxas-scrapi

    Author, validate, and manage Contact Center AI (CCAI) Insights Configurable Dashboards.

    107 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Cxas Dfcx Migration

    GoogleCloudPlatform/cxas-scrapi

    Migrate Dialogflow CX (DFCX) agents to CXAS (Customer Experience Agent Studio) agents.

    107 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • Cxas Loss Analysis

    GoogleCloudPlatform/cxas-scrapi

    Retrieves non-contained CCAI Insights conversations (losses), uses agent intelligence to cluster them into common failure patterns, and generates a markdown report.

    107 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Cxas Sim Eval

    GoogleCloudPlatform/cxas-scrapi

    Converts CXAS golden evaluations to SCRAPI SimulationEvals test cases.

    107 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Dfcx Framework Ingestor

What does Dfcx Framework Ingestor do?

Parsing and Ingestion directives for the Dialogflow CX (DFCX) agent structure. Dfcx Framework Ingestor is an agent skill from GoogleCloudPlatform/cxas-scrapi. Parsing and Ingestion directives for the Dialogflow CX (DFCX) agent structure.

When should I use Dfcx Framework Ingestor?

Dfcx Framework Ingestor fits situations like: backend & APIs work in your project.

How do I install Dfcx Framework Ingestor in Claude Code?

Run `npx skills add GoogleCloudPlatform/cxas-scrapi --skill dfcx-framework-ingestor -a claude-code`. Or copy the skill folder (.agents/skills/cxas-cuj-report-generator/ingestors/frameworks/dfcx in GoogleCloudPlatform/cxas-scrapi) into .claude/skills/dfcx-framework-ingestor in your project. Claude Code loads it when a task matches its description.

How do I install Dfcx Framework Ingestor in Codex?

Run `npx skills add GoogleCloudPlatform/cxas-scrapi --skill dfcx-framework-ingestor -a codex`. Or copy the skill folder (.agents/skills/cxas-cuj-report-generator/ingestors/frameworks/dfcx in GoogleCloudPlatform/cxas-scrapi) into .agents/skills/dfcx-framework-ingestor in your project. Codex loads it when a task matches its description.

Can I use Dfcx Framework Ingestor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GoogleCloudPlatform/cxas-scrapi --skill dfcx-framework-ingestor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dfcx-framework-ingestor, .gemini/skills/dfcx-framework-ingestor, .github/skills/dfcx-framework-ingestor and .opencode/skills/dfcx-framework-ingestor in your project.

What does Dfcx Framework Ingestor need to run?

SKILL.md names no scripts, command-line tools or credentials: Dfcx Framework Ingestor is instructions for the agent only.

Does Dfcx Framework Ingestor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dfcx Framework Ingestor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dfcx Framework Ingestor use?

Dfcx Framework Ingestor is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dfcx Framework Ingestor use?

About 1.7k tokens (SKILL.md is roughly 6.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dfcx Framework Ingestor?

Skills that share tags, products or a category with Dfcx Framework Ingestor: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 43k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dfcx Framework Ingestor?

GoogleCloudPlatform (a GitHub organization) maintains it in GoogleCloudPlatform/cxas-scrapi, which has 107 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 8, 2026.

Source: GoogleCloudPlatform/cxas-scrapi on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.