[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-apache-cayenne-db-import":3,"mdc-81y87t-key":42,"related-org-apache-cayenne-db-import":1168,"related-repo-apache-cayenne-db-import":1308},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":37,"sourceUrl":40,"mdContent":41},"cayenne-db-import","import database schema into Cayenne DataMaps","Use this skill when the user wants to import database schema metadata into a Cayenne DataMap — the *model\u002Fmapping only*, not names or Java classes. Trigger on phrases like 'reverse engineer the database', 'import the schema', 'generate a DataMap from my DB', 'add the new tables from the DB into the model', 'import the customer table', 'create entities from these tables', or any request to read database metadata to populate or update a DataMap's XML. This is for *full schema* or *bulk table* import; one-off a-la-carte entity additions belong in the cayenne-modeling skill. IMPORTANT — scope: this imports the mapping ONLY; it does not clean up the Object-layer names or (re)generate Java classes. When the user wants their whole project brought in line with the DB ('sync my project with the database', 'my schema changed, update everything', 'update my entities\u002Fclasses from the DB'), that is the end-to-end `cayenne-full-db-sync` skill, which runs this import and then name cleanup and class generation. To regenerate classes alone use `cayenne-cgen`. The skill runs reverse engineering directly via the `mcp__cayenne__dbimport_run` MCP tool when a DBConnector is already configured; otherwise it opens the CayenneModeler GUI via `mcp__cayenne__open_project` to configure the connection first.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"apache","Apache Software Foundation","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fapache.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Java","java","tag",{"name":17,"slug":18,"type":15},"Database","database",{"name":20,"slug":21,"type":15},"ORM","orm",{"name":23,"slug":24,"type":15},"SQL","sql",343,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fcayenne","2026-07-19T05:40:33.655062",null,137,[31,18,14,32,33,34,35,36],"cayenne","library","network-client","network-server","web-framework","xml",{"repoUrl":26,"stars":25,"forks":29,"topics":38,"description":39},[31,18,14,32,33,34,35,36],"Mirror of Apache Cayenne","https:\u002F\u002Fgithub.com\u002Fapache\u002Fcayenne\u002Ftree\u002FHEAD\u002Fai-plugin\u002Fskills\u002Fcayenne-db-import","---\nname: cayenne-db-import\ndescription: \"Use this skill when the user wants to import database schema metadata into a Cayenne DataMap — the *model\u002Fmapping only*, not names or Java classes. Trigger on phrases like 'reverse engineer the database', 'import the schema', 'generate a DataMap from my DB', 'add the new tables from the DB into the model', 'import the customer table', 'create entities from these tables', or any request to read database metadata to populate or update a DataMap's XML. This is for *full schema* or *bulk table* import; one-off a-la-carte entity additions belong in the cayenne-modeling skill. IMPORTANT — scope: this imports the mapping ONLY; it does not clean up the Object-layer names or (re)generate Java classes. When the user wants their whole project brought in line with the DB ('sync my project with the database', 'my schema changed, update everything', 'update my entities\u002Fclasses from the DB'), that is the end-to-end `cayenne-full-db-sync` skill, which runs this import and then name cleanup and class generation. To regenerate classes alone use `cayenne-cgen`. The skill runs reverse engineering directly via the `mcp__cayenne__dbimport_run` MCP tool when a DBConnector is already configured; otherwise it opens the CayenneModeler GUI via `mcp__cayenne__open_project` to configure the connection first.\"\n---\n\n\u003C!--\n\tLicensed to the Apache Software Foundation (ASF) under one\n\tor more contributor license agreements.  See the NOTICE file\n\tdistributed with this work for additional information\n\tregarding copyright ownership.  The ASF licenses this file\n\tto you under the Apache License, Version 2.0 (the\n\t\"License\"); you may not use this file except in compliance\n\twith the License.  You may obtain a copy of the License at\n\t\n\thttps:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0\n\t\n\tUnless required by applicable law or agreed to in writing,\n\tsoftware distributed under the License is distributed on an\n\t\"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n\tKIND, either express or implied.  See the License for the\n\tspecific language governing permissions and limitations\n\tunder the License.   \n-->\n# cayenne-db-import\n\nImport a database schema into a Cayenne DataMap using the `mcp__cayenne__dbimport_run` MCP tool. If a DBConnector is already stored in preferences for the DataMap the import runs directly without any GUI interaction. When the connection has not been configured yet, the workflow launches CayenneModeler and walks the user through the dialog once to save the connection, then re-runs `dbimport_run`.\n\n## Required reading\n\n- `${CLAUDE_PLUGIN_ROOT}\u002Freferences\u002Fproject-layout.md` — locate or create the project descriptor.\n- `${CLAUDE_PLUGIN_ROOT}\u002Freferences\u002Fdbimport-config.md` — field semantics for every dialog screen, so you can explain options in user terms.\n- `${CLAUDE_PLUGIN_ROOT}\u002Freferences\u002Fmcp-tools.md` — `dbimport_run` and `open_project` tool references and failure modes.\n\n## Step 1 — Confirm scope\n\nAsk the user (one question, only if not obvious from the request):\n\n- Are they reverse-engineering into a **new DataMap**, or **adding\u002Fupdating** entities in an **existing DataMap**?\n\n## Step 2 — Locate or create the project\n\nFollow `project-layout.md` to find the existing `cayenne-*.xml`. If none exists, the user is starting from scratch:\n\n- Either generate a minimal descriptor first (use `cayenne-modeling`'s patterns — namespace `http:\u002F\u002Fcayenne.apache.org\u002Fschema\u002F12\u002Fdomain`, `project-version=\"12\"`, one empty `\u003Cmap name=\"...\"\u002F>` plus a sibling empty `*.map.xml`), or\n- Tell the user to use **File → New Project** inside the Modeler once it's open.\n\nThe descriptor path needs to be **absolute** when passed to the MCP tools.\n\n## Step 3 — Run `dbimport_run`\n\nCall the MCP tool:\n\n```\nmcp__cayenne__dbimport_run({ \"projectPath\": \"\u003Cabsolute path to cayenne-*.xml>\", \"dataMap\": \"\u003CDataMap name>\" })\n```\n\nIf the tool is not available (server not registered), surface `cayenne-mcp-server\u002FREADME.md` and stop. **Do not** suggest `mvn cayenne:cdbimport` or any Gradle equivalent — those build plugins are out of scope.\n\n### Interpreting the result\n\n- **`imported`** — success. Surface the `summary` counters (entities added\u002Fremoved\u002Fmodified, relationships added) to the user.\n- **`up_to_date`** — the DataMap already matches the database. Tell the user nothing changed.\n- **`error`** — import started but failed mid-run. Show the `error.message` and the partial `summary`.\n- **`validation_failed`** — a pre-flight check failed. Use the `error.code` to guide next steps (see below).\n\n### Validation failures and their remediation\n\n| Code | What failed | What to do |\n|---|---|---|\n| `project_not_found` | Project path not readable | Verify path. |\n| `project_parse_failed` | File is not a valid Cayenne descriptor | Confirm the file is a `cayenne-*.xml`. |\n| `datamap_not_found` | DataMap name not in project | The error message lists available names; use one. |\n| `dbconnector_not_configured` | No connection saved for this DataMap | → Go to **Step 4** to configure via the Modeler dialog. |\n| `jdbc_driver_not_loadable` | Driver jar not on the Modeler classpath | Open CayenneModeler → Preferences → Classpath, add the driver jar, save, then re-run. |\n| `jdbc_connection_failed` | Connection could not be opened | Check JDBC URL, credentials, and network access. |\n\n## Step 4 — Configure the connection (first-time only)\n\nThis step is only needed when `dbimport_run` returns `dbconnector_not_configured`.\n\n### 4a — Launch the Modeler\n\n```\nmcp__cayenne__open_project({ \"projectPath\": \"\u003Cabsolute path to cayenne-*.xml>\" })\n```\n\nIf `open_project` returns a non-`ok` status, surface the error code; common ones are `modeler_not_found`, `project_not_found`, `handshake_timeout`. Don't retry blindly — diagnose first.\n\n### 4b — Walk the user through the dialog\n\nThe user now has the Modeler open. Give them the exact GUI sequence:\n\n1. **DataMap → DB Import tab**\n2. **Data Source** dialog:\n   - **JDBC Driver** — e.g., `org.postgresql.Driver`\n   - **DB URL** — full JDBC URL\n   - **User Name \u002F Password** — credentials\n   - **Cayenne Adapter** (optional, autodetected for known DBs)\n   - Click **Test Connection**, then **Continue**.\n3. **Configure** screen — set table\u002Fcolumn\u002Fprocedure filters:\n   - Include\u002Fexclude regex patterns under the relevant catalog\u002Fschema.\n   - **Table Types** — usually `TABLE`; add `VIEW` if needed.\n4. **Naming** screen:\n   - **Naming Strategy**, **Strip from Table Names**, **Default Package**, **Meaningful PK Tables**.\n   - See `dbimport-config.md` for what each does.\n5. **Other Options** — toggles for `skipPrimaryKeyLoading`, `skipRelationshipsLoading`, etc.\n6. Click **Save** (not **Run Import** — the goal here is to save the connection, not run the import through the GUI).\n\nAfter the user saves, the DBConnector is written to CayenneModeler preferences.\n\n### 4c — Re-run `dbimport_run`\n\nGo back to **Step 3** and call `dbimport_run` again. This time it should find the saved connection and proceed.\n\n## Step 5 — Confirm and follow up\n\nOnce the import succeeds:\n\n- Tell the user to **save the project** in the Modeler if it is open (File → Save). The dialog settings persist as a `\u003CdbImport>` block inside the DataMap for repeat runs.\n- Hand off to `cayenne-cgen` to regenerate Java classes for the new\u002Fchanged entities. Quote the DataMap name so the cgen skill can pass it to `cgen_run`.\n- If the imported names look awkward (run-together words, `team1`-style relationship names, a table prefix leaking into relationships), you can **offer** the `cayenne-model-naming` skill to polish them — ideally before cgen. Only run it if the user asks; do not invoke it automatically.\n- If the DB has columns that don't follow the user's preferred naming, recommend tweaking the naming strategy and re-running.\n\n## Anti-patterns\n\n- **Do not** suggest `mvn cayenne:cdbimport`, the Gradle `cdbimport` task, or hand-running the `cayenne-dbsync` Java APIs. `dbimport_run` is the only supported execution path.\n- **Do not** try to hand-write a DataMap from a DB schema description as a substitute — the import handles JDBC types, PK detection, FK relationships, and naming consistently. Hand-rolling produces subtle mistakes.\n- **Do not** enable `forceDataMapCatalog` \u002F `forceDataMapSchema` defensively. They suppress legitimate DB metadata and cause hard-to-debug issues in multi-catalog setups.\n- **Do not** offer reverse engineering without MCP — if the server isn't connected, point at `cayenne-mcp-server\u002FREADME.md` and stop.\n- **Do not** run the import through the Modeler GUI dialog when `dbimport_run` is available — the GUI path is only for the first-time connection setup.\n",{"data":43,"body":44},{"name":4,"description":6},{"type":45,"children":46},"root",[47,54,77,84,137,143,148,178,184,205,265,277,288,293,305,333,340,429,435,613,619,637,643,652,693,699,704,933,938,949,968,974,979,1055,1061],{"type":48,"tag":49,"props":50,"children":51},"element","h1",{"id":4},[52],{"type":53,"value":4},"text",{"type":48,"tag":55,"props":56,"children":57},"p",{},[58,60,67,69,75],{"type":53,"value":59},"Import a database schema into a Cayenne DataMap using the ",{"type":48,"tag":61,"props":62,"children":64},"code",{"className":63},[],[65],{"type":53,"value":66},"mcp__cayenne__dbimport_run",{"type":53,"value":68}," MCP tool. If a DBConnector is already stored in preferences for the DataMap the import runs directly without any GUI interaction. When the connection has not been configured yet, the workflow launches CayenneModeler and walks the user through the dialog once to save the connection, then re-runs ",{"type":48,"tag":61,"props":70,"children":72},{"className":71},[],[73],{"type":53,"value":74},"dbimport_run",{"type":53,"value":76},".",{"type":48,"tag":78,"props":79,"children":81},"h2",{"id":80},"required-reading",[82],{"type":53,"value":83},"Required reading",{"type":48,"tag":85,"props":86,"children":87},"ul",{},[88,100,111],{"type":48,"tag":89,"props":90,"children":91},"li",{},[92,98],{"type":48,"tag":61,"props":93,"children":95},{"className":94},[],[96],{"type":53,"value":97},"${CLAUDE_PLUGIN_ROOT}\u002Freferences\u002Fproject-layout.md",{"type":53,"value":99}," — locate or create the project descriptor.",{"type":48,"tag":89,"props":101,"children":102},{},[103,109],{"type":48,"tag":61,"props":104,"children":106},{"className":105},[],[107],{"type":53,"value":108},"${CLAUDE_PLUGIN_ROOT}\u002Freferences\u002Fdbimport-config.md",{"type":53,"value":110}," — field semantics for every dialog screen, so you can explain options in user terms.",{"type":48,"tag":89,"props":112,"children":113},{},[114,120,122,127,129,135],{"type":48,"tag":61,"props":115,"children":117},{"className":116},[],[118],{"type":53,"value":119},"${CLAUDE_PLUGIN_ROOT}\u002Freferences\u002Fmcp-tools.md",{"type":53,"value":121}," — ",{"type":48,"tag":61,"props":123,"children":125},{"className":124},[],[126],{"type":53,"value":74},{"type":53,"value":128}," and ",{"type":48,"tag":61,"props":130,"children":132},{"className":131},[],[133],{"type":53,"value":134},"open_project",{"type":53,"value":136}," tool references and failure modes.",{"type":48,"tag":78,"props":138,"children":140},{"id":139},"step-1-confirm-scope",[141],{"type":53,"value":142},"Step 1 — Confirm scope",{"type":48,"tag":55,"props":144,"children":145},{},[146],{"type":53,"value":147},"Ask the user (one question, only if not obvious from the request):",{"type":48,"tag":85,"props":149,"children":150},{},[151],{"type":48,"tag":89,"props":152,"children":153},{},[154,156,162,164,169,171,176],{"type":53,"value":155},"Are they reverse-engineering into a ",{"type":48,"tag":157,"props":158,"children":159},"strong",{},[160],{"type":53,"value":161},"new DataMap",{"type":53,"value":163},", or ",{"type":48,"tag":157,"props":165,"children":166},{},[167],{"type":53,"value":168},"adding\u002Fupdating",{"type":53,"value":170}," entities in an ",{"type":48,"tag":157,"props":172,"children":173},{},[174],{"type":53,"value":175},"existing DataMap",{"type":53,"value":177},"?",{"type":48,"tag":78,"props":179,"children":181},{"id":180},"step-2-locate-or-create-the-project",[182],{"type":53,"value":183},"Step 2 — Locate or create the project",{"type":48,"tag":55,"props":185,"children":186},{},[187,189,195,197,203],{"type":53,"value":188},"Follow ",{"type":48,"tag":61,"props":190,"children":192},{"className":191},[],[193],{"type":53,"value":194},"project-layout.md",{"type":53,"value":196}," to find the existing ",{"type":48,"tag":61,"props":198,"children":200},{"className":199},[],[201],{"type":53,"value":202},"cayenne-*.xml",{"type":53,"value":204},". If none exists, the user is starting from scratch:",{"type":48,"tag":85,"props":206,"children":207},{},[208,253],{"type":48,"tag":89,"props":209,"children":210},{},[211,213,219,221,227,229,235,237,243,245,251],{"type":53,"value":212},"Either generate a minimal descriptor first (use ",{"type":48,"tag":61,"props":214,"children":216},{"className":215},[],[217],{"type":53,"value":218},"cayenne-modeling",{"type":53,"value":220},"'s patterns — namespace ",{"type":48,"tag":61,"props":222,"children":224},{"className":223},[],[225],{"type":53,"value":226},"http:\u002F\u002Fcayenne.apache.org\u002Fschema\u002F12\u002Fdomain",{"type":53,"value":228},", ",{"type":48,"tag":61,"props":230,"children":232},{"className":231},[],[233],{"type":53,"value":234},"project-version=\"12\"",{"type":53,"value":236},", one empty ",{"type":48,"tag":61,"props":238,"children":240},{"className":239},[],[241],{"type":53,"value":242},"\u003Cmap name=\"...\"\u002F>",{"type":53,"value":244}," plus a sibling empty ",{"type":48,"tag":61,"props":246,"children":248},{"className":247},[],[249],{"type":53,"value":250},"*.map.xml",{"type":53,"value":252},"), or",{"type":48,"tag":89,"props":254,"children":255},{},[256,258,263],{"type":53,"value":257},"Tell the user to use ",{"type":48,"tag":157,"props":259,"children":260},{},[261],{"type":53,"value":262},"File → New Project",{"type":53,"value":264}," inside the Modeler once it's open.",{"type":48,"tag":55,"props":266,"children":267},{},[268,270,275],{"type":53,"value":269},"The descriptor path needs to be ",{"type":48,"tag":157,"props":271,"children":272},{},[273],{"type":53,"value":274},"absolute",{"type":53,"value":276}," when passed to the MCP tools.",{"type":48,"tag":78,"props":278,"children":280},{"id":279},"step-3-run-dbimport_run",[281,283],{"type":53,"value":282},"Step 3 — Run ",{"type":48,"tag":61,"props":284,"children":286},{"className":285},[],[287],{"type":53,"value":74},{"type":48,"tag":55,"props":289,"children":290},{},[291],{"type":53,"value":292},"Call the MCP tool:",{"type":48,"tag":294,"props":295,"children":299},"pre",{"className":296,"code":298,"language":53},[297],"language-text","mcp__cayenne__dbimport_run({ \"projectPath\": \"\u003Cabsolute path to cayenne-*.xml>\", \"dataMap\": \"\u003CDataMap name>\" })\n",[300],{"type":48,"tag":61,"props":301,"children":303},{"__ignoreMap":302},"",[304],{"type":53,"value":298},{"type":48,"tag":55,"props":306,"children":307},{},[308,310,316,318,323,325,331],{"type":53,"value":309},"If the tool is not available (server not registered), surface ",{"type":48,"tag":61,"props":311,"children":313},{"className":312},[],[314],{"type":53,"value":315},"cayenne-mcp-server\u002FREADME.md",{"type":53,"value":317}," and stop. ",{"type":48,"tag":157,"props":319,"children":320},{},[321],{"type":53,"value":322},"Do not",{"type":53,"value":324}," suggest ",{"type":48,"tag":61,"props":326,"children":328},{"className":327},[],[329],{"type":53,"value":330},"mvn cayenne:cdbimport",{"type":53,"value":332}," or any Gradle equivalent — those build plugins are out of scope.",{"type":48,"tag":334,"props":335,"children":337},"h3",{"id":336},"interpreting-the-result",[338],{"type":53,"value":339},"Interpreting the result",{"type":48,"tag":85,"props":341,"children":342},{},[343,365,379,407],{"type":48,"tag":89,"props":344,"children":345},{},[346,355,357,363],{"type":48,"tag":157,"props":347,"children":348},{},[349],{"type":48,"tag":61,"props":350,"children":352},{"className":351},[],[353],{"type":53,"value":354},"imported",{"type":53,"value":356}," — success. Surface the ",{"type":48,"tag":61,"props":358,"children":360},{"className":359},[],[361],{"type":53,"value":362},"summary",{"type":53,"value":364}," counters (entities added\u002Fremoved\u002Fmodified, relationships added) to the user.",{"type":48,"tag":89,"props":366,"children":367},{},[368,377],{"type":48,"tag":157,"props":369,"children":370},{},[371],{"type":48,"tag":61,"props":372,"children":374},{"className":373},[],[375],{"type":53,"value":376},"up_to_date",{"type":53,"value":378}," — the DataMap already matches the database. Tell the user nothing changed.",{"type":48,"tag":89,"props":380,"children":381},{},[382,391,393,399,401,406],{"type":48,"tag":157,"props":383,"children":384},{},[385],{"type":48,"tag":61,"props":386,"children":388},{"className":387},[],[389],{"type":53,"value":390},"error",{"type":53,"value":392}," — import started but failed mid-run. Show the ",{"type":48,"tag":61,"props":394,"children":396},{"className":395},[],[397],{"type":53,"value":398},"error.message",{"type":53,"value":400}," and the partial ",{"type":48,"tag":61,"props":402,"children":404},{"className":403},[],[405],{"type":53,"value":362},{"type":53,"value":76},{"type":48,"tag":89,"props":408,"children":409},{},[410,419,421,427],{"type":48,"tag":157,"props":411,"children":412},{},[413],{"type":48,"tag":61,"props":414,"children":416},{"className":415},[],[417],{"type":53,"value":418},"validation_failed",{"type":53,"value":420}," — a pre-flight check failed. Use the ",{"type":48,"tag":61,"props":422,"children":424},{"className":423},[],[425],{"type":53,"value":426},"error.code",{"type":53,"value":428}," to guide next steps (see below).",{"type":48,"tag":334,"props":430,"children":432},{"id":431},"validation-failures-and-their-remediation",[433],{"type":53,"value":434},"Validation failures and their remediation",{"type":48,"tag":436,"props":437,"children":438},"table",{},[439,463],{"type":48,"tag":440,"props":441,"children":442},"thead",{},[443],{"type":48,"tag":444,"props":445,"children":446},"tr",{},[447,453,458],{"type":48,"tag":448,"props":449,"children":450},"th",{},[451],{"type":53,"value":452},"Code",{"type":48,"tag":448,"props":454,"children":455},{},[456],{"type":53,"value":457},"What failed",{"type":48,"tag":448,"props":459,"children":460},{},[461],{"type":53,"value":462},"What to do",{"type":48,"tag":464,"props":465,"children":466},"tbody",{},[467,490,518,540,569,591],{"type":48,"tag":444,"props":468,"children":469},{},[470,480,485],{"type":48,"tag":471,"props":472,"children":473},"td",{},[474],{"type":48,"tag":61,"props":475,"children":477},{"className":476},[],[478],{"type":53,"value":479},"project_not_found",{"type":48,"tag":471,"props":481,"children":482},{},[483],{"type":53,"value":484},"Project path not readable",{"type":48,"tag":471,"props":486,"children":487},{},[488],{"type":53,"value":489},"Verify path.",{"type":48,"tag":444,"props":491,"children":492},{},[493,502,507],{"type":48,"tag":471,"props":494,"children":495},{},[496],{"type":48,"tag":61,"props":497,"children":499},{"className":498},[],[500],{"type":53,"value":501},"project_parse_failed",{"type":48,"tag":471,"props":503,"children":504},{},[505],{"type":53,"value":506},"File is not a valid Cayenne descriptor",{"type":48,"tag":471,"props":508,"children":509},{},[510,512,517],{"type":53,"value":511},"Confirm the file is a ",{"type":48,"tag":61,"props":513,"children":515},{"className":514},[],[516],{"type":53,"value":202},{"type":53,"value":76},{"type":48,"tag":444,"props":519,"children":520},{},[521,530,535],{"type":48,"tag":471,"props":522,"children":523},{},[524],{"type":48,"tag":61,"props":525,"children":527},{"className":526},[],[528],{"type":53,"value":529},"datamap_not_found",{"type":48,"tag":471,"props":531,"children":532},{},[533],{"type":53,"value":534},"DataMap name not in project",{"type":48,"tag":471,"props":536,"children":537},{},[538],{"type":53,"value":539},"The error message lists available names; use one.",{"type":48,"tag":444,"props":541,"children":542},{},[543,552,557],{"type":48,"tag":471,"props":544,"children":545},{},[546],{"type":48,"tag":61,"props":547,"children":549},{"className":548},[],[550],{"type":53,"value":551},"dbconnector_not_configured",{"type":48,"tag":471,"props":553,"children":554},{},[555],{"type":53,"value":556},"No connection saved for this DataMap",{"type":48,"tag":471,"props":558,"children":559},{},[560,562,567],{"type":53,"value":561},"→ Go to ",{"type":48,"tag":157,"props":563,"children":564},{},[565],{"type":53,"value":566},"Step 4",{"type":53,"value":568}," to configure via the Modeler dialog.",{"type":48,"tag":444,"props":570,"children":571},{},[572,581,586],{"type":48,"tag":471,"props":573,"children":574},{},[575],{"type":48,"tag":61,"props":576,"children":578},{"className":577},[],[579],{"type":53,"value":580},"jdbc_driver_not_loadable",{"type":48,"tag":471,"props":582,"children":583},{},[584],{"type":53,"value":585},"Driver jar not on the Modeler classpath",{"type":48,"tag":471,"props":587,"children":588},{},[589],{"type":53,"value":590},"Open CayenneModeler → Preferences → Classpath, add the driver jar, save, then re-run.",{"type":48,"tag":444,"props":592,"children":593},{},[594,603,608],{"type":48,"tag":471,"props":595,"children":596},{},[597],{"type":48,"tag":61,"props":598,"children":600},{"className":599},[],[601],{"type":53,"value":602},"jdbc_connection_failed",{"type":48,"tag":471,"props":604,"children":605},{},[606],{"type":53,"value":607},"Connection could not be opened",{"type":48,"tag":471,"props":609,"children":610},{},[611],{"type":53,"value":612},"Check JDBC URL, credentials, and network access.",{"type":48,"tag":78,"props":614,"children":616},{"id":615},"step-4-configure-the-connection-first-time-only",[617],{"type":53,"value":618},"Step 4 — Configure the connection (first-time only)",{"type":48,"tag":55,"props":620,"children":621},{},[622,624,629,631,636],{"type":53,"value":623},"This step is only needed when ",{"type":48,"tag":61,"props":625,"children":627},{"className":626},[],[628],{"type":53,"value":74},{"type":53,"value":630}," returns ",{"type":48,"tag":61,"props":632,"children":634},{"className":633},[],[635],{"type":53,"value":551},{"type":53,"value":76},{"type":48,"tag":334,"props":638,"children":640},{"id":639},"_4a-launch-the-modeler",[641],{"type":53,"value":642},"4a — Launch the Modeler",{"type":48,"tag":294,"props":644,"children":647},{"className":645,"code":646,"language":53},[297],"mcp__cayenne__open_project({ \"projectPath\": \"\u003Cabsolute path to cayenne-*.xml>\" })\n",[648],{"type":48,"tag":61,"props":649,"children":650},{"__ignoreMap":302},[651],{"type":53,"value":646},{"type":48,"tag":55,"props":653,"children":654},{},[655,657,662,664,670,672,678,679,684,685,691],{"type":53,"value":656},"If ",{"type":48,"tag":61,"props":658,"children":660},{"className":659},[],[661],{"type":53,"value":134},{"type":53,"value":663}," returns a non-",{"type":48,"tag":61,"props":665,"children":667},{"className":666},[],[668],{"type":53,"value":669},"ok",{"type":53,"value":671}," status, surface the error code; common ones are ",{"type":48,"tag":61,"props":673,"children":675},{"className":674},[],[676],{"type":53,"value":677},"modeler_not_found",{"type":53,"value":228},{"type":48,"tag":61,"props":680,"children":682},{"className":681},[],[683],{"type":53,"value":479},{"type":53,"value":228},{"type":48,"tag":61,"props":686,"children":688},{"className":687},[],[689],{"type":53,"value":690},"handshake_timeout",{"type":53,"value":692},". Don't retry blindly — diagnose first.",{"type":48,"tag":334,"props":694,"children":696},{"id":695},"_4b-walk-the-user-through-the-dialog",[697],{"type":53,"value":698},"4b — Walk the user through the dialog",{"type":48,"tag":55,"props":700,"children":701},{},[702],{"type":53,"value":703},"The user now has the Modeler open. Give them the exact GUI sequence:",{"type":48,"tag":705,"props":706,"children":707},"ol",{},[708,716,793,837,890,915],{"type":48,"tag":89,"props":709,"children":710},{},[711],{"type":48,"tag":157,"props":712,"children":713},{},[714],{"type":53,"value":715},"DataMap → DB Import tab",{"type":48,"tag":89,"props":717,"children":718},{},[719,724,726],{"type":48,"tag":157,"props":720,"children":721},{},[722],{"type":53,"value":723},"Data Source",{"type":53,"value":725}," dialog:\n",{"type":48,"tag":85,"props":727,"children":728},{},[729,745,755,765,775],{"type":48,"tag":89,"props":730,"children":731},{},[732,737,739],{"type":48,"tag":157,"props":733,"children":734},{},[735],{"type":53,"value":736},"JDBC Driver",{"type":53,"value":738}," — e.g., ",{"type":48,"tag":61,"props":740,"children":742},{"className":741},[],[743],{"type":53,"value":744},"org.postgresql.Driver",{"type":48,"tag":89,"props":746,"children":747},{},[748,753],{"type":48,"tag":157,"props":749,"children":750},{},[751],{"type":53,"value":752},"DB URL",{"type":53,"value":754}," — full JDBC URL",{"type":48,"tag":89,"props":756,"children":757},{},[758,763],{"type":48,"tag":157,"props":759,"children":760},{},[761],{"type":53,"value":762},"User Name \u002F Password",{"type":53,"value":764}," — credentials",{"type":48,"tag":89,"props":766,"children":767},{},[768,773],{"type":48,"tag":157,"props":769,"children":770},{},[771],{"type":53,"value":772},"Cayenne Adapter",{"type":53,"value":774}," (optional, autodetected for known DBs)",{"type":48,"tag":89,"props":776,"children":777},{},[778,780,785,787,792],{"type":53,"value":779},"Click ",{"type":48,"tag":157,"props":781,"children":782},{},[783],{"type":53,"value":784},"Test Connection",{"type":53,"value":786},", then ",{"type":48,"tag":157,"props":788,"children":789},{},[790],{"type":53,"value":791},"Continue",{"type":53,"value":76},{"type":48,"tag":89,"props":794,"children":795},{},[796,801,803],{"type":48,"tag":157,"props":797,"children":798},{},[799],{"type":53,"value":800},"Configure",{"type":53,"value":802}," screen — set table\u002Fcolumn\u002Fprocedure filters:\n",{"type":48,"tag":85,"props":804,"children":805},{},[806,811],{"type":48,"tag":89,"props":807,"children":808},{},[809],{"type":53,"value":810},"Include\u002Fexclude regex patterns under the relevant catalog\u002Fschema.",{"type":48,"tag":89,"props":812,"children":813},{},[814,819,821,827,829,835],{"type":48,"tag":157,"props":815,"children":816},{},[817],{"type":53,"value":818},"Table Types",{"type":53,"value":820}," — usually ",{"type":48,"tag":61,"props":822,"children":824},{"className":823},[],[825],{"type":53,"value":826},"TABLE",{"type":53,"value":828},"; add ",{"type":48,"tag":61,"props":830,"children":832},{"className":831},[],[833],{"type":53,"value":834},"VIEW",{"type":53,"value":836}," if needed.",{"type":48,"tag":89,"props":838,"children":839},{},[840,845,847],{"type":48,"tag":157,"props":841,"children":842},{},[843],{"type":53,"value":844},"Naming",{"type":53,"value":846}," screen:\n",{"type":48,"tag":85,"props":848,"children":849},{},[850,877],{"type":48,"tag":89,"props":851,"children":852},{},[853,858,859,864,865,870,871,876],{"type":48,"tag":157,"props":854,"children":855},{},[856],{"type":53,"value":857},"Naming Strategy",{"type":53,"value":228},{"type":48,"tag":157,"props":860,"children":861},{},[862],{"type":53,"value":863},"Strip from Table Names",{"type":53,"value":228},{"type":48,"tag":157,"props":866,"children":867},{},[868],{"type":53,"value":869},"Default Package",{"type":53,"value":228},{"type":48,"tag":157,"props":872,"children":873},{},[874],{"type":53,"value":875},"Meaningful PK Tables",{"type":53,"value":76},{"type":48,"tag":89,"props":878,"children":879},{},[880,882,888],{"type":53,"value":881},"See ",{"type":48,"tag":61,"props":883,"children":885},{"className":884},[],[886],{"type":53,"value":887},"dbimport-config.md",{"type":53,"value":889}," for what each does.",{"type":48,"tag":89,"props":891,"children":892},{},[893,898,900,906,907,913],{"type":48,"tag":157,"props":894,"children":895},{},[896],{"type":53,"value":897},"Other Options",{"type":53,"value":899}," — toggles for ",{"type":48,"tag":61,"props":901,"children":903},{"className":902},[],[904],{"type":53,"value":905},"skipPrimaryKeyLoading",{"type":53,"value":228},{"type":48,"tag":61,"props":908,"children":910},{"className":909},[],[911],{"type":53,"value":912},"skipRelationshipsLoading",{"type":53,"value":914},", etc.",{"type":48,"tag":89,"props":916,"children":917},{},[918,919,924,926,931],{"type":53,"value":779},{"type":48,"tag":157,"props":920,"children":921},{},[922],{"type":53,"value":923},"Save",{"type":53,"value":925}," (not ",{"type":48,"tag":157,"props":927,"children":928},{},[929],{"type":53,"value":930},"Run Import",{"type":53,"value":932}," — the goal here is to save the connection, not run the import through the GUI).",{"type":48,"tag":55,"props":934,"children":935},{},[936],{"type":53,"value":937},"After the user saves, the DBConnector is written to CayenneModeler preferences.",{"type":48,"tag":334,"props":939,"children":941},{"id":940},"_4c-re-run-dbimport_run",[942,944],{"type":53,"value":943},"4c — Re-run ",{"type":48,"tag":61,"props":945,"children":947},{"className":946},[],[948],{"type":53,"value":74},{"type":48,"tag":55,"props":950,"children":951},{},[952,954,959,961,966],{"type":53,"value":953},"Go back to ",{"type":48,"tag":157,"props":955,"children":956},{},[957],{"type":53,"value":958},"Step 3",{"type":53,"value":960}," and call ",{"type":48,"tag":61,"props":962,"children":964},{"className":963},[],[965],{"type":53,"value":74},{"type":53,"value":967}," again. This time it should find the saved connection and proceed.",{"type":48,"tag":78,"props":969,"children":971},{"id":970},"step-5-confirm-and-follow-up",[972],{"type":53,"value":973},"Step 5 — Confirm and follow up",{"type":48,"tag":55,"props":975,"children":976},{},[977],{"type":53,"value":978},"Once the import succeeds:",{"type":48,"tag":85,"props":980,"children":981},{},[982,1002,1022,1050],{"type":48,"tag":89,"props":983,"children":984},{},[985,987,992,994,1000],{"type":53,"value":986},"Tell the user to ",{"type":48,"tag":157,"props":988,"children":989},{},[990],{"type":53,"value":991},"save the project",{"type":53,"value":993}," in the Modeler if it is open (File → Save). The dialog settings persist as a ",{"type":48,"tag":61,"props":995,"children":997},{"className":996},[],[998],{"type":53,"value":999},"\u003CdbImport>",{"type":53,"value":1001}," block inside the DataMap for repeat runs.",{"type":48,"tag":89,"props":1003,"children":1004},{},[1005,1007,1013,1015,1021],{"type":53,"value":1006},"Hand off to ",{"type":48,"tag":61,"props":1008,"children":1010},{"className":1009},[],[1011],{"type":53,"value":1012},"cayenne-cgen",{"type":53,"value":1014}," to regenerate Java classes for the new\u002Fchanged entities. Quote the DataMap name so the cgen skill can pass it to ",{"type":48,"tag":61,"props":1016,"children":1018},{"className":1017},[],[1019],{"type":53,"value":1020},"cgen_run",{"type":53,"value":76},{"type":48,"tag":89,"props":1023,"children":1024},{},[1025,1027,1033,1035,1040,1042,1048],{"type":53,"value":1026},"If the imported names look awkward (run-together words, ",{"type":48,"tag":61,"props":1028,"children":1030},{"className":1029},[],[1031],{"type":53,"value":1032},"team1",{"type":53,"value":1034},"-style relationship names, a table prefix leaking into relationships), you can ",{"type":48,"tag":157,"props":1036,"children":1037},{},[1038],{"type":53,"value":1039},"offer",{"type":53,"value":1041}," the ",{"type":48,"tag":61,"props":1043,"children":1045},{"className":1044},[],[1046],{"type":53,"value":1047},"cayenne-model-naming",{"type":53,"value":1049}," skill to polish them — ideally before cgen. Only run it if the user asks; do not invoke it automatically.",{"type":48,"tag":89,"props":1051,"children":1052},{},[1053],{"type":53,"value":1054},"If the DB has columns that don't follow the user's preferred naming, recommend tweaking the naming strategy and re-running.",{"type":48,"tag":78,"props":1056,"children":1058},{"id":1057},"anti-patterns",[1059],{"type":53,"value":1060},"Anti-patterns",{"type":48,"tag":85,"props":1062,"children":1063},{},[1064,1102,1111,1136,1152],{"type":48,"tag":89,"props":1065,"children":1066},{},[1067,1071,1072,1077,1079,1085,1087,1093,1095,1100],{"type":48,"tag":157,"props":1068,"children":1069},{},[1070],{"type":53,"value":322},{"type":53,"value":324},{"type":48,"tag":61,"props":1073,"children":1075},{"className":1074},[],[1076],{"type":53,"value":330},{"type":53,"value":1078},", the Gradle ",{"type":48,"tag":61,"props":1080,"children":1082},{"className":1081},[],[1083],{"type":53,"value":1084},"cdbimport",{"type":53,"value":1086}," task, or hand-running the ",{"type":48,"tag":61,"props":1088,"children":1090},{"className":1089},[],[1091],{"type":53,"value":1092},"cayenne-dbsync",{"type":53,"value":1094}," Java APIs. ",{"type":48,"tag":61,"props":1096,"children":1098},{"className":1097},[],[1099],{"type":53,"value":74},{"type":53,"value":1101}," is the only supported execution path.",{"type":48,"tag":89,"props":1103,"children":1104},{},[1105,1109],{"type":48,"tag":157,"props":1106,"children":1107},{},[1108],{"type":53,"value":322},{"type":53,"value":1110}," try to hand-write a DataMap from a DB schema description as a substitute — the import handles JDBC types, PK detection, FK relationships, and naming consistently. Hand-rolling produces subtle mistakes.",{"type":48,"tag":89,"props":1112,"children":1113},{},[1114,1118,1120,1126,1128,1134],{"type":48,"tag":157,"props":1115,"children":1116},{},[1117],{"type":53,"value":322},{"type":53,"value":1119}," enable ",{"type":48,"tag":61,"props":1121,"children":1123},{"className":1122},[],[1124],{"type":53,"value":1125},"forceDataMapCatalog",{"type":53,"value":1127}," \u002F ",{"type":48,"tag":61,"props":1129,"children":1131},{"className":1130},[],[1132],{"type":53,"value":1133},"forceDataMapSchema",{"type":53,"value":1135}," defensively. They suppress legitimate DB metadata and cause hard-to-debug issues in multi-catalog setups.",{"type":48,"tag":89,"props":1137,"children":1138},{},[1139,1143,1145,1150],{"type":48,"tag":157,"props":1140,"children":1141},{},[1142],{"type":53,"value":322},{"type":53,"value":1144}," offer reverse engineering without MCP — if the server isn't connected, point at ",{"type":48,"tag":61,"props":1146,"children":1148},{"className":1147},[],[1149],{"type":53,"value":315},{"type":53,"value":1151}," and stop.",{"type":48,"tag":89,"props":1153,"children":1154},{},[1155,1159,1161,1166],{"type":48,"tag":157,"props":1156,"children":1157},{},[1158],{"type":53,"value":322},{"type":53,"value":1160}," run the import through the Modeler GUI dialog when ",{"type":48,"tag":61,"props":1162,"children":1164},{"className":1163},[],[1165],{"type":53,"value":74},{"type":53,"value":1167}," is available — the GUI path is only for the first-time connection setup.",{"items":1169,"total":1307},[1170,1186,1200,1213,1226,1239,1250,1257,1267,1277,1287,1296],{"slug":1171,"name":1171,"fn":1172,"description":1173,"org":1174,"tags":1175,"stars":1183,"repoUrl":1184,"updatedAt":1185},"datafusion-python","write Apache DataFusion Python code","Use when the user is writing datafusion-python (Apache DataFusion Python bindings) DataFrame or SQL code. Covers imports, data loading, DataFrame operations, expression building, SQL-to-DataFrame mappings, idiomatic patterns, and common pitfalls.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1176,1179,1182],{"name":1177,"slug":1178,"type":15},"Data Analysis","data-analysis",{"name":1180,"slug":1181,"type":15},"Python","python",{"name":23,"slug":24,"type":15},593,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fdatafusion-python","2026-07-12T08:36:04.957626",{"slug":1187,"name":1187,"fn":1188,"description":1189,"org":1190,"tags":1191,"stars":1197,"repoUrl":1198,"updatedAt":1199},"bydbql","generate and execute BanyanDB BydbQL queries","Generate, validate, and optionally execute read-only BanyanDB BydbQL for STREAM, MEASURE, TRACE, and PROPERTY resources. Use when the user asks to query BanyanDB, translate natural language to BydbQL, inspect BanyanDB schema or data, validate BydbQL, or fetch raw BanyanDB records.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1192,1195,1196],{"name":1193,"slug":1194,"type":15},"Analytics","analytics",{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15},344,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fskywalking-banyandb","2026-07-12T08:31:01.294423",{"slug":1201,"name":1201,"fn":1202,"description":1203,"org":1204,"tags":1205,"stars":1197,"repoUrl":1198,"updatedAt":1212},"compiling","compile and build BanyanDB projects","Compile and build the SkyWalking BanyanDB project. Use when the user asks to compile, build, or generate code for this project.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1206,1209],{"name":1207,"slug":1208,"type":15},"Build","build",{"name":1210,"slug":1211,"type":15},"Engineering","engineering","2026-07-12T08:31:06.373309",{"slug":1214,"name":1214,"fn":1215,"description":1216,"org":1217,"tags":1218,"stars":1197,"repoUrl":1198,"updatedAt":1225},"gh-pull-request","create GitHub pull requests for BanyanDB","Create a GitHub pull request for SkyWalking BanyanDB. Use when the user asks to create a PR, submit changes, or open a pull request.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1219,1222],{"name":1220,"slug":1221,"type":15},"GitHub","github",{"name":1223,"slug":1224,"type":15},"Pull Requests","pull-requests","2026-07-12T08:31:03.792415",{"slug":1227,"name":1227,"fn":1228,"description":1229,"org":1230,"tags":1231,"stars":1197,"repoUrl":1198,"updatedAt":1238},"vendor-update","update Go and Node.js vendor dependencies","Upgrade Go\u002FNode.js vendor dependencies and sync tool versions. Use whenever the user says \"upgrade dependencies\", \"update vendors\", \"vendor update\", \"run vendor-upgrade\", \"bump dependencies\", \"update packages\", or asks to run the `vendor-update` Make target. This skill also checks `scripts\u002Fbuild\u002Fversion.mk` after upgrading to see if any tracked tool versions need updating too, and removes stale binaries from `bin\u002F` when versions change.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1232,1235],{"name":1233,"slug":1234,"type":15},"Go","go",{"name":1236,"slug":1237,"type":15},"Node.js","node-js","2026-07-12T08:31:02.555555",{"slug":1012,"name":1012,"fn":1240,"description":1241,"org":1242,"tags":1243,"stars":25,"repoUrl":26,"updatedAt":1249},"generate Cayenne entity Java classes","Use this skill whenever the user wants to (re)generate Cayenne entity Java classes from a DataMap. Trigger on phrases like 'generate Java classes', 'regenerate entities', 'run cgen', 'create the entity classes', 'why is the Artist class missing fields', 'where did the `_Abstract*` classes come from', 'sync the entity classes with the model', or any request to materialize Java from the DataMap. Also trigger as a follow-up after modeling changes (someone added an entity, attribute, or relationship and now the Java side is stale). This skill exclusively uses the `mcp__cayenne__cgen_run` MCP tool — it does NOT use `mvn cayenne:cgen` or the Gradle cgen task.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1244,1247,1248],{"name":1245,"slug":1246,"type":15},"Data Modeling","data-modeling",{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},"2026-07-12T08:32:33.575211",{"slug":4,"name":4,"fn":5,"description":6,"org":1251,"tags":1252,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1253,1254,1255,1256],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},{"slug":1258,"name":1258,"fn":1259,"description":1260,"org":1261,"tags":1262,"stars":25,"repoUrl":26,"updatedAt":1266},"cayenne-full-db-sync","synchronize Cayenne projects with database","Use this skill when the user wants to bring their WHOLE Cayenne project in line with the database in one shot — the mapping, the Object-layer names, and the generated Java classes together. This is the end-to-end 'sync with the DB' workflow, and it orchestrates three skills in order: `cayenne-db-import` (import schema metadata into the DataMap) → `cayenne-model-naming` (polish the just-imported names) → `cayenne-cgen` (regenerate Java classes). Trigger on holistic phrases like 'sync my project with the database', 'sync with the DB', 'my schema changed, update everything', 'update my entities\u002Fclasses from the database', 'reverse engineer and regenerate the classes', 'import the new tables and rebuild the entities', 'full DB sync', 'bring the model and classes up to date with the DB'. The distinguishing signal is scope: the user wants the whole project (mapping + names + Java code), not just one stage. For the *model\u002Fmapping only* (no name cleanup, no class generation) use `cayenne-db-import`; to (re)generate classes alone use `cayenne-cgen`; to clean names alone use `cayenne-model-naming`. Uses the `mcp__cayenne__dbimport_run` and `mcp__cayenne__cgen_run` MCP tools via the sub-skills; does NOT use Maven or Gradle goals.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1263,1264,1265],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},"2026-07-19T06:03:49.112969",{"slug":1047,"name":1047,"fn":1268,"description":1269,"org":1270,"tags":1271,"stars":25,"repoUrl":26,"updatedAt":1276},"clean up Cayenne object-layer names","Use this skill to clean up Object-layer names in a Cayenne DataMap — ObjEntity, ObjAttribute, and ObjRelationship names, plus DbRelationship names (the first-class unit of relationship cleanup — every FK has one whether or not an ObjRelationship was generated; the ObjRelationship name is synced to it when one exists) — so they read as descriptive, consistent Java. Trigger on phrases like 'clean up the model names', 'fix the entity names', 'these names look ugly', 'make the names descriptive', 'normalize the ObjEntity\u002Fattribute\u002Frelationship names', 'why is this relationship called team1', 'rename entities to be consistent', 'the import produced Gametype instead of GameType'. Invoke it on an explicit user request, or as a manual follow-up after a `cayenne-db-import` to polish the just-imported additions — it is never triggered automatically. IMPORTANT: this is a LIGHT polish pass — CayenneModeler's reverse-engineering already produces good names for the common case; only improve the specific things its deterministic algorithm cannot (run-together names with no separators like `gametype`, meaningless numbered names like `team1` from multiple relationships between two tables, and a common entity prefix that leaks into relationship names like `aaOrders`). Do NOT rewrite names that are already correct. This is Obj-layer naming polish; for structural model edits use `cayenne-modeling`, and for regenerating classes afterward use `cayenne-cgen`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1272,1273,1274,1275],{"name":1245,"slug":1246,"type":15},{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},"2026-07-22T05:35:32.342548",{"slug":1278,"name":1278,"fn":1279,"description":1280,"org":1281,"tags":1282,"stars":25,"repoUrl":26,"updatedAt":1286},"cayenne-modeler","manage Cayenne projects with CayenneModeler","Use this skill when the user explicitly wants to open CayenneModeler (the GUI) on a Cayenne project, or when the modeling task is inherently visual — reverse engineering (delegated to cayenne-db-import), bulk relationship layout, multi-entity visual refactoring. Trigger on phrases like 'open the Modeler', 'open in CayenneModeler', 'launch the GUI', 'edit visually', 'show me the project in the Modeler'. Do NOT trigger as a fallback for ordinary a-la-carte XML edits — those belong in the cayenne-modeling skill, which is faster and doesn't require the user to context-switch.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1283,1284,1285],{"name":1245,"slug":1246,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},"2026-07-12T08:32:37.199428",{"slug":218,"name":218,"fn":1288,"description":1289,"org":1290,"tags":1291,"stars":25,"repoUrl":26,"updatedAt":1295},"edit and extend Cayenne ORM models","Use this skill whenever the user wants to edit, inspect, or extend the Cayenne ORM model in a project — adding or modifying entities, attributes, relationships, embeddables, named queries, stored procedures, or DataNodes. Trigger on phrases like 'add an ObjEntity', 'add a DbEntity', 'add a relationship', 'expose this column as an attribute', 'create a new DataMap', 'add a named query', 'create an embeddable', 'add a stored procedure', 'change the attribute type', 'mark this column as nullable', 'rename this entity', or any mention of a Cayenne `*.map.xml` or `cayenne-*.xml` file. Also trigger when the user references modeling concepts (ObjEntity, DbEntity, ObjAttribute, DbAttribute, ObjRelationship, DbRelationship, Embeddable, dbEntityName, deleteRule, db-attribute-path, db-relationship-path, defaultPackage) in the context of a Cayenne-using app. This is the *primary* skill for a-la-carte ORM model manipulation — direct XML edits, not the Modeler GUI.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1292,1293,1294],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},"2026-07-19T05:40:32.6889",{"slug":1297,"name":1297,"fn":1298,"description":1299,"org":1300,"tags":1301,"stars":25,"repoUrl":26,"updatedAt":1306},"cayenne-query","write and modify Cayenne database queries","Use this skill whenever the user wants to write or modify a Cayenne query — fetching entities by criteria, joining, prefetching to avoid N+1, ordering, paginating, aggregating, or running raw SQL through Cayenne. Trigger on phrases like 'query for X', 'fetch all artists where ...', 'write an ObjectSelect', 'use SQLSelect', 'use SelectById', 'add a prefetch', 'get distinct values', 'count rows', 'find by ID', 'load by primary key', 'build a Cayenne expression', 'why am I getting N+1', 'how do I paginate', 'select a single column', 'select columns into a DTO', 'named query in the DataMap'. Do NOT trigger for modeling changes (use cayenne-modeling) or runtime bootstrap (use cayenne-runtime).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1302,1303,1304,1305],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},"2026-07-12T08:32:35.072322",108,{"items":1309,"total":1355},[1310,1316,1323,1329,1336,1342,1348],{"slug":1012,"name":1012,"fn":1240,"description":1241,"org":1311,"tags":1312,"stars":25,"repoUrl":26,"updatedAt":1249},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1313,1314,1315],{"name":1245,"slug":1246,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"slug":4,"name":4,"fn":5,"description":6,"org":1317,"tags":1318,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1319,1320,1321,1322],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},{"slug":1258,"name":1258,"fn":1259,"description":1260,"org":1324,"tags":1325,"stars":25,"repoUrl":26,"updatedAt":1266},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1326,1327,1328],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"slug":1047,"name":1047,"fn":1268,"description":1269,"org":1330,"tags":1331,"stars":25,"repoUrl":26,"updatedAt":1276},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1332,1333,1334,1335],{"name":1245,"slug":1246,"type":15},{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"slug":1278,"name":1278,"fn":1279,"description":1280,"org":1337,"tags":1338,"stars":25,"repoUrl":26,"updatedAt":1286},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1339,1340,1341],{"name":1245,"slug":1246,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"slug":218,"name":218,"fn":1288,"description":1289,"org":1343,"tags":1344,"stars":25,"repoUrl":26,"updatedAt":1295},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1345,1346,1347],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"slug":1297,"name":1297,"fn":1298,"description":1299,"org":1349,"tags":1350,"stars":25,"repoUrl":26,"updatedAt":1306},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1351,1352,1353,1354],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},8]