Mermaid
peintune/runjam
Render Mermaid diagrams as SVG or ASCII art using beautiful-mermaid.
Push architecture docs to oh-my-mermaid cloud. An agent skill from oh-my-mermaid/oh-my-mermaid.
Install Omm Push
$ npx skills add oh-my-mermaid/oh-my-mermaid --skill omm-push -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install oh-my-mermaid/oh-my-mermaid omm-push --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/oh-my-mermaid/oh-my-mermaid.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/omm-push .claude/skills/omm-push && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "omm-push" agent skill from https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-push into .claude/skills/omm-push/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omm-push", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-pushType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add oh-my-mermaid/oh-my-mermaid --skill omm-push -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install oh-my-mermaid/oh-my-mermaid omm-push --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oh-my-mermaid/oh-my-mermaid.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/omm-push .agents/skills/omm-push && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "omm-push" agent skill from https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-push into .agents/skills/omm-push/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omm-push", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add oh-my-mermaid/oh-my-mermaid --skill omm-push -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install oh-my-mermaid/oh-my-mermaid omm-push --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oh-my-mermaid/oh-my-mermaid.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/omm-push .cursor/skills/omm-push && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "omm-push" agent skill from https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-push into .cursor/skills/omm-push/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omm-push", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/oh-my-mermaid/oh-my-mermaid.git --path skills/omm-push--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add oh-my-mermaid/oh-my-mermaid --skill omm-push -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install oh-my-mermaid/oh-my-mermaid omm-push --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oh-my-mermaid/oh-my-mermaid.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/omm-push .gemini/skills/omm-push && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "omm-push" agent skill from https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-push into .gemini/skills/omm-push/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omm-push", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install oh-my-mermaid/oh-my-mermaid omm-pushInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add oh-my-mermaid/oh-my-mermaid --skill omm-push -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/oh-my-mermaid/oh-my-mermaid.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/omm-push .github/skills/omm-push && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "omm-push" agent skill from https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-push into .github/skills/omm-push/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omm-push", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add oh-my-mermaid/oh-my-mermaid --skill omm-push -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install oh-my-mermaid/oh-my-mermaid omm-push --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/oh-my-mermaid/oh-my-mermaid.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/omm-push .opencode/skills/omm-push && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "omm-push" agent skill from https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-push into .opencode/skills/omm-push/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "omm-push", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
omm-push- GitHub stars
- 2.7k
- Token cost
- ~441 tokens
- SKILL.md length
- 220 words
- Files
- 1
- Skills in repo
- 3
- Repo updated
- First seen
- Licence
- MIT
At a glance
Push architecture docs to oh-my-mermaid cloud. An agent skill from oh-my-mermaid/oh-my-mermaid.
- Works in 4 steps: Check Login Status → Check Project Link → Push → …
- The user says omm push
- SKILL.md covers Purpose, Prerequisites, Workflow and Rules
- Calls npm; reaches ohmymermaid.com
What it does
Omm Push is an agent skill from oh-my-mermaid/oh-my-mermaid. 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".
Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Diagrams. It works with Mermaid and Bash. The repository describes itself as: Turn complex codebases into clear, navigable architecture diagrams with Claude Code. The licence is MIT.
When your agent uses it
- The user says omm push
- Deploy architecture
- Share architecture
Example prompts
- “omm push”
- “push to cloud”
- “deploy architecture”
- “/omm-push”
Requirements
- Node.js
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 38ccdb6. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
ohmymermaid.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Omm Push loads about 441 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 220 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from oh-my-mermaid/oh-my-mermaid at commit 38ccdb6, republished under its MIT licence (© oh-my-mermaid). 220 words, ~441 tokens.
Download SKILL.mdSave it as
.claude/skills/omm-push/SKILL.md (or your agent's skills folder).- name
- omm-push
- description
- 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".
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:
command -v omm || npm install -g oh-my-mermaidIf 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 loginagain." - 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 shareto 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
© oh-my-mermaid, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/omm-push of oh-my-mermaid/oh-my-mermaid.
Open the folder on GitHubat commit 38ccdb6
Compare with similar skills
Omm Push next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Omm Push this skilloh-my-mermaid/oh-my-mermaid | 2.7k | — | ~441 | Automated safety check: Pass | MIT | |
| Mermaidpeintune/runjam | 228 | 1 repos | ~729 | Automated safety check: Pass | MIT | |
| Archify Diagramstt-a1i/archify | 82k | — | ~2.9k | Automated safety check: Pass | MIT | |
| Diagram Designcathrynlavery/diagram-design | 49k | 1 repos | ~7.6k | Automated safety check: Pass | MIT | |
| Draw.io Diagram StudioAgents365-ai/drawio-skill | 10k | — | ~2.4k | Automated safety check: Notes | MIT | |
| Pretty Mermaid Rendererimxv/Pretty-mermaid-skills | 1.5k | — | ~2k | Automated safety check: Pass | MIT |
Similar skills
Archify Diagrams
tt-a1i/archify
Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.
Diagram Design
cathrynlavery/diagram-design
Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.
Draw.io Diagram Studio
Agents365-ai/drawio-skill
Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.
Pretty Mermaid Renderer
imxv/Pretty-mermaid-skills
Writes and renders Mermaid diagrams as themed SVG, PNG or terminal ASCII and Unicode art with a bundled Node.js CLI that needs no browser.
Archify Diagram Builder
Unclecheng-li/AI_Animation
Builds validated architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone interactive HTML from a small JSON spec, with optional motion and image export.
More from oh-my-mermaid/oh-my-mermaid
Related
Categories
Questions about Omm Push
What does Omm Push do?
Push architecture docs to oh-my-mermaid cloud. An agent skill from oh-my-mermaid/oh-my-mermaid. Omm Push is an agent skill from oh-my-mermaid/oh-my-mermaid. Push architecture docs to oh-my-mermaid cloud.
When should I use Omm Push?
Omm Push fits situations like: the user says omm push; deploy architecture; share architecture.
How do I install Omm Push in Claude Code?
Run `npx skills add oh-my-mermaid/oh-my-mermaid --skill omm-push -a claude-code`. Or copy the skill folder (skills/omm-push in oh-my-mermaid/oh-my-mermaid) into .claude/skills/omm-push in your project. Claude Code loads it when a task matches its description.
How do I install Omm Push in Codex?
Run `npx skills add oh-my-mermaid/oh-my-mermaid --skill omm-push -a codex`. Or copy the skill folder (skills/omm-push in oh-my-mermaid/oh-my-mermaid) into .agents/skills/omm-push in your project. Codex loads it when a task matches its description.
Can I use Omm Push in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oh-my-mermaid/oh-my-mermaid --skill omm-push -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/omm-push, .gemini/skills/omm-push, .github/skills/omm-push and .opencode/skills/omm-push in your project.
What does Omm Push need to run?
Going by SKILL.md and its folder, Omm Push needs the command-line tools its instructions call (npm). Our summary lists: Node.js.
Does Omm Push access the network?
SKILL.md names 1 domain. In commands or code: ohmymermaid.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Is Omm Push safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Omm Push use?
Omm Push is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Omm Push use?
About 441 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Omm Push?
Skills that share tags, products or a category with Omm Push: Mermaid (peintune/runjam, 228 stars), Archify Diagrams (tt-a1i/archify, 82k stars), Diagram Design (cathrynlavery/diagram-design, 49k stars) and Draw.io Diagram Studio (Agents365-ai/drawio-skill, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Omm Push?
oh-my-mermaid (a GitHub organization) maintains it in oh-my-mermaid/oh-my-mermaid, which has 2,701 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on April 7, 2026.
Source: oh-my-mermaid/oh-my-mermaid on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.