Orca CLI
stablyai/orca
Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…
HomeRail DAG review and execution best practices. An agent skill from xiaotianfotos/homerail.
Install Dag Best Practices
$ npx skills add xiaotianfotos/homerail --skill dag-best-practices -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install xiaotianfotos/homerail dag-best-practices --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/xiaotianfotos/homerail.git skills-src && mkdir -p .claude/skills && cp -r skills-src/assets/orchestrations/dag-best-practices .claude/skills/dag-best-practices && 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 "dag-best-practices" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/assets/orchestrations/dag-best-practices into .claude/skills/dag-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dag-best-practices", 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/xiaotianfotos/homerail/tree/main/assets/orchestrations/dag-best-practicesType 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 xiaotianfotos/homerail --skill dag-best-practices -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install xiaotianfotos/homerail dag-best-practices --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/xiaotianfotos/homerail.git skills-src && mkdir -p .agents/skills && cp -r skills-src/assets/orchestrations/dag-best-practices .agents/skills/dag-best-practices && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "dag-best-practices" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/assets/orchestrations/dag-best-practices into .agents/skills/dag-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dag-best-practices", 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 xiaotianfotos/homerail --skill dag-best-practices -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install xiaotianfotos/homerail dag-best-practices --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/xiaotianfotos/homerail.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/assets/orchestrations/dag-best-practices .cursor/skills/dag-best-practices && 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 "dag-best-practices" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/assets/orchestrations/dag-best-practices into .cursor/skills/dag-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dag-best-practices", 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/xiaotianfotos/homerail.git --path assets/orchestrations/dag-best-practices--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 xiaotianfotos/homerail --skill dag-best-practices -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install xiaotianfotos/homerail dag-best-practices --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/xiaotianfotos/homerail.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/assets/orchestrations/dag-best-practices .gemini/skills/dag-best-practices && 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 "dag-best-practices" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/assets/orchestrations/dag-best-practices into .gemini/skills/dag-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dag-best-practices", 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 xiaotianfotos/homerail dag-best-practicesInstalls 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 xiaotianfotos/homerail --skill dag-best-practices -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/xiaotianfotos/homerail.git skills-src && mkdir -p .github/skills && cp -r skills-src/assets/orchestrations/dag-best-practices .github/skills/dag-best-practices && 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 "dag-best-practices" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/assets/orchestrations/dag-best-practices into .github/skills/dag-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dag-best-practices", 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 xiaotianfotos/homerail --skill dag-best-practices -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install xiaotianfotos/homerail dag-best-practices --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/xiaotianfotos/homerail.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/assets/orchestrations/dag-best-practices .opencode/skills/dag-best-practices && 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 "dag-best-practices" agent skill from https://github.com/xiaotianfotos/homerail/tree/main/assets/orchestrations/dag-best-practices into .opencode/skills/dag-best-practices/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dag-best-practices", 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
dag-best-practices- GitHub stars
- 994
- Token cost
- ~419 tokens
- SKILL.md length
- 90 words
- Files
- 1
- Skills in repo
- 11
- Repo updated
- First seen
- Licence
- MIT
At a glance
HomeRail DAG review and execution best practices. An agent skill from xiaotianfotos/homerail.
- Reviewing HomeRail fan-out/fan-in DAGs
- SKILL.md covers DO, DO NOT and 快速检查
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Especially model-backed DAG audits
What it does
Dag Best Practices is an agent skill from xiaotianfotos/homerail. HomeRail DAG review and execution best practices. Use when designing, running, or reviewing HomeRail fan-out/fan-in DAGs, especially model-backed DAG audits, environment checks, and agent handoff evidence.
Its SKILL.md is about 420 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 Agent Workflows, covering Multi-agent orchestration. The repository describes itself as: Voice-first local agent orchestration runtime for auditable DAG workflows. The licence is MIT.
When your agent uses it
- Reviewing HomeRail fan-out/fan-in DAGs
- Especially model-backed DAG audits
- Environment checks
- Agent handoff evidence
Example prompts
- “/dag-best-practices”
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
No scripts in the folder and no shell commands in SKILL.md.
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
Dag Best Practices loads about 419 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 90 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 xiaotianfotos/homerail at commit 916e343, republished under its MIT licence (© xiaotianfotos). 90 words, ~419 tokens.
Download SKILL.mdSave it as
.claude/skills/dag-best-practices/SKILL.md (or your agent's skills folder).- name
- dag-best-practices
- description
- HomeRail DAG review and execution best practices. Use when designing, running, or reviewing HomeRail fan-out/fan-in DAGs, especially model-backed DAG audits, environment checks, and agent handoff evidence.
HomeRail DAG 最佳实践
一句话原则：先统一事实，再分头检查，最后只按证据下结论。
DO
- 先建立唯一事实源。用 seed 节点拿到代码、版本、输入参数和外部证据，再把同一份事实交给所有下游节点。
- 让每个节点只回答一个清晰问题，例如源码是否干净、构建是否通过、运行时是否健康、数据是否保留。
- 让节点真的检查事实。该跑命令就跑命令，该读文件就读文件，该查 API 就查 API，不要只复述提示词。
- 让节点输出结构化 handoff。至少包含结论、证据、缺口、阻塞原因；失败时给出可行动的修复方向。
- 让 fan-in 节点只做裁决。它可以汇总和判断，但不应该重新做所有检查，也不应该替上游补证据。
- 把 hard gate 和 advisory 分开。必须通过的检查失败就阻塞；参考意见只能提示风险，不能替代证据。
- 把运行环境差异当成默认存在。宿主机、容器、本地、远端、CI 看到的路径、网络、权限、工具链可能都不同。
- 把会改变运行时的动作放在 DAG 外或明确隔离。部署、迁移、重启服务这类动作不要破坏正在执行 DAG 的基础设施。
- 给长期状态留 baseline。涉及升级、迁移、用户数据、配置和历史记录时，先记录基准，再用后续运行对比。
- 留下可复查的证据。每次运行都应该能回答：看了什么、跑了什么、结果是什么、为什么通过或阻塞。
- 用小 smoke 验证流程，用真实任务验证能力。快速 smoke 证明线路能通，真实模型和真实命令才证明任务完成质量。
- 使用执行环境真的能访问的地址、路径和凭证。给容器节点的输入，要从容器视角验证可用。
DO NOT
- 不要让节点各自使用不同事实源。版本不一致时，后面的汇总没有意义。
- 不要把模糊自然语言当成节点间协议。节点间传递要用结构化字段，不要靠读聊天猜含义。
- 不要让一个节点承担太多职责。职责越混，失败原因越难定位。
- 不要把没输出结果的节点算作成功。没有 handoff 就是缺证据。
- 不要自动补 handoff 后继续判通过。自动补只能说明节点没有按契约完成。
- 不要让 fan-in 节点靠感觉补全缺失信息。缺少证据就阻塞，而不是猜测通过。
- 不要把参考意见当成硬结论。LLM review、人工建议、摘要和 smoke 都不能替代 hard gate 的实际证据。
- 不要把快速跑通说成完整完成。smoke 是线路检查，不是质量证明。
- 不要默认所有环境都一样。宿主机能访问，不代表容器能访问；本机能跑，不代表 CI 能跑。
- 不要只保存最终结论，不保存过程证据。没有过程，结论无法复查。
- 不要隐藏不确定性。没查到、没权限、环境不可达、证据不足，都应该明确写进结果。
- 不要把 token、本机路径、私有地址、临时目录写死在可复用模板里。需要这些值时，通过运行参数或环境配置传入。
快速检查
- 有没有唯一事实源？
- 每个节点的问题是否足够单一？
- 每个节点是否会产生结构化 handoff？
- fan-in 是否只基于 handoff 和 evidence 下结论？
- hard gate 和 advisory 是否分清？
- smoke 和真实验证是否分清？
- 运行环境的网络、路径、权限是否从执行节点视角验证过？
- 失败时是否能直接看出原因和下一步？
© xiaotianfotos, 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 assets/orchestrations/dag-best-practices of xiaotianfotos/homerail.
Open the folder on GitHubat commit 916e343
Compare with similar skills
Dag Best Practices 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 |
|---|---|---|---|---|---|---|
| Dag Best Practices this skillxiaotianfotos/homerail | 994 | — | ~419 | Automated safety check: Pass | MIT | |
| Orca CLIstablyai/orca | 89k | 2 repos | ~593 | Automated safety check: Pass | MIT | |
| Paseo Advisor Second Opiniongetpaseo/paseo | 20k | 1 repos | ~756 | Automated safety check: Pass | Custom licence | |
| O2 Review Loopopenobserve/openobserve | 22k | — | ~3.7k | Automated safety check: Pass | AGPL-3.0 | |
| Paseo Committeegetpaseo/paseo | 20k | 1 repos | ~496 | Automated safety check: Pass | Custom licence | |
| Mission Control Agent APIbuilderz-labs/mission-control | 6.3k | — | ~2.1k | Automated safety check: Pass | MIT |
Similar skills
Paseo Advisor Second Opinion
getpaseo/paseo
Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.
O2 Review Loop
openobserve/openobserve
Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.
Paseo Committee
getpaseo/paseo
Forms a two-agent committee with contrasting profiles to analyze a stuck problem in parallel, reconcile their views and return a consensus plan without editing files.
Mission Control Agent API
builderz-labs/mission-control
Teaches an agent to use the Mission Control dashboard API: register, send heartbeats, fetch assigned tasks, report progress and disconnect, with API key auth.
Paseo Agent Handoff
getpaseo/paseo
Hands off the current task, including context, decisions and failed attempts, to a fresh agent through Paseo by writing a self-contained briefing prompt and launching that agent.
More from xiaotianfotos/homerail
All 11 skills in this repoHomerail Dag Ops
xiaotianfotos/homerail
Design, start, supervise, inspect, and continue HomeRail DAG workflows from any agent with CLI or HTTP access.
Voice Generative UI
xiaotianfotos/homerail
Design and maintain truthful HomeRail generative UI for voice or text.
Homerail CLI
xiaotianfotos/homerail
HomeRail CLI syntax, flags, configuration, and command reference.
Homerail Install Ops
xiaotianfotos/homerail
Install, configure, start, verify, update, and troubleshoot a local-source HomeRail deployment for AI-agent use.
Homerail PR Review
xiaotianfotos/homerail
Run HomeRail's built-in read-only pull request review DAG. An agent skill from xiaotianfotos/homerail.
Homerail Shared
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…
Related
Categories
Questions about Dag Best Practices
What does Dag Best Practices do?
HomeRail DAG review and execution best practices. An agent skill from xiaotianfotos/homerail. Dag Best Practices is an agent skill from xiaotianfotos/homerail. HomeRail DAG review and execution best practices.
When should I use Dag Best Practices?
Dag Best Practices fits situations like: reviewing HomeRail fan-out/fan-in DAGs; especially model-backed DAG audits; environment checks; agent handoff evidence.
How do I install Dag Best Practices in Claude Code?
Run `npx skills add xiaotianfotos/homerail --skill dag-best-practices -a claude-code`. Or copy the skill folder (assets/orchestrations/dag-best-practices in xiaotianfotos/homerail) into .claude/skills/dag-best-practices in your project. Claude Code loads it when a task matches its description.
How do I install Dag Best Practices in Codex?
Run `npx skills add xiaotianfotos/homerail --skill dag-best-practices -a codex`. Or copy the skill folder (assets/orchestrations/dag-best-practices in xiaotianfotos/homerail) into .agents/skills/dag-best-practices in your project. Codex loads it when a task matches its description.
Can I use Dag Best Practices 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 dag-best-practices -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dag-best-practices, .gemini/skills/dag-best-practices, .github/skills/dag-best-practices and .opencode/skills/dag-best-practices in your project.
What does Dag Best Practices need to run?
SKILL.md names no scripts, command-line tools or credentials: Dag Best Practices is instructions for the agent only.
Does Dag Best Practices 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 Dag Best Practices 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 Dag Best Practices use?
Dag Best Practices 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 Dag Best Practices use?
About 419 tokens (SKILL.md is roughly 1.7k 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 Dag Best Practices?
Skills that share tags, products or a category with Dag Best Practices: Orca CLI (stablyai/orca, 89k stars), Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars), O2 Review Loop (openobserve/openobserve, 22k stars) and Paseo Committee (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Dag Best Practices?
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.