Skip to content

fix(managed-database skill): use orchestrator-platform run_migration #148

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
rishikesh-major wants to merge 3 commits into from
Closed

fix(managed-database skill): use orchestrator-platform run_migration #148

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
710f72c
fix(skills): update PostgreSQL write guidance
rishikesh-major Aug 4, 2026
7cd84fe
docs(skills): narrow PostgreSQL guidance fix
rishikesh-major Aug 4, 2026
b981f0f
fix(skills): correct managed database migration tool
rishikesh-major Aug 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions plugins/shared/skills/resources_managed-database/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ After setup completes and you have the resource ID:

1. **MCP tools** (direct SQL, no code needed):
- `mcp__resources__postgresql_psql` — Read-only SQL queries and psql commands (`\dt`, `\d`, etc.). Args: `resourceId`, `command`
- `mcp__resources__postgresql_run_migration` — DDL/DML migrations (managed databases only). Args: `resourceId`, `migration`, `description?`
- `mcp__orchestrator-platform__run_migration` — DDL/DML migrations on the application's managed database. Args: `migration`, `description`, plus `applicationId` in org-scoped sessions.

2. **Generated TypeScript clients** (for app code):
- Call `mcp__resource-tools__add-resource-client` with the `resourceId` to generate a typed PostgreSQL client
Expand All @@ -48,7 +48,7 @@ In `mcp__resources__list_resources`, managed databases have `isManaged: true` an
- `managedScope: "app"` — App-scoped, belongs to this application only
- `managedScope: "org"` — Org-scoped, shared across all apps in the organization

The `postgresql_run_migration` tool only works on managed databases. Regular (external) PostgreSQL resources have `isManaged: false`.
The `mcp__orchestrator-platform__run_migration` tool only works on managed databases. Regular (external) PostgreSQL resources have `isManaged: false`.

## Choosing Between App and Org Databases

Expand All @@ -60,6 +60,6 @@ reason that data that should be shared for the entire org.
## Tips

- Use `postgresql_psql` for read-only exploration (schema inspection, SELECT queries)
- Use `postgresql_run_migration` for all schema changes and data modifications on managed databases
- Use `mcp__orchestrator-platform__run_migration` for all schema changes and data modifications on managed databases
- Use parameterized queries (`$1`, `$2`, ...) — never interpolate values into SQL strings
- After creating tables with `run_migration`, generate a TypeScript client for the app to use in code
- After creating tables with `mcp__orchestrator-platform__run_migration`, generate a TypeScript client for the app to use in code
Loading