resources

Create and manage Windmill resource files storing credentials and service configurations.

1|Updated Aug 3, 2026
One-click install
npx skills add https://github.com/vpzed-dev/smithy --skill resources-vpzed-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: resources
Source: https://github.com/vpzed-dev/smithy/tree/main/windmill/local-dev/.agents/skills/resources
Command: npx skills add https://github.com/vpzed-dev/smithy --skill resources-vpzed-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing credentials and connection settings for external services in Windmill requires correctly structured resource files, and hand-writing them risks schema errors, broken variable references, and misconfigured resource types. ## Core Features & Use Cases - Resource File Authoring: Defines the {path}.resource.json format with required value and resource_type fields for services like PostgreSQL, MySQL, Slack, S3, Kafka, NATS, and MQTT. - Variable and Resource References: Supports $var: references to global, user, and folder variables and $res: references to other resources, keeping secrets out of plain configuration. - Custom Resource Types: Creates custom resource types with JSON Schema validation, saved as .resource-type.json files. - Use Case: When adding a new PostgreSQL database connection to a Windmill workspace, generate a f/databases/postgres_prod.resource.json file that references the password via $var:g/all/db_password instead of hardcoding it. ## Quick Start Ask the agent to create a Windmill resource file for a PostgreSQL database that pulls its password from a global variable.

Frequently Asked Questions about resources

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

FAQPage Schema
How do I create a Windmill resource file for a database?▼

Create a file named `{path}.resource.json` containing a `value` object with connection fields and a `resource_type` such as postgresql or mysql. Reference secrets with `$var:` syntax instead of hardcoding passwords.

How do I reference variables in Windmill resources?▼

Use the `$var:` prefix inside resource values: `$var:g/all/name` for global variables, `$var:u/username/name` for user variables, and `$var:f/folder/name` for folder variables. Other resources are referenced with `$res:path`.

What resource types does Windmill support?▼

Windmill includes built-in types for postgresql, mysql, slack, s3, http, kafka, nats, and mqtt. You can also define custom resource types with a JSON Schema saved as a `.resource-type.json` file.

How do I use Windmill resources in TypeScript or Python scripts?▼

Declare a typed parameter in the script's main function, such as `db: RT.Postgresql` in TypeScript or a TypedDict in Python. Windmill injects the resource values into that parameter at runtime.

When should I run wmill sync push for resources?▼

Run `wmill sync push` only when the user explicitly asks to deploy, publish, or push, since it is destructive to remote workspace state. Depending on repo setup, deployment may instead happen via `git push`.