Agent skill

Homerail Shared

by xiaotianfotos in xiaotianfotos/homerail

Install Homerail Shared

skills CLI

$ npx skills add xiaotianfotos/homerail --skill homerail-shared -a claude-code

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

GitHub CLI

$ gh skill install xiaotianfotos/homerail homerail-shared --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/xiaotianfotos/homerail.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/homerail-shared .claude/skills/homerail-shared && 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/

Paste into Claude Code

Install the "homerail-shared" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/skills/homerail-shared into .claude/skills/homerail-shared/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "homerail-shared", 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

$skill-installer install https://github.com/xiaotianfotos/homerail/tree/main/skills/homerail-shared

Type 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.

skills CLI

$ npx skills add xiaotianfotos/homerail --skill homerail-shared -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install xiaotianfotos/homerail homerail-shared --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/xiaotianfotos/homerail.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/homerail-shared .agents/skills/homerail-shared && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "homerail-shared" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/skills/homerail-shared into .agents/skills/homerail-shared/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "homerail-shared", 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.

skills CLI

$ npx skills add xiaotianfotos/homerail --skill homerail-shared -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install xiaotianfotos/homerail homerail-shared --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/xiaotianfotos/homerail.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/homerail-shared .cursor/skills/homerail-shared && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "homerail-shared" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/skills/homerail-shared into .cursor/skills/homerail-shared/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "homerail-shared", 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

$ gemini skills install https://github.com/xiaotianfotos/homerail.git --path skills/homerail-shared

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add xiaotianfotos/homerail --skill homerail-shared -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install xiaotianfotos/homerail homerail-shared --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/xiaotianfotos/homerail.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/homerail-shared .gemini/skills/homerail-shared && rm -rf skills-src

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

Paste into Gemini CLI

Install the "homerail-shared" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/skills/homerail-shared into .gemini/skills/homerail-shared/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "homerail-shared", 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.

GitHub CLI

$ gh skill install xiaotianfotos/homerail homerail-shared

Installs 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).

skills CLI

$ npx skills add xiaotianfotos/homerail --skill homerail-shared -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/xiaotianfotos/homerail.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/homerail-shared .github/skills/homerail-shared && rm -rf skills-src

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

Paste into GitHub Copilot

Install the "homerail-shared" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/skills/homerail-shared into .github/skills/homerail-shared/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "homerail-shared", 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.

skills CLI

$ npx skills add xiaotianfotos/homerail --skill homerail-shared -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install xiaotianfotos/homerail homerail-shared --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/xiaotianfotos/homerail.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/homerail-shared .opencode/skills/homerail-shared && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "homerail-shared" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/skills/homerail-shared into .opencode/skills/homerail-shared/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "homerail-shared", 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: homerail-shared
GitHub stars: 994
Token cost: ~1.5k tokens
SKILL.md length: 727 words
Files: 2
Skills in repo: 11
Repo updated: Sep 25, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Troubleshooting
SKILL.md covers Core Rules, Provider Boundaries, Local Source Layout and Anti-Patterns (Don'ts), plus 1 more section
Calls npm
Running HomeRail through other HomeRail skills

What it does

Homerail Shared is an agent skill from xiaotianfotos/homerail. Shared HomeRail rules for AI agents operating the local-source release candidate: service roles, environment variables, secrets, provider boundaries, Docker callback networking, update expectations, and safe command behavior. Use whenever installing, configuring, upgrading, troubleshooting, or running HomeRail through other HomeRail skills.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in DevOps & Cloud, covering Containers and Secrets management. It works with Docker. The repository describes itself as: Voice-first local agent orchestration runtime for auditable DAG workflows. The licence is MIT.

When your agent uses it

Troubleshooting
Running HomeRail through other HomeRail skills

Example prompts

“/homerail-shared”

Requirements

Docker

What it can do on your machine

Read from SKILL.md and the folder at commit 916e343. 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
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
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

Homerail Shared loads about 1.5k tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 727 words of instructions outside code blocks.

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

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 xiaotianfotos/homerail at commit 916e343, republished under its MIT licence (© xiaotianfotos). 727 words, ~1,507 tokens.

Download SKILL.mdSave it as .claude/skills/homerail-shared/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: homerail-shared
description: Shared HomeRail rules for AI agents operating the local-source release candidate: service roles, environment variables, secrets, provider boundaries, Docker callback networking, update expectations, and safe command behavior. Use whenever installing, configuring, upgrading, troubleshooting, or running HomeRail through other HomeRail skills.

HomeRail Shared

Core Rules

Use these rules with all HomeRail skills.

Treat this release as a local-source install. Do not assume npm packages or public GitHub URLs exist yet.
Prefer placeholders such as <local-homerail-repo> and /path/to/HomeRail in user-facing instructions.
Keep provider and integration secrets in the Manager encrypted secret store through CLI/UI configuration; never write API keys, tokens, or passwords into repo files, skill files, DAG templates, commits, or issue text.
Use one shared HOMERAIL_HOME for Manager and Node. Default is $HOME/.homerail.
Prefer hr config for local runtime settings and hr start to start Manager and Node together.
Manager and Node run as local services. Manager is not expected to run inside the Worker Docker image.
Node provisions Worker containers. Workers for one run should share ${HOMERAIL_HOME}/workspace/<run_id>.

Local service ports (use this table and the CLI before falling back to low-level process probes):

Port	Role	Default URL	Notes
19191	Manager (HTTP + WS, what DAGs and the CLI talk to)	`http://localhost:19191`	This is the only port a DAG run / CLI hits. Bind via `HOMERAIL_MANAGER_HOST` / `manager.host` / `hr start --host`; public access via `HOMERAIL_MANAGER_PUBLIC_URL` / `hr start --public-url`.
19192	Agent UI (HTTPS, browser)	`https://localhost:19192`	Browser-only. Do NOT send DAG/CLI traffic here. Config via `HOMERAIL_UI_HOST` / `HOMERAIL_UI_PORT` / `ui.host` / `ui.port`.
19193	Agent UI HTTP fallback	`http://localhost:19193`	Fallback when HTTPS port is taken. Config via `HOMERAIL_UI_HTTP_PORT` / `ui.httpPort`.

The Manager port is 19191, not 19192. 19192 is the Agent UI. Mixing these up is the most common startup mistake.

For hr start --ui --public without explicit public URLs, Agent UI should bind and advertise the detected machine IP with HTTPS, and the browser should use same-origin Manager API/WS proxying for the HTTPS UI. Use HOMERAIL_PUBLIC_HOST only when automatic machine IP detection picks the wrong interface.
For reverse-proxied public access, prefer explicit HTTPS/WSS public URLs through HOMERAIL_MANAGER_PUBLIC_URL / HOMERAIL_UI_PUBLIC_URL or --public-url / --ui-public-url.
Do not hardcode Docker bridge addresses. Use Docker host.docker.internal / host-gateway support or explicit operator-provided callback settings.

Provider Boundaries

For Coding Plan / Agent Plan accounts:

Never use direct-llm or Chat Completions as the worker runtime path.
Kimi plans should use the Kimi Code CLI harness (kimi_code / kimi-code).
Other provider plans should use the Claude Code compatible harness (claude-sdk) with an Anthropic-compatible endpoint.
If a plan does not expose an Anthropic-compatible endpoint, fail explicitly instead of falling back to the Chat Completions URL.

For MiMo:

DAG worker LLM access uses the MiMo token-plan Anthropic-compatible endpoint.
MiMo ASR/API-billing endpoints are a separate voice path and must not be mixed into DAG worker model configuration.
If a user provides a provider key, configure it with hr model configure --api-key-stdin or the interactive CLI/UI flow so Manager stores it encrypted. Plaintext env files are legacy import fallbacks only.

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

Local Source Layout

Expected source checkout:

text

<local-homerail-repo>/
  homerail_manager/
  homerail_node/
  homerail_worker/
  homerail_protocol/
  homerail_cli/
  agent-ui/
  assets/
  skills/

Use homerail_cli for the TypeScript CLI. Do not refer to the old homerail_cli_ts name.

Anti-Patterns (Don'ts)

These cause wasted investigation rounds during normal operation. The CLI already exposes everything below.

Do not start service diagnosis with raw process probes or source spelunking. Run hr doctor (readiness) and hr runtime status (live state) first; they report manager/node/worker/model state. Use ps, lsof, direct curl, logs, or source reading only after the CLI output is insufficient or the user explicitly asks for low-level debugging.
Do not start a fixed host Worker process. DAG Workers are provisioned on demand by a Node into Docker containers; there is no standing worker to launch. Starting a bare homerail_worker node process manually will not register correctly and bypasses the isolated-workspace contract every DAG depends on.
Do not hand-craft WebSocket URLs or reverse-engineer the worker connection protocol. hr start handles Manager↔Node↔Worker wiring. If a Worker cannot reach the Manager, set the Manager worker-WS callback host (see homerail-install-ops troubleshooting), do not hardcode Docker bridge IPs.
Do not rebuild packages before every DAG run. install:all / build / typecheck / test are only needed after changing source or on first install. A ready runtime runs DAGs directly via hr run.
Do not read dag_runs/dag_handoffs tables via sqlite3 to get run output. Use hr dag handoffs <run_id> (with --content-limit 0 for untruncated content). The CLI is the supported read path.
Do not treat an idle or running snapshot as success. Terminal status (completed/failed/cancelled) plus non-empty handoffs is the only success signal.

Validation Ladder

When validating a local install or change, prefer this order:

bash

npm run install:all
npm run build
npm run typecheck
npm test
npm run ci

For end-to-end readiness, also run hr config, hr start, hr doctor, and one public smoke DAG through homerail-install-ops.

Files

SKILL.md and 1 other file in skills/homerail-shared of xiaotianfotos/homerail.

SKILL.md
agents/openai.yaml

Open the folder on GitHubat commit 916e343

Compare with similar skills

Homerail Shared 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.

Homerail Shared compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Homerail Shared this skillxiaotianfotos/homerail	994	—	~1.5k	Automated safety check: Pass	MIT	15 days ago
Iron Proxy Gateway for NanoClawnanocoai/nanoclaw	31k	—	~4.6k	Automated safety check: Notes	MIT	today
LangBot Deployment Guidelangbot-app/LangBot	18k	—	~1.5k	Automated safety check: Notes	Apache-2.0	today
Add Config Env Varbaserow/baserow	6.1k	—	~1.1k	Automated safety check: Pass	Custom licence	yesterday
Monstermq Broker Configvogler75/monster-mq	143	—	~2.2k	Automated safety check: Pass	GPL-3.0	today
Deploymentmatrixorigin/memoria	610	—	~1.6k	Automated safety check: Notes	Apache-2.0	yesterday

Similar skills

Iron Proxy Gateway for NanoClaw
nanocoai/nanoclaw
Installs or refreshes Iron Proxy and its Iron Control web console for NanoClaw, with a local Docker setup, database, credentials and a human approval bridge.
31k GitHub stars~4.6k tokensUpdated today
DevOps & CloudAuto-check: notes
LangBot Deployment Guide
langbot-app/LangBot
Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.
18k GitHub stars~1.5k tokensUpdated today
DevOps & CloudAuto-check: notes
Add Config Env Var
baserow/baserow
Add a Baserow configuration environment variable for the backend, frontend, or both, and propagate it through settings, Nuxt runtime config, Docker Compose, documentation, consumers, and tests as…
6.1k GitHub stars~1.1k tokensUpdated yesterday
DevOps & CloudAuto-check passed
Monstermq Broker Config
vogler75/monster-mq
Guide for configuring, deploying, and operating the MonsterMQ broker.
143 GitHub stars~2.2k tokensUpdated today
DevOps & CloudAuto-check passed
Deployment
matrixorigin/memoria
Deploy Memoria with Docker Compose or Kubernetes. An agent skill from matrixorigin/memoria.
610 GitHub stars~1.6k tokensUpdated yesterday
DevOps & CloudAuto-check: notes
Docker Compose Development Patterns
affaan-m/ECC
Practical Docker and Docker Compose patterns for local development: stacks, override files, networking, volumes, container hardening and debugging.
277k GitHub starsUsed in 4 repos~2.1k tokens
DevOps & CloudAuto-check: notes

Questions about Homerail Shared

What does Homerail Shared do?

Shared HomeRail rules for AI agents operating the local-source release candidate: service roles, environment variables, secrets, provider boundaries, Docker callback networking, update expectations…. Homerail Shared is an agent skill from xiaotianfotos/homerail. Shared HomeRail rules for AI agents operating the local-source release candidate: service roles, environment variables, secrets, provider boundaries, Docker callback networking, update expectations, and safe command behavior.

When should I use Homerail Shared?

Homerail Shared fits situations like: troubleshooting; running HomeRail through other HomeRail skills.

How do I install Homerail Shared in Claude Code?

Run `npx skills add xiaotianfotos/homerail --skill homerail-shared -a claude-code`. Or copy the skill folder (skills/homerail-shared in xiaotianfotos/homerail) into .claude/skills/homerail-shared in your project. Claude Code loads it when a task matches its description.

How do I install Homerail Shared in Codex?

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

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

What does Homerail Shared need to run?

Going by SKILL.md and its folder, Homerail Shared needs the command-line tools its instructions call (npm). Our summary lists: Docker.

Does Homerail Shared access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Homerail Shared 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 Homerail Shared use?

Homerail Shared 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 Homerail Shared use?

About 1.5k tokens (SKILL.md is roughly 6k 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 Homerail Shared?

Skills that share tags, products or a category with Homerail Shared: Iron Proxy Gateway for NanoClaw (nanocoai/nanoclaw, 31k stars), LangBot Deployment Guide (langbot-app/LangBot, 18k stars), Add Config Env Var (baserow/baserow, 6.1k stars) and Monstermq Broker Config (vogler75/monster-mq, 143 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Homerail Shared?

xiaotianfotos (a GitHub user) maintains it in xiaotianfotos/homerail, which has 994 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 25, 2026.

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

Homerail Shared

Install Homerail Shared

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

HomeRail Shared

Core Rules

Provider Boundaries

Local Source Layout

Anti-Patterns (Don'ts)

Validation Ladder

Files

Compare with similar skills

Similar skills

Iron Proxy Gateway for NanoClaw

LangBot Deployment Guide

Add Config Env Var

Monstermq Broker Config

Deployment

Docker Compose Development Patterns

More from xiaotianfotos/homerail

Homerail Dag Ops

Voice Generative UI

Homerail CLI

Homerail Install Ops

Homerail PR Review

Dag Best Practices

Questions about Homerail Shared

Install Homerail Shared

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

HomeRail Shared

Core Rules

Provider Boundaries

Local Source Layout

Anti-Patterns (Don'ts)

Validation Ladder

Files

Compare with similar skills

Similar skills

More from xiaotianfotos/homerail

Related

Questions about Homerail Shared