# SK Tools Commands

The `sk-tools` package provides generic CLI utilities not tied to a specific cloud provider.

## Global Options

These options apply to all commands unless stated otherwise:

- `--query`, `-q` <jmespath> - Apply JMESPath filter before output rendering.
- `--output`, `-o` <format> - Output format: `table|t|alignedtable|at|prettytable|pt|tsv`.
- `--columns`, `-C` <definition> - Column selection for table outputs:
  - `col1` - Select column (case-insensitive match), keep raw header label.
  - `col1:` - Select column (case-insensitive match), use auto-generated header label.
  - `col1: Label 1` - Select column (case-insensitive match), use custom header label.
  - Prefix token with `=` for exact column-name match: `=col1`, `=col1:`, `=col1:Label`.
  - Tokens are comma-separated and rendered in the specified order.
- `--help`, `-h` - Show help.

## Table

**Command name:** `table` (alias: `t`)

**Usage:** `sk-tools table [--from|-F <json|csv|tsv>] [--columns|-C <definition>] [global options]`

**Options:**

- `--from`, `-F` <json|csv|tsv> - Input format read from stdin. Default: `json`.
- `--columns`, `-C` <definition> - Column definition (see global options).

**Description:** The `table` command transforms stdin data into tabular output. It accepts JSON, CSV, or TSV input and renders either Markdown table variants or TSV output.

## Table Info

**Command name:** `table-info` (alias: `ti`)

**Usage:** `sk-tools table-info [--from|-F <json|csv|tsv>]`

**Options:**

- `--from`, `-F` <json|csv|tsv> - Input format read from stdin. Default: `json`.

**Description:** The `table-info` command reads stdin data and prints basic diagnostics: number of rows, number of columns, and inferred type for each column.