df-basic-stats

Computes type-aware descriptive statistics and profiling reports for pandas DataFrames.

Updated Feb 12, 2026
One-click install
npx skills add https://github.com/qmakescl/QSkills --skill df-basic-stats-qmakescl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: df-basic-stats
Source: https://github.com/qmakescl/QSkills/tree/main/skills/df-basic-stats
Command: npx skills add https://github.com/qmakescl/QSkills --skill df-basic-stats-qmakescl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, numpy, matplotlib, ydata-profiling, and includes scripts (resource) and references (resource) components.

What problem does it solve? Manually inspecting a new dataset to understand column types, missing values, and distributions is repetitive and error-prone. This Skill automates the first pass of exploratory data analysis by inferring each column's type and producing tailored statistics plus a ready-to-read report. ## Core Features & Use Cases - Automatic Type Inference: Classifies every column as continuous, integer, categorical, or datetime using dtype checks and an 80% parse-success threshold for object columns. - Type-Specific Statistics: Outputs mean/std/median/min/max for numeric columns, distributions and bar charts for low-cardinality categorical columns, and ranges for datetime columns, all in a structured JSON schema. - Integrated Reporting: Generates a Markdown summary report with auto-extracted insights (high missingness, skewness, dominant categories) plus an optional ydata-profiling HTML report. - Use Case: Upload a CSV of survey responses and ask for a data summary; the Skill returns per-column statistics, missing-value tables, distribution charts, and a Markdown report you can read directly. ## Quick Start Ask the agent to analyze the basic statistics and missing values of your uploaded CSV or Excel file.

Frequently Asked Questions about df-basic-stats

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

FAQPage Schema
How do I get descriptive statistics for a CSV file in Python?▼

Load the CSV with pandas and run the compute_stats.py script, which infers each column's type and outputs mean, std, median, min, max, mode, and missing rates as JSON. It also generates a Markdown report and optional ydata-profiling HTML output.

How does automatic column type inference work in pandas?▼

Columns are first classified by dtype: datetime64 becomes datetime, integer dtypes become integer, and floats become continuous. Object columns are re-parsed with pd.to_numeric and pd.to_datetime, requiring over 80% successful conversion to be reclassified.

What file formats does this statistics tool support?▼

The loader supports CSV, TSV, Excel (.xlsx, .xls), Parquet, JSON, and Feather files, selecting the appropriate pandas reader based on file extension. Unsupported extensions raise a clear error listing valid formats.

What happens if ydata-profiling is not installed?▼

The Skill emits a warning and skips the HTML profile report while still computing all other statistics with pandas and numpy. Similarly, missing matplotlib only skips categorical distribution charts, not the core analysis.

How are large datasets with over one million rows handled?▼

For DataFrames exceeding one million rows, ydata-profiling is forced into minimal mode to keep report generation tractable. All other per-column statistics are computed normally regardless of dataset size.

Why is a numeric-looking column classified as categorical?▼

Object columns are only reclassified as numeric when more than 80% of non-null values parse successfully. Columns with many typos or mixed codes like 'N/A' fall below this threshold and remain categorical by design.