skills.rest
MapleTechLabs
MapleTechLabsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

maple-dashboard-widgets

Validate raw Maple dashboard widget JSON for MCP submissions.

1.6k|107|Updated Feb 15, 2026
Search Tags:#mcp#observability#query builder#dashboard widgets#maple#widget validation
One-click install
npx skills add https://github.com/MapleTechLabs/maple --skill maple-dashboard-widgets-mapletechlabs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maple-dashboard-widgets
Source: https://github.com/MapleTechLabs/maple/tree/main/skills/maple-dashboard-widgets
Command: npx skills add https://github.com/MapleTechLabs/maple --skill maple-dashboard-widgets-mapletechlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates common errors and failed writes when creating raw Maple dashboard widget JSON for MCP tools, which often lead to broken dashboard visualizations or rejected submissions due to invalid query structures, malformed filter clauses, or incorrect aggregation values.

Core Features & Use Cases

  • Guided Widget JSON Construction: Provides exact schemas and rules for building valid raw widget JSON for MCP tools like create_dashboard, add_dashboard_widget, and update_dashboard_widget, including support for multi-query charts, formulas, and hidden series.
  • Pitfall Avoidance: Documents critical common mistakes such as adding metrics-only fields to trace or log queries, using unsupported whereClause syntax like IS NULL, applying invalid aggregations to the wrong data source, and using incorrect groupBy prefixes that cause silent failures or rejected writes.
  • Specialized Widget Support: Covers configuration for stat and gauge widgets (including the required reduceToValue transform), formula charts with hidden auxiliary series, threshold lines for time-series charts, and post-submission validation steps to confirm widgets render correctly.
  • Use Case: An observability engineer building a trace latency dashboard can use this Skill to ensure their trace queries omit metrics-only fields, use valid whereClause operators, apply correct groupBy prefixes for span attributes, and validate the widget after submission to avoid broken charts.

Quick Start

Use this skill to build a valid raw widget JSON for a trace count chart filtered to the ingest service when submitting via the maple MCP add_dashboard_widget tool.

Frequently Asked Questions about maple-dashboard-widgets

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

FAQPage Schema
How do I fix failed MCP widget submissions for Maple dashboards?▼

Failed MCP widget submissions for Maple dashboards are typically caused by invalid raw widget JSON. You can fix them by correcting the query draft structure, ensuring proper whereClause grammar, and applying valid per-data-source aggregations before resubmitting.

What's the correct whereClause syntax for Maple dashboard widget queries?▼

The correct whereClause syntax for Maple dashboard widget queries requires using supported operators, as invalid syntax like IS NULL will cause rejected writes. You must also use correct groupBy prefixes for span attributes to prevent silent query failures.

How do I configure stat and gauge widgets in Maple via MCP tools?▼

To configure stat and gauge widgets in Maple via MCP tools, you must include the required reduceToValue transform in your raw widget JSON. This specialized transform ensures the data is properly aggregated for these specific chart types.

Why are my trace queries failing when adding dashboard widgets through MCP?▼

Trace queries fail when adding dashboard widgets through MCP if you include metrics-only fields in trace or log queries, or apply invalid aggregations. Ensure trace queries omit metrics-only fields and use correct groupBy prefixes for span attributes.

How do I validate Maple dashboard widgets after creating them with MCP?▼

To validate Maple dashboard widgets after creating them with MCP, perform post-submission validation steps to confirm the widgets render correctly. This ensures your add_dashboard_widget or update_dashboard_widget submissions produced a functional visualization.

Can I build formula charts with hidden auxiliary series in Maple dashboards?▼

Yes, you can build formula charts with hidden auxiliary series in Maple dashboards by constructing the raw widget JSON with the correct schema. This includes configuring multiple queries, formulas, and hidden series to calculate and display the desired output.

Related Skills

Explore More Software Engineering Skills→
raphaelchristiraphaelchristi
43

harness:setup

Configure Harness Evolver, LangSmith, and baseline evaluations for Python projects.

Community
Advanced
Aradhya0510Aradhya0510
3

databricks-aibi-dashboards

Create and update Databricks AI/BI dashboards from structured JSON with SQL validation.

Community
Advanced
MakisuoMakisuo
1.6k

maple-dashboard-widgets

Create and validate Maple dashboard widgets via MCP with structured JSON.

Community
Advanced
ScottHMcKeanScottHMcKean

databricks-aibi-dashboards

Create and update Databricks AI/BI dashboards with validated SQL queries and JSON layouts.

Community
Advanced