Agent skill

Openloomi Install

by melandlabs in melandlabs/openloomi

OpenLoomi install & first-use setup helper for Codex. An agent skill from melandlabs/openloomi.

Apache-2.0Auto-check passed

Install Openloomi Install

skills CLI
$ npx skills add melandlabs/openloomi --skill openloomi-install -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install melandlabs/openloomi openloomi-install --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/melandlabs/openloomi.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/codex/skills/openloomi-install .claude/skills/openloomi-install && rm -rf skills-src

Use ~/.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/

Facts

Skill name
openloomi-install
GitHub stars
1k
Token cost
~1.3k tokens
SKILL.md length
611 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
Apache-2.0

At a glance

OpenLoomi install & first-use setup helper for Codex. An agent skill from melandlabs/openloomi.

  • Works in 3 steps: **Always run setup (and the loopback… → node… → Based on nextAction / reason
  • The user wants to install OpenLoomi
  • SKILL.md covers Quick workflow, Sandbox and installation, Codex runtime setup and Reminder: secrets contract
  • Calls node and codex

What it does

Openloomi Install is an agent skill from melandlabs/openloomi. OpenLoomi install & first-use setup helper for Codex. Use when the user wants to install OpenLoomi, configure it, or troubleshoot INSTALLREQUIRED / SOURCEFOUNDAPPNOTBUILT / SESSIONINITIALIZATIONREQUIRED after running setup-status. Triggers: install openloomi, configure openloomi, setup openloomi, openloomi not installed, openloomi not finalized, installrequired, install missing, guest session.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: OpenLoomi is an open-source AI coworker. It connects your work tools, understands what you’re working on, and tells you what needs your attention, why it matters, and what to do… The licence is Apache-2.0.

When your agent uses it

  • The user wants to install OpenLoomi
  • Troubleshoot INSTALLREQUIRED / SOURCEFOUNDAPPNOTBUILT / SESSIONINITIALIZATIONREQUIRED after running setup-status

Example prompts

  • “/openloomi-install”

Requirements

  • Pre-approved tools (allowed-tools): Bash(node $SKILL_DIR/../../scripts/loomi-bridge.mjs *)

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. **Always run setup (and the loopback checks below) outside the Codex
  2. node "$SKILL_DIR/../../scripts/loomi-bridge.mjs" setup-status
  3. Based on nextAction / reason

What it can do on your machine

Read from SKILL.md and the folder at commit 2aca101. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(node $SKILL_DIR/../../scripts/loomi-bridge.mjs *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node
    • codex

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Openloomi Install loads about 1.3k tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 611 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~107
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

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 melandlabs/openloomi at commit 2aca101, republished under its Apache-2.0 licence (© melandlabs). 611 words, ~1,276 tokens.

Download SKILL.mdSave it as .claude/skills/openloomi-install/SKILL.md (or your agent's skills folder).
name
openloomi-install
description
OpenLoomi install & first-use setup helper for Codex. Use when the user wants to install OpenLoomi, configure it, or troubleshoot `INSTALL_REQUIRED` / `SOURCE_FOUND_APP_NOT_BUILT` / `SESSION_INITIALIZATION_REQUIRED` after running setup-status. Triggers: install openloomi, configure openloomi, setup openloomi, openloomi not installed, openloomi not finalized, install_required, install missing, guest session.
allowed-tools
Bash(node $SKILL_DIR/../../scripts/loomi-bridge.mjs *)

OpenLoomi Install Sub-skill

This sub-skill is auto-loaded when the user wants to install or fix OpenLoomi on their machine. It composes loomi-bridge operations and never downloads or executes anything outside the plugin's own scripts.

Quick workflow

  1. Always run setup (and the loopback checks below) outside the Codex sandbox — the install + launch path needs writes to /Applications, desktop GUI launch, and http://localhost:3414. Default read-only / workspace-write modes will silently fail. Ask the user to drop sandbox=workspace-write (or move to danger-full-access) before invoking the bridge.
  2. node "$SKILL_DIR/../../scripts/loomi-bridge.mjs" setup-status
  3. Based on nextAction / reason:
Reason / nextActionAction
install_openloomi / INSTALL_REQUIREDOpenLoomi Desktop is not on this machine. Call setup --yes to run the end-to-end wizard in one invocation: resolve → download → install → set OPENLOOMI_AGENT_PROVIDER=codex → launch the desktop app → wait for the local API → mint a guest session token. Invoking this skill counts as explicit approval to pass --yes. For offline / corporate-proxy installs, point the user at the restricted-network guide (link below) and call install-instructions first.
SOURCE_FOUND_APP_NOT_BUILTA source checkout is present but the OpenLoomi Desktop GUI app has not been built yet. Recommend either building the source per the OpenLoomi repo's Tauri build docs (or run loomi-bridge install-instructions) or installing the packaged Desktop release.
open_openloomi / OPENLOOMI_API_UNREACHABLE / SESSION_INITIALIZATION_REQUIREDOpenLoomi is installed but the local API or guest/session token is not ready. Ask the user to open OpenLoomi Desktop once, or run setup so the bridge can launch/init through OpenLoomi-owned surfaces.
inspect_codex_runtimeOpenLoomi is up but the native Codex provider is not the active default agent. Have the user confirm the Codex CLI is installed (codex --version) and rerun setup so the runtime env + LaunchAgent get re-applied.

Before applying the API-unreachable row, inspect loopbackAccessAmbiguous. When it is true, the result is inconclusive because the current Codex sandbox may block host loopback traffic. Request approval and run loopbackAccess.verification.commands outside the sandbox. Only tell the user to restart OpenLoomi if the outside-sandbox checks also fail.

Show full SKILL.md (294 more words)Show less

Sandbox and installation

Downloading and installing OpenLoomi can require capabilities that are blocked inside the current Codex sandbox:

  • GitHub release lookup and artifact download require network access.
  • The default installer may write to a system application directory such as /Applications.
  • Interactive installers and launching OpenLoomi Desktop require GUI/process access outside the sandbox.

When an install command fails with a likely network, permission, filesystem, or GUI sandbox error, request approval and retry the same loomi-bridge command outside the sandbox. Do not work around the bridge by downloading or installing the artifact with unrelated commands. Do not report that the release URL is invalid or the installer is broken until the approved retry also fails.

Codex runtime setup

If the user is setting up OpenLoomi from Codex, explicitly asks to switch the desktop runtime executor to Codex, or diagnostics show a native-agent provider mismatch, call:

bash
node "$SKILL_DIR/../../scripts/loomi-bridge.mjs" codex-runtime-info

Reminder: secrets contract

  • The bridge never reads AI provider env vars and never reports provider readiness from /api/preferences/ai — it only checks whether the native Codex runtime is active via /api/native/providers. Provider configuration is the OpenLoomi runtime's job, surfaced through the desktop app's own settings UI.
  • If the user pastes a key into chat, redact it: do NOT echo it back, and tell them to remove it from chat history.
  • Never pass --api-key as an argv flag. The bridge has no such flag, by design.
  • The bridge's end-to-end wizard is setup --yes (one-shot: install + set codex provider + launch desktop + mint guest session token). Invoke it from this skill when the user asks to install or finalize OpenLoomi. Do not call install-openloomi --confirm by itself — that only installs and leaves the desktop app unlaunched and the session token unminted. Use install-openloomi --confirm only when the user explicitly asks to install without launching (rare).

© melandlabs, Apache-2.0. 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 plugins/codex/skills/openloomi-install of melandlabs/openloomi.

Open the folder on GitHubat commit 2aca101

Compare with similar skills

Openloomi Install 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.

Openloomi Install compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openloomi Install this skillmelandlabs/openloomi1k—~1.3kAutomated safety check: PassApache-2.0
Engine Test Helper GeneratorDonchitos/Claude-Code-Game-Studios26k—~4.4kAutomated safety check: PassMIT
Review Helpershashicorp/terraform-provider-aws11k—~978Automated safety check: PassMPL-2.0
Review Tests Helpershashicorp/terraform-provider-aws11k—~994Automated safety check: PassMPL-2.0
Qwen Code HelperQwenLM/qwen-code28k—~2.9kAutomated safety check: PassApache-2.0
Odoo Migration Helpersickn33/agentic-awesome-skills47k2 repos~1kAutomated safety check: PassMIT

Similar skills

  • Engine Test Helper Generator

    Donchitos/Claude-Code-Game-Studios

    Generates engine-specific test helper libraries with assertion utilities, factory functions and mocks, placed where the engine's test runner compiles them.

    26k GitHub stars~4.4k tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Review Helpers

    hashicorp/terraform-provider-aws

    Official

    Review Terraform AWS Provider helper code: finders, status functions, waiters, sweepers, data sources, and list resources.

    11k GitHub stars~978 tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Review Tests Helpers

    hashicorp/terraform-provider-aws

    Official

    Review Terraform AWS Provider test helpers: Exists/Destroy check functions, exportstest.go wiring, create.Error wrapping, data source tests, list resource tests (querycheck + Terraform version…

    11k GitHub stars~994 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Qwen Code Helper

    QwenLM/qwen-code

    Answers questions about Qwen Code usage, configuration and troubleshooting from its bundled docs, and can view or change your settings.json on request.

    28k GitHub stars~2.9k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Odoo Migration Helper

    sickn33/agentic-awesome-skills

    Step-by-step guide for migrating Odoo custom modules between versions (v14→v15→v16→v17).

    47k GitHub starsUsed in 2 repos~1k tokens
    Auto-check passed
  • Pagination Helper

    jeremylongshore/tons-of-skills-marketplace

    Configure with pagination helper operations. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~555 tokensUpdated yesterday
    Backend & APIsAuto-check passed

More from melandlabs/openloomi

All 23 skills in this repo
  • Openloomi Connectors

    melandlabs/openloomi

    openloomi Connectors tools - manage the native 7 messaging integrations and pair with the composio skill for the 1000+ apps OAuth layer (Slack, Discord, X, Gmail, Outlook, Google…

    1k GitHub stars~3.3k tokensUpdated 17 days ago
    Auto-check passed
  • Create Task

    melandlabs/openloomi

    Create an end-to-end Continual Learning Bench task. An agent skill from melandlabs/openloomi.

    1k GitHub stars~4.6k tokensUpdated 17 days ago
    Auto-check passed
  • Openloomi Memory

    melandlabs/openloomi

    openloomi Memory tools - search and manage the holistic context (people, projects, decisions, knowledge base, chat insights).

    1k GitHub stars~6k tokensUpdated 17 days ago
    Auto-check passed
  • Openloomi Setup

    melandlabs/openloomi

    OpenLoomi first-use setup and readiness guidance for skill-only agent runtimes.

    1k GitHub stars~420 tokensUpdated 17 days ago
    Auto-check passed
  • Find Skills

    melandlabs/openloomi

    Discover and install skills from the open agent skills ecosystem.

    1k GitHub stars~892 tokensUpdated 17 days ago
    Auto-check passed
  • Openloomi

    melandlabs/openloomi

    OpenLoomi runtime integration for Claude Code. An agent skill from melandlabs/openloomi.

    1k GitHub stars~1.4k tokensUpdated 17 days ago
    Auto-check passed

Questions about Openloomi Install

What does Openloomi Install do?

OpenLoomi install & first-use setup helper for Codex. An agent skill from melandlabs/openloomi. Openloomi Install is an agent skill from melandlabs/openloomi. OpenLoomi install & first-use setup helper for Codex.

When should I use Openloomi Install?

Openloomi Install fits situations like: the user wants to install OpenLoomi; troubleshoot INSTALLREQUIRED / SOURCEFOUNDAPPNOTBUILT / SESSIONINITIALIZATIONREQUIRED after running setup-status.

How do I install Openloomi Install in Claude Code?

Run `npx skills add melandlabs/openloomi --skill openloomi-install -a claude-code`. Or copy the skill folder (plugins/codex/skills/openloomi-install in melandlabs/openloomi) into .claude/skills/openloomi-install in your project. Claude Code loads it when a task matches its description.

How do I install Openloomi Install in Codex?

Run `npx skills add melandlabs/openloomi --skill openloomi-install -a codex`. Or copy the skill folder (plugins/codex/skills/openloomi-install in melandlabs/openloomi) into .agents/skills/openloomi-install in your project. Codex loads it when a task matches its description.

Can I use Openloomi Install 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 melandlabs/openloomi --skill openloomi-install -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openloomi-install, .gemini/skills/openloomi-install, .github/skills/openloomi-install and .opencode/skills/openloomi-install in your project.

What does Openloomi Install need to run?

Going by SKILL.md and its folder, Openloomi Install needs the command-line tools its instructions call (node and codex). Its frontmatter pre-approves these tools: Bash(node $SKILL_DIR/../../scripts/loomi-bridge.mjs *).

Does Openloomi Install access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Openloomi Install 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 Openloomi Install use?

Openloomi Install is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Openloomi Install use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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 Openloomi Install?

Skills that share tags, products or a category with Openloomi Install: Engine Test Helper Generator (Donchitos/Claude-Code-Game-Studios, 26k stars), Review Helpers (hashicorp/terraform-provider-aws, 11k stars), Review Tests Helpers (hashicorp/terraform-provider-aws, 11k stars) and Qwen Code Helper (QwenLM/qwen-code, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openloomi Install?

melandlabs (a GitHub organization) maintains it in melandlabs/openloomi, which has 1,038 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on September 24, 2026.

Source: melandlabs/openloomi on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.