Snowflake Streamlit to Mendix Skill

An agent skill for converting Streamlit-in-Snowflake applications into working Mendix Studio Pro applications.

The skill reads an existing Streamlit codebase, inventories its behaviour, designs the Mendix domain and interaction model, and builds what the connected Mendix tools support. It leaves explicit handoff markers for work that needs a developer or a decision from the application owner.

What the skill can do

• Inventory pages, widgets, SQL, filters, session state, caching, charts, write paths, Cortex calls, and pandas transformations without relying on the source app being neatly structured.
• Separate facts found in code from inferred intent, questions for the owner, and conservative behaviour-preserving decisions.
• Translate Streamlit's rerun model into Mendix pages, entities, microflows, nanoflows, state, refresh actions, and caching strategies.
• Build Snowflake SQL and Cortex data paths through the Snowflake AI Data Connector, including result mapping into Mendix-owned entities.
• Port Plotly and other chart patterns to typed Mendix Charts widgets, Advanced mode, or Custom Chart, with documented fallbacks for unsupported behaviour.
• Map common Streamlit inputs, layouts, tables, navigation, uploads, downloads, and status elements to Mendix widgets and actions.
• Detect conversion traps such as stale cache layers, invalid widget state, dynamic SQL identifiers, hidden date assumptions, and pandas operations that need a new execution home.
• Produce a severity-ranked handoff report and place searchable StreamlitTODO markers in the Mendix model.

How it works

The workflow runs in eight stages:

1. Inventory the Streamlit source.
2. Classify every finding as derivable, inferable, must-ask, or conservative.
3. Resolve the questions that affect the design.
4. Build entities, state, data access, control flow, and write paths.
5. Build charts and their data-shaping logic.
6. Build pages and widgets.
7. Run the conversion pitfall checklist.
8. Deliver the working model and handoff report.

The first three stages are read-only. The skill does not shape the Mendix domain model around whichever Streamlit page it happens to inspect first.

Requirements

• The Streamlit application's source code.
• A Mendix Studio Pro project exposed through a compatible Mendix MCP server.
• The Snowflake AI Data Connector installed in the Mendix project for Snowflake SQL or Cortex features.
• A project owner who can configure Snowflake credentials and complete security tasks that the server cannot safely create or inspect.

The skill never asks an agent to store credential values in the model or source tree.

Use the skill

Open SKILL/SKILL.md in an agent session together with the source Streamlit repository and the target Mendix project.

Example requests:

Use this skill to convert this Streamlit-in-Snowflake dashboard into the open Mendix project.

Use this skill to inventory this Streamlit app and estimate the difficult parts of a Mendix conversion.

To install it in a skill-aware agent, copy the contents of SKILL/ into that agent's skills directory under the name streamlit-to-mendix.

Outputs

A full conversion aims to leave:

• A partially or fully working Mendix application, depending on platform boundaries.
• Mendix-owned entities and microflows for the Snowflake data path.
• Converted pages, widgets, charts, filters, navigation, and write actions.
• Visible markers at every location that still needs human work.
• One handoff report grouped by severity, with no silent assumptions.

Known boundaries

Some actions remain manual by design:

• Installing Marketplace modules and their dependencies.
• Entering Snowflake account details and credentials.
• Creating or verifying module roles, user roles, and page access when the connected Mendix server does not expose those document types.
• Replacing a source behaviour that has no safe Mendix equivalent.

The skill prefers an obvious incomplete state over a convincing non-working stub.

Repository structure

SKILL/
|-- SKILL.md
`-- references/
    |-- extraction.md
    |-- patterns.md
    |-- mendix-platform.md
    |-- charts.md
    |-- mendix-widgets.md
    |-- pitfalls.md
    `-- handoff.md

Development fixtures, private notes, local reports, credentials, environments, and workspace instructions are excluded from publication by .gitignore.

License

MIT. See LICENSE.