Review and improve manage-apis - Skill

[edipsopa]

The manage-apis skill needs to be reviewed. Right now it says:

apiType is read-only over MCP — a real limitation. You cannot set apiType through
save_api. It is an excluded key in APISaveSchema, so it gets silently stripped —
every MCP-created API ends up as apiType: null. To get a script-backed endpoint,
create/convert the API in the cockpit API Designer first, then use save_api for the paths.

In my understanding save_api does accept API Type today !?

Another improvement is in regards to Error handling, we should mention in the Skill that API Format and API Type can't be changed once created so claude doesn't recommend or try to do that.

[edipsopa]

Additional feedback received from a user testing the MCP plugin:

Claude tried/recommended changing the API Type manually even though the API Type cannot be changed after the API has been created.

When Claude created an API for a server script, it did not define the request/response types correctly. When the user asked Claude to fix them afterwards, it still could not do it properly. This seems related to the manage-apis skill, especially around script-backed APIs and making sure request/response definitions are created correctly from the start.

Using Claude Sonnet 4.6