Semogram Docs
PluginsCustom creation

Custom creation

Build, validate, publish and install a custom workspace plugin.

Build a workspace plugin when an internal capability cannot perform the required operation. The plugin authoring workflow generates a package from your instructions, repairs validation failures and runs sandbox validation before publication.

Choose a capability

CapabilityGuideWhat to implement
ConnectorConnectors and fact storesConnection checks, supported reads/writes and target contracts
TransformTransformsParameter validation, named bindings, execution and lineage
MCP serverExternal MCP serversConnection, authentication and supported external tools
Secret providerSecrets and skillsScoped credential resolution
SkillSecrets and skillsBundled instructions with skill frontmatter

One package can expose several capabilities. Keep configuration shared at installation level and operation-specific inputs on each capability.

Create and install

  1. Write the specification and generate.
  2. Inspect the package format and implementation.
  3. Review tests and sandbox validation.
  4. Publish into the workspace catalog, install and configure the plugin.
  5. Run a bounded real operation and compare it with a known result.

Publication does not prove access to your external system. A manifest is a contract, not an implementation; avoid promising modes, writes or lineage the code does not support.