profile-dataset

Profile datasets by ID with shape, freshness, and per-column metrics.

7|Updated May 18, 2026
One-click install
npx skills add https://github.com/narrative-io/narrative-skills-marketplace --skill profile-dataset
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: profile-dataset
Source: https://github.com/narrative-io/narrative-skills-marketplace/tree/main/plugins/narrative-common/skills/profile-dataset
Command: npx skills add https://github.com/narrative-io/narrative-skills-marketplace --skill profile-dataset

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Profile a dataset to reveal coverage, null/fill rates, cardinality, ranges, and quality flags. It supports stat freshness checks and optional recalc.

Core Features & Use Cases

  • Provides a three-layer profile: shape, per-column coverage, and quality flags, with a structured output suitable for downstream workflows.
  • Supports tiered data quality workflows: Tier 1 (bundled stats), Tier 2 (config + recalculate), and Tier 3 (custom NQL escalation) for complex measures.
  • Handles missing or stale stats with gated recalc prompts and graceful sample-only fallbacks, enabling robust profiling in varied environments.

Quick Start

Use the profile-dataset skill to generate a complete profile by supplying a dataset id; it will return shape, per-column stats, and quality flags using bundled stats plus a sample.

Frequently Asked Questions about profile-dataset

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

FAQPage Schema
How do I check dataset quality and calculate null rates?

To check dataset quality and calculate null rates, profile a dataset by its id to return a structured, multi-layer profile of row/column shape, freshness, and per-column metrics. It defaults to profiling all columns but allows narrowing via a focus list.

What is dataset profiling and how does it surface coverage metrics?

Dataset profiling reveals coverage, null/fill rates, cardinality, and ranges by generating a three-layer profile: shape, per-column coverage, and quality flags. This structured output is suitable for downstream workflows like data triage and match reporting.

How do I profile specific columns instead of an entire dataset?

To profile specific columns instead of an entire dataset, supply a dataset id along with a focus list to narrow the scope. The profiler will return per-column stats and quality flags restricted to your selected columns using bundled stats and a sample.

What should I do when dataset statistics are missing or stale?

When dataset statistics are missing or stale, the profiler applies gated recalc prompts and graceful sample-only fallbacks. It supports tiered workflows, triggering Tier-2 config recalculation or Tier-3 custom NQL escalation only when necessary for complex measures.

Can I use dataset profiling for downstream data triage workflows?

Yes, you can use dataset profiling for downstream data triage workflows. The structured output surfaces explicit stats, inferred shapes, and quality flags that directly support rosetta stone mappings, match reporting, and data triage tasks.

What are the limitations of relying on bundled statistics for dataset coverage checks?

Bundled statistics provide a Tier-1 profile but may lack complex measures. Limitations are addressed through gated Tier-2 recalculation for config updates and Tier-3 custom NQL escalation, with graceful sample-only fallbacks when recalculation is not possible.