Publish a skill or agent to a registry, or release a new version of one. Use when asked to publish, share, contribute or release a skill or agent, update one that is already in a registry, publish a project's skills from CI, or fix what registry validation reports.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Publish to a registry
A released version is never edited: every change is a new version. Pass `--json` to the CLI
and read `data`.
Pick the path by where the user is working:
- **Outside the registry's repository**, with a skill in some folder: contribute it.
- **A project whose skills should reach a registry on every change**: publish from CI.
- **Inside the registry's repository**: add or version it there, then release.
## Contribute from any folder
`aireg status --json` lists, in `data.unmanaged`, the skills in this project's harness
folders that aireg does not manage; `aireg status -g --json` lists the user's own. Read one
before publishing it:
```sh
aireg show ./<path> --json
```
A skill is a folder holding `SKILL.md`; an agent is one `.md` file. aireg doesn't publish to
a git registry: it writes the new version into a clone, and git carries it from there. For a
registry in a git repository, the usual case:
```sh
git clone <repository> ../<clone> # a clone already there: switch to its default branch and pull
ls ../<clone>/artifacts # the namespaces in use; a new registry has none yet
git -C ../<clone> switch -c publish-<name>
…
The line at the top of this page pins the label git:20261009.49133b2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_cdciw2vobxh3rfeu
GET https://markdownregistry.com/api/v1/resolve?ref=atlanai/ai-registry/publish
GET https://markdownregistry.com/api/v1/blob/dec181687c4eef429900d29eb209bba476e6b4d0c7e45559f621e90cd1b1ac6d
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
atlanai/ai-registry · examples/acme-registry/artifacts/engineering/skill/pr-review/1.1.0/SKILL.md · Review a pull request for correctness, clarity, and test coverage, and leave findings ranked by severity.
atlanai/ai-registry · examples/acme-registry/artifacts/engineering/skill/pr-review/1.2.0/SKILL.md · Review a pull request for correctness, clarity, and test coverage, and leave findings ranked by severity. Uses a…
atlanai/ai-registry · examples/aireg/artifacts/aireg/skill/add/0.1.0/SKILL.md · Find, read, install and update skills and agents from a registry, in this project or for the user. Use when asked to…
atlanai/ai-registry · examples/aireg/artifacts/aireg/skill/aireg-add/0.1.0/SKILL.md · Find, read, install and update skills and agents from a registry, in this project or for the user. Use when asked to…
atlanai/ai-registry · examples/aireg/artifacts/aireg/skill/aireg-add/0.1.1/SKILL.md · Answer what is installed and keep it right. List the skills and agents in this project or for the user, say where each…
atlanai/ai-registry · examples/aireg/artifacts/aireg/skill/aireg-add/0.1.2/SKILL.md · Answer what is installed and keep it right. List the skills and agents in this project or for the user, say where each…
atlanai/ai-registry · examples/aireg/artifacts/aireg/skill/aireg-add/0.1.3/SKILL.md · Connect a registry and install, inspect, update or remove its skills and agents in a project or user scope. Use when…
atlanai/ai-registry · examples/aireg/artifacts/aireg/skill/aireg-new/0.1.0/SKILL.md · Set up a registry of skills and agents for a person or a team, from nothing to installed. Use when asked to create…
atlanai/ai-registry · examples/aireg/artifacts/aireg/skill/aireg-new/0.2.0/SKILL.md · Set up a registry of skills and agents for a person or a team, from nothing to installed. Use when asked to create…
atlanai/ai-registry · examples/aireg/artifacts/aireg/skill/aireg-new/0.2.1/SKILL.md · Set up a registry of skills and agents for a person or a team, from nothing to installed. Use when asked to create…
code-yeongyu/oh-my-openagent · .agents/skills/publish/SKILL.md · Publish oh-my-opencode to npm by triggering the GitHub Actions publish workflow and verifying its artifacts. Ship-only…
agenttoolkit/altk-evolve · platform-integrations/codex/plugins/evolve-lite/skills/evolve-lite/publish/SKILL.md · Publish a private entity (guideline, feedback, project or reference) to a configured write-scope repo.
agenttoolkit/altk-evolve · platform-integrations/claw-code/plugins/evolve-lite/skills/evolve-lite/publish/SKILL.md · Publish a private entity (guideline, feedback, project or reference) to a configured write-scope repo.
agenttoolkit/altk-evolve · platform-integrations/claude/plugins/evolve-lite/skills/evolve-lite/publish/SKILL.md · Publish a private entity (guideline, feedback, project or reference) to a configured write-scope repo.
kochetkov-ma/claude-brewcode · brewdoc/skills/publish/SKILL.md · Publishes text, Markdown, JSON, a file, a folder or a ZIP site to brewpage.app and returns a shareable URL. Use when…
blitzdotdev/kite3d · packages/kite3d/skills/publish/SKILL.md · Publish a saved Kite3D project to blitz.dev by assembling and uploading a release with the backend API.
