register-external-resource
Use when registering a Registered External resource from Marketplace chat (`/register-external-resource`).
Files1
View on GitHubSKILL.mdskills/register-external-resource/SKILL.md
GitHubRegister External resource
This creates a Registered External resource — an org-level integration projects can consume, with config keys whose values are filled per environment on the form, never in chat.
The instruction's trailing text is the user's idea, in their words. It is a brief, not a schema.
When unsure, ask — never invent a schema
If the idea does not pin a name, what the resource is, how consumers should
call it, or which config keys exist, stop and ask with ask_question /
ask_questions. Do not invent a schema to look finished.
grilling owns the question mechanics. Ask only questions whose answers change
the draft.
When sure (or after answers), draft
Call draftExternalResource with:
- name — the resource identity
- description — what the resource is
- provider — the concrete system it is ("Open Exchange Rates", "Stripe")
- consumption instructions — how a consuming project should use it; distinct from description, never a restatement of it
- config keys — each with
key,description, andsecret - contract — the provider's published contract document, as a
type(openapi, graphql, sdk, asyncapi, protobuf, documentation) and its URL. The platform fetches the document once and keeps a copy in the organization's registry; projects that reuse the resource get that copy. Never paste the document itself - resource-docs — optional, URL-only
Secrets stay off this channel
Never put env values or secret bytes in the draft, in questions, or in narration. Environment values are form-only.
Edit
On edit, never change name or config key identities. You may refine
description, provider, consumption instructions, the contract document,
existing key descriptions, and URL resource-docs. Do not add or rename keys.