omm-push

Original：🇺🇸 English

Translated

Push architecture docs to oh-my-mermaid cloud. Handles login, link, and push workflow with error guidance. Use when the user says "omm push", "push to cloud", "deploy architecture", or "share architecture".

1installs

Sourceoh-my-mermaid/oh-my-mermaid

Added on2026-05-16

NPX Install

npx skill4agent add oh-my-mermaid/oh-my-mermaid omm-push

SKILL.md Content

View Translation Comparison →

omm-push — Cloud Push Workflow

Purpose

Automate the full workflow of pushing .omm/ architecture docs to the oh-my-mermaid cloud service.

Prerequisites

Ensure the

omm

CLI is available:

bash

command -v omm || npm install -g oh-my-mermaid

If the install command fails (permission denied), tell the user: "Please run

npm install -g oh-my-mermaid

in your terminal, then try again."

Workflow

Step 1: Check Login Status

Run

omm share

via Bash. If it errors with "not logged in":

Tell the user: "You need to log in first."
Run
```
omm login
```
— this opens a browser for GitHub OAuth
Wait for the user to complete login

Step 2: Check Project Link

Run

omm share

via Bash. If it errors with "no project slug":

Run
```
omm link
```
— this sets the cloud project slug from the directory name
Confirm: "Linked to {slug}"

Step 3: Push

Run

omm push

via Bash.

Handle errors:

401 Unauthorized: "Login expired. Run
```
omm login
```
again."
403 Free plan limit: "Free plan allows 1 project. Upgrade at https://ohmymermaid.com/pricing"
Network error: "Cannot reach server. Check your connection."

Step 4: Report

On success, output:

Number of files uploaded
View URL:
```
https://ohmymermaid.com/p/{slug}
```
Share URL (if Pro): "Run
```
omm share
```
to get the shareable link"

Rules

Always check login before pushing
Always check link before pushing
Do NOT skip steps — each depends on the previous
If any step fails, stop and report the error with guidance