wren-onboarding

Guides end-to-end Wren Engine setup from environment checks to first query.

663|199|Updated May 9, 2022
One-click install
npx skills add https://github.com/Canner/wren-engine --skill wren-onboarding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wren-onboarding
Source: https://github.com/Canner/wren-engine/tree/main/skills/wren-onboarding
Command: npx skills add https://github.com/Canner/wren-engine --skill wren-onboarding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up Wren Engine involves many ordered steps—environment checks, project scaffolding, connection configuration, and MDL generation—and doing them out of order or exposing credentials in chat causes failures. This Skill walks an AI agent through the entire onboarding flow one step at a time with strict safety rules.

Core Features & Use Cases

  • Guided Environment Preflight: Verifies Python 3.11+, virtualenv status, and existing CLI installations before any project work begins.
  • Credential-Safe Connection Setup: Generates .env templates by introspecting the live connector schema via wren docs connection-info, so credentials never pass through chat.
  • Cross-Skill Orchestration: Routes to sibling skills (wren-generate-mdl, wren-usage, wren-dlt-connector) at the right handoff points, and surfaces the official troubleshooting playbook on errors.
  • Use Case: A user says "set up Wren Engine and connect my Postgres database." The agent checks the environment, scaffolds the project, writes a .env template, creates the connection profile, hands off to MDL generation, and finishes with suggested natural-language questions.

Quick Start

Ask the agent to install Wren Engine and connect your database by saying "set up wren engine" or invoking /wren-onboarding.

Frequently Asked Questions about wren-onboarding

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

FAQPage Schema
How do I install Wren Engine and connect a database?

Run the wren-onboarding skill, which checks your Python environment, scaffolds a project with wren context init, generates a .env template from the connector schema, and creates a connection profile with wren profile add. It then hands off to MDL generation before your first query.

How do I configure Wren Engine connection credentials safely?

Credentials are never entered in chat. The skill generates a .env file with empty fields based on wren docs connection-info output, you fill in values in your editor, and the connection profile references them as ${VAR} placeholders.

Which databases does Wren Engine support for connections?

Supported datasources include postgres, mysql, bigquery, snowflake, clickhouse, trino, and duckdb. Run wren docs connection-info with no argument to see the full list introspected from the live connector schema.

Why does my Wren Engine query fail after connecting a database?

Queries fail if MDL has not been built yet, since tables not in the MDL cannot be queried. Run the wren-generate-mdl skill first, then wren context validate and wren context build before querying.

What Python version does Wren Engine require?

Wren Engine requires Python 3.11 or newer. The onboarding preflight checks python3 --version first and stops with an upgrade request if the version is older.