diff --git a/plugins/shared/skills/resources_postgresql/SKILL.md b/plugins/shared/skills/resources_postgresql/SKILL.md index dcc1124..9cfbc09 100644 --- a/plugins/shared/skills/resources_postgresql/SKILL.md +++ b/plugins/shared/skills/resources_postgresql/SKILL.md @@ -27,7 +27,8 @@ description: Implements PostgreSQL connections, SQL queries, and migration patte ## MCP Tools - `mcp__resources__postgresql_psql` — Execute read-only SQL queries and psql backslash commands (`\dt`, `\d`, `\di`, `\df`, etc.). Args: `resourceId`, `command`, `timeoutMs?` -- `mcp__resources__postgresql_run_migration` — Run DDL/DML migrations on **managed databases only** (`isManaged=true`). Runs in a transaction; rolls back on failure. Args: `resourceId`, `migration`, `description?` +- `mcp__resources__postgresql_invoke` — Execute write SQL against managed or external PostgreSQL resources. Args: `resourceId`, `sql`, `params?`, `timeoutMs?`, `description` +- `run_migration` on the platform MCP server — Run tracked migrations on an application's managed database in app-building/orchestrator sessions. Args: `applicationId`, `migration`, `description` ## TypeScript Client @@ -48,7 +49,8 @@ if (result.ok) { ## Tips - Use parameterized queries (`$1`, `$2`, ...) — never interpolate values into SQL strings -- `psql` tool is read-only; use `run_migration` for writes (managed DBs) or the TypeScript client for writes (external DBs) +- `psql` is read-only; use `postgresql_invoke` for data modifications against managed or external PostgreSQL resources +- Use `run_migration` for tracked schema migrations on an application's managed database - The TypeScript client supports full read/write operations regardless of managed status - Use `psql` exclusively for read-only tasks. Never use invoke for read only.