hap-cli-data-query

Query and summarize HAP worksheet data with filters, aggregations, and pivot analysis.

13|2|Updated Jun 8, 2026
One-click install
npx skills add https://github.com/mingdaocom/hap-skills --skill hap-cli-data-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hap-cli-data-query
Source: https://github.com/mingdaocom/hap-skills/tree/main/skills/cli/hap-cli-data-query
Command: npx skills add https://github.com/mingdaocom/hap-skills --skill hap-cli-data-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users retrieve and analyze HAP worksheet data without constructing error-prone query parameters manually, especially when filters involve nested AND/OR logic or aggregated statistics.

Core Features & Use Cases

  • Advanced Filtering: Build multi-condition, nested, and field-type-aware filters for HAP record queries.
  • Pivot Analysis: Group records by dimensions and calculate counts, sums, averages, minimums, maximums, or distinct counts.
  • Record Discovery: Find field IDs, resolve relation row IDs, query subtable rows, paginate results, sort records, and limit returned fields.
  • Use Case: Filter orders by status and date, then produce a monthly summary of order counts and revenue by category.

Quick Start

Ask the AI to query a specified HAP worksheet using the required filters and return either matching records or a grouped statistical summary.

Frequently Asked Questions about hap-cli-data-query

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

FAQPage Schema
How do I query HAP worksheet data with complex AND or OR filters?

You can query HAP worksheet data by constructing a valid filter-json structure that supports nested AND or OR logic. This approach processes multi-condition, field-type-aware filters to retrieve specific records without manual parameter construction.

What is the best way to summarize HAP records by category and date?

Summarize HAP records by applying pivot analysis to group data by dimensions like category or date. You can calculate sums, counts, averages, minimums, maximums, or distinct counts directly through HAP CLI query commands.

How do I find specific field IDs and relation row IDs in HAP worksheets?

Finding specific field IDs and relation row IDs is part of record discovery. This process resolves relation row IDs and queries subtable rows by requiring valid worksheet field identifiers within your HAP CLI query commands.

Can I paginate results and sort records when filtering HAP worksheet data?

Yes, you can paginate results and sort records when filtering HAP worksheet data. The query process supports appropriate pagination parameters, sorting configurations, and limiting returned fields to manage large datasets effectively.

Do I need HAP CLI query commands to retrieve and aggregate business data?

Yes, retrieving and aggregating business data requires HAP CLI query commands. You must provide worksheet field identifiers, valid filter-json structures, and appropriate pagination or pivot view parameters to execute accurate queries.

Why does my HAP data query fail when using nested filter conditions?

HAP data queries with nested filter conditions fail when the filter-json structure is invalid or field types are mismatched. This approach prevents these errors by building field-type-aware filters and resolving relation row IDs correctly.