Skip to main content
Publishing with aireg, the AI registry CLI, sends a local skill folder to an Atlan workspace in one command, with a dry run to preview what changes. Use it from a terminal when you publish skills yourself. To publish on every merge instead, see Sync skills from GitHub.

Before you begin

Before you start, make sure you have:
  • aireg with the Atlan adapter: Installed, signed in, and your Atlan registry declared under a name. See Use aireg with Atlan. The examples call that registry atlan; use the name you chose.
  • Skill folder: A folder with SKILL.md at its root. To prepare one, see Prepare skill bundle.
  • Workspace: The name of a workspace you can publish to, as aireg registry show atlan lists it.
1

Preview publish

Run a dry run to see whether aireg would add, update, or skip the skill:
Use the workspace name. An ID also publishes to the right workspace, but aireg then lists every skill as add. If no workspace you can reach has that name or ID, aireg refuses the publish.
2

Publish skill

When the dry run is correct, publish:
aireg publish also takes several folders or a glob, and can limit a publish to skills that changed since a commit. For every option and exit status, see aireg publish in the aireg CLI reference.
3

Verify publication

aireg prints what it published, but it does not wait for or report the security scan. Atlan Trident serves a new version only after its scan and any review pass.
  • Check the registry: List what your Atlan registry serves, with each skill tagged by workspace, then show the skill:
  • Check the scan: Open the skill in Atlan Trident and confirm the new version is served. Its Source tab shows the version history, which aireg cannot list yet. See Versions.
If the scan already blocked the same files, aireg says Atlan holds <name>, but its security scan blocked it, so Atlan does not serve it. See Publish held or blocked.

Troubleshooting

For sign-in failures, connection problems, and held or blocked publishes, see Atlan errors in aireg.

Next steps

See also