soria-stack

Orchestrate Extract→Transform→Value-map→Load→Represent data pipelines with CLI-driven skills.

1|1|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/Soria-Inc/soria-stack --skill soria-stack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: soria-stack
Source: https://github.com/Soria-Inc/soria-stack/tree/main
Command: npx skills add https://github.com/Soria-Inc/soria-stack --skill soria-stack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating end-to-end data pipeline work is error-prone: teams accidentally write to prod, skip verification, or build dashboards without auditability. SoriaStack provides a consistent, CLI-first set of skills that enforce gates, provenance, and verification so analysts and engineers can move from scraping to production with confidence.

Core Features & Use Cases

  • ETVLR orchestration (Extract → Transform → Value-map → Load → Represent) with gated checkpoints and artifact outputs.
  • Environment management and promotion workflow (git worktrees + Neon branches + MotherDuck clones) that prevents accidental prod writes.
  • Read-only reconnaissance (/status, /preview), pipeline builders (/ingest, /map, /parent-map), dive authorship (/dive), verification (/verify), browser QA (/dashboard-review, /browse), and safe promotion (/promote).
  • Use cases: onboarding a new source (scrape → extract → publish → verify → dive), repairing data quality via /diagnose → /ticket, and running adversarial UI reviews before shipping.

Quick Start

Start a session by ensuring the soria CLI and an active dev environment are available, run /env then /tools, and invoke the appropriate skill (for example, /ingest to build a pipeline or /dive to create a dive).

Frequently Asked Questions about soria-stack

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

FAQPage Schema
How do I orchestrate an ETVLR data pipeline from extraction to dashboard verification?

ETVLR data pipeline orchestration is managed through CLI-driven skills that execute Extract, Transform, Value-map, Load, and Represent stages with gated checkpoints and artifact outputs. You invoke specific commands like /ingest to build pipelines and /verify to run checks.

How does environment isolation work when building dbt marts with Neon branches?

Environment isolation uses git worktrees paired with Neon branches and MotherDuck clones to create sandboxed dev and preview spaces. This mechanism prevents accidental prod writes by ensuring pipeline development and testing occur entirely within isolated database clones.

Do I need a headless browser to run dashboard QA on my data pipeline?

A headless browser is optional and only required for UI QA commands like /dashboard-review and /browse. Core pipeline tasks such as scraping, dbt mart creation, and verification checks run without it, relying instead on the soria CLI and active environment worktrees.

What's the best way to prevent accidental production writes during data transformation?

Preventing accidental production writes is enforced through artifact-based gates and mandatory prod write confirmations. The workflow requires promoting changes from isolated dev environments using git-based promotion, ensuring all transformations are verified before touching production.

Can I use this CLI tool to diagnose and repair data quality issues in my warehouse?

Yes, you can diagnose and repair data quality issues by running the /diagnose command to identify problems and /ticket to track repairs. The pipeline applies verification checks via /verify to validate data marts before promotion.

What is the ETVLR workflow and when do I need it instead of standard ETL?

ETVLR extends standard ETL by breaking downstream processing into Value-map, Load, and Represent stages, providing explicit checkpoints for schema mapping, dbt marts, and dashboard QA. You need it when coordinating end-to-end pipelines requires strict provenance, auditability, and verification gates.