mirror of
https://github.com/microsoft/postgres-skills.git
synced 2026-11-04 12:01:44 +00:00
Copilotandaditivgupta
f6811bce4c
The `Routing eval gate` step of the "Tests: pytest suite" job failed
with 1 misroute on both `copilot-cli` and `codex-cli`: routing challenge
`route-61` (VS Code AGE graph visualization) activated
`opencypher-age-patterns` instead of `text-to-cypher`. The pytest step
itself passed — the gate is a separate step in the same job.
**Root cause:** the visualization routing row was added to
`plugin/skills/pg-graph/SKILL.md`, but the corresponding keywords were
never mirrored into `tests/.skills.json` — the manifest the
deterministic host adapters route with. With no visualization keyword in
the manifest, the only match in the challenge query was the literal
"Apache AGE", which belongs to `opencypher-age-patterns`.
### Changes
- **`tests/.skills.json`** — added visualization activation keywords to
the `graph-text-to-cypher` entry so the manifest matches the SKILL.md
routing table:
```json
"activation_keywords": [
"text to cypher", "natural language to cypher", "english to cypher",
"generate cypher", "nl to cypher",
"visualize graph", "visualize my graph", "vs code graph", "graph explorer",
"render the graph", "renders as nodes and edges", "ms-ossdata.vscode-pgsql"
]
```
- **`tests/evals/challenges/routing_challenges.yaml`** — dropped the
"Apache AGE" literal from the `route-61` query. That phrase is an exact
`opencypher-age-patterns` trigger, so it would co-activate regardless of
the manifest fix, and the challenge asserts a single expected skill. The
query still carries unambiguous visualization intent ("visualize my
graph", "renders as nodes and edges").
The remaining diff on this branch (pg-graph HorizonDB/VS Code docs,
`challenges.yaml`, README) is PR #19 content unchanged.
---------
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: aditivgupta <86393637+aditivgupta@users.noreply.github.com>
postgres-skills plugin
The installable plugin payload for the postgres-skills marketplace. It bundles
the PostgreSQL skill and the postgres-mcp MCP server so AI-agent CLIs (GitHub Copilot CLI,
Claude Code, Codex) can route PostgreSQL work to the right guidance and tools.
Contents
| Path | Purpose |
|---|---|
skills/postgresql-best-practices/ |
The skill (SKILL.md routing table + reference docs). |
.mcp.json |
Declares the postgres-mcp MCP server (stdio, npx -y @microsoft/postgres-mcp@<version> run). The pinned version lives here. |
.codex-plugin/plugin.json |
Plugin manifest required by Codex. |
Codex compatibility: plugin.json
Codex requires a manifest at .codex-plugin/plugin.json inside the plugin folder.
Without it, codex plugin add postgres-skills@postgres-skills fails with
Error: missing plugin.json.
It should be updated along with the plugin field in .github/plugin/marketplace.json.