goal_parsing

Guide users through a decision-tree interview and return a structured JSON state.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/huangxn27/broadband-agent-demo --skill goal-parsing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: goal_parsing
Source: https://github.com/huangxn27/broadband-agent-demo/tree/main/backend/skills/goal_parsing
Command: npx skills add https://github.com/huangxn27/broadband-agent-demo --skill goal-parsing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill guides users through a decision-tree interview to collect the seven core slots needed to describe a comprehensive target, and outputs a structured portrait JSON for downstream planning.

Core Features & Use Cases

  • Deterministic slot-filling workflow: navigates a defined sequence to ensure all required fields are captured.
  • Stateful conversation: maintains and updates a JSON state across interactions for subsequent agents to consume.
  • Easy integration: exposes script-driven interactions that other agents can invoke to obtain updated state and next questions.
  • Practical scenarios: ideal for shaping multi-faceted goals (e.g., user_type, package_type, scenario, time_window) used by planning and provisioning workflows.

Quick Start

Describe a user's composite goal in natural language and feed it to the skill to receive the updated portrait JSON.

Frequently Asked Questions about goal_parsing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract missing slots and build a structured JSON state from natural language input?

To extract missing slots and build a structured JSON state, this skill guides users through a deterministic decision-tree interview, identifying required fields like user_type and scenario. It returns a portrait JSON containing missing_slots and next_questions to drive subsequent planning agents.

What is slot-filling for dialogue management and when do I need it?

Slot-filling for dialogue management is the process of navigating a decision tree to collect required target parameters. You need it when shaping multi-faceted goals for downstream planning workflows, ensuring all core fields are captured before executing a provisioning task.

How do I track conversation state and determine the next question in a planning agent workflow?

You can track conversation state and determine the next question by feeding composite goals to this skill. It maintains and updates a JSON state across interactions, outputting an is_complete flag and next_questions to seamlessly drive the subsequent steps of your planning agent.

Does this slot-filling skill work with YAML configurations for state tracking?

Yes, the slot-filling skill supports YAML configurations for state tracking, operating with the pyyaml dependency. It processes natural language input alongside your defined slots to output a structured JSON portrait without requiring complex environmental setups.

What is the best way to collect a complete target portrait for downstream planning?

The best way to collect a complete target portrait is using a deterministic slot-filling workflow. This approach navigates a defined sequence to capture seven core slots, returning a structured JSON state that downstream planning and provisioning agents can directly consume.

What happens if required slots like time_window or package_type are missing during goal parsing?

When required slots like time_window or package_type are missing during goal parsing, the output JSON explicitly flags them in the missing_slots array. The skill then generates specific next_questions to prompt the user, ensuring the target portrait reaches is_complete status.