agentleFS
hollandkevinthollandkevint/data-product-operator/skills/grill-me-data/SKILL.md

grill-me-data

Skill5 starsChanged 2 months agoMITView on GitHub

Decision tree exploration for data product plans. Interview relentlessly about schema decisions, consumer contracts, quality SLAs, and delivery choices. Use when planning a data product, designing a schema, choosing a delivery method, or when someone asks "grill me on this data product" or "what am I missing in this design?"

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Start with: "What data product are you planning?

    line 20
  2. Distinctive:

    When the user says "I don't know yet": record it as an open question with a suggested investigation step.

    line 65
  3. Distinctive:

    When the user wants to skip a branch: let them, but note it.

    line 67

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Core Instruction

Interview the user relentlessly about every aspect of their data product plan until you reach a shared understanding. Walk down each branch of the decision tree, resolving dependencies between decisions one by one.

For each question, provide your recommended answer based on context. When the recommendation is obvious, the user just says "yes" and you move on.

Data Product Decision Branches

Start with: "What data product are you planning? Who consumes it and what decision does it inform?"

Then walk the tree. These are the branches specific to data products:

Consumer Branch

  • Who are the primary consumers? (Explorers, Reporters, Decision-makers, Builders)
  • How do they access this today? (manual query, existing dashboard, Excel export, nothing)
  • What format do they need? (dashboard, API, flat file, embedded metric)
  • What's their technical sophistication? (SQL-fluent, BI-tool-only, non-technical)
  • What decision does this inform? If they can't name one, stop and run data-consumer-discovery.

Schema Branch

  • What's the grain? (one row = what?)
  • Fact or dimension? (measurable events vs. descriptive attributes)
  • SCD strategy needed? (Type 1 overwrite, Type 2 history, Type 3 limited history)
  • Conformed dimensions available? (shared across products, or isolated)
  • Denormalization tradeoffs? (query performance vs. maintenance complexity)

Cross-reference data-model-design for schema pattern details.

Quality Branch

  • What accuracy SLA does this need? (99.9% for clinical, 95% for internal reporting)
  • Freshness requirement? (real-time, hourly, daily, weekly)
  • What happens when data is late or wrong? (circuit breaker, fallback, manual override)
  • Who gets paged when quality drops?

Cross-reference data-quality-assessment for the 5-dimension scoring model.

Delivery Branch

  • Push or pull? (scheduled delivery vs. on-demand query)
  • What system of record does this feed? (BI tool, application, API, spreadsheet)
  • Schema evolution strategy? (breaking changes, versioning, consumer migration)
  • Consumer contract defined? (SLA, format, access method per consumer type)

Cross-reference data-pipeline-quality for delivery patterns.

Validation Branch

  • Has demand been validated? (real consumer requests vs. assumed need)
  • What's the validation score? Cross-reference data-product-validation scorecard.
  • Type 1 or Type 2 decision? (irreversible schema commitment vs. reversible feature add)

Session Dynamics

A typical data product grill session runs 20-40 questions over 30 minutes. Don't shortcut the schema and quality branches — those are where undiscovered complexity hides.

When the user says "I don't know yet": record it as an open question with a suggested investigation step.

When the user wants to skip a branch: let them, but note it. "You skipped the SCD strategy decision. That will come back when historical data accumulates."

Output

At the end, produce:

  • Decisions made: Numbered list with branch labels
  • Open questions: What still needs answering
  • Schema risks: Decisions that are hard to reverse once data accumulates
  • Quality gaps: Where SLAs are undefined or unrealistic
  • Recommended next step: The single most important thing to resolve first

Based on Matt Pocock's grill-me skill pattern, adapted for data products.


Part of the Data Product Operator plugin. Decision architecture skills: decision-architecture

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.