credible-analysis-overview

Explains Credible's published semantic model hierarchy and retrieval judgment for Malloy-based data analysis.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/credibledata/credible-plugin --skill credible-analysis-overview-credibledata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: credible-analysis-overview
Source: https://github.com/credibledata/credible-plugin/tree/main/codex/skills/credible-analysis-overview
Command: npx skills add https://github.com/credibledata/credible-plugin --skill credible-analysis-overview-credibledata

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Analysts querying Credible workspaces through MCP tools often misuse the object hierarchy, retry expected empty states, or rebuild metrics from raw columns instead of using the modeler's published measures and views. This Skill teaches the correct mental model and retrieval judgment so queries against published Malloy semantic models return numbers that match the team's reporting. ## Core Features & Use Cases - Object model orientation: Maps the full hierarchy from organization and workspace down through environment, package, model, and source with its dimensions, measures, views, and joins. - Retrieval judgment: Covers validating known entity names without a search, treating names as unconfirmed pointers, and when dimensional_value refinement is worth using based on the values_indexed flag. - Empty-state handling: Explains that unpublished workspaces return an expected empty state that must not be retried or reported as a broken model. - Use Case: You ask how many active subscribers existed last month; the Skill guides Claude to get the workspace from list_workspaces, confirm the measure exists via get_context, and prefer the source's own view over hand-written aggregation. ## Quick Start Ask a natural-language question about your Credible workspace data, such as how revenue broke down by region last quarter, and let the published semantic model guide the query.

Frequently Asked Questions about credible-analysis-overview

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

FAQPage Schema
How do I query a Credible workspace with natural language?

Ask your question in plain language and Claude uses list_workspaces to find your workspaces, get_context to search the published semantic model for relevant dimensions and measures, and execute_query to run a Malloy query against your warehouse.

What is the difference between a Credible package, model, and source?

A package is the published, versioned unit containing one or more .malloy model files. A model is a single .malloy file addressed by its model_path, and a source is the queryable entity inside a model declaring dimensions, measures, views, and joins.

Why does my Credible workspace return no packages?

An empty result means nothing is published in that workspace yet, which is an expected state rather than an error. Do not retry; a model must be published in the workspace before get_context or execute_query can operate on it.

Should I write my own aggregation or use a Credible measure?

Prefer the source's own measures and views, because a measure encodes how the modeler decided the metric is computed. Recreating it from raw columns often produces a plausible number that disagrees with the team's reporting.

When should I use dimensional_value refinement in get_context?

Use dimensional_value refinement only when the dimension came back with values_indexed set to true. If the flag is absent or false, get distinct values with an execute_query instead, which is the intended path for unindexed dimensions.

Can I edit or create Credible semantic models through this Skill?

No. You are on the reading side: you can discover what a published model contains and run queries against it, but you cannot create or edit models, access warehouse connections, or see unpublished drafts.