| name | codemation-credential-development |
| description | Guides Codemation custom credential development with `defineCredential(...)`, typed sessions, credential testing, and node credential slots. Use when creating or updating custom credentials, credential registrations, or credential-aware custom nodes. |
| compatibility | Designed for Codemation apps and plugins that register typed credentials. |
Codemation Credential Development
Use this skill when
Use this skill for defining new credential types, wiring them into apps or plugins, and teaching nodes to request typed credential sessions.
Do not use this skill for general workflow authoring unless credential slots or runtime sessions are the core problem.
Credential binding stability
Credentials bind to a node via (workflowId, nodeId, slotKey). The nodeId defaults to a slug of the node's name label (lowercase, non-alphanumeric runs replaced with -). Renaming a credential-using node's label silently changes its id and the binding appears unbound in the UI — the operator must re-attach manually.
To prevent this: either keep the node's label stable across edits, or set an explicit id: on the node config so the id is decoupled from the label.
Core mental model
- A credential type defines public config, secret material, session creation, and health testing.
- Nodes request credentials through named slots instead of hard-coded secrets.
- Operators configure concrete credential instances in the UI and bind them to those slots.
Authoring rules
- Start with
defineCredential(...).
- Keep
public versus secret fields intentional.
- Make
createSession(...) return the typed runtime object the node actually needs.
- Implement
test(...) so failure states are explicit before workflow activation.
- Register credential types at the app or plugin boundary, not inside random workflow files.
Node integration
- helper-defined nodes can declare credentials directly in
credentials
- class-based nodes can use lower-level credential requirement APIs when needed
Read next when needed
- Read
references/credential-patterns.md for schema, registration, and slot guidance.
