Summary
Installing per docs/install.md's Skills row leaves the skill directory with only SKILL.md — the references/ directory it links to is never installed, breaking 15 relative links (routing table, detailed-docs section, retry-chain rule, command comments, frontmatter description).
Repro
- Install per docs/install.md (Skills row):
| Skills | ~/.openclaw/skills/agent-reach/ | SKILL.md |
ls <skill dir> → only SKILL.md (no references/)
- Every link in SKILL.md points to
references/*.md:
- frontmatter description 「复杂场景需按需阅读对应分类的 references/*.md」
- rule 3 「失败按 references 里的重试链处理,不要瞎猜命令」
- routing table: 6 links (search/social/career/dev/web/video)
- command comments: 「见 video.md」「失败重试链见 social.md」
- 「详细文档」section: 6 links
- SKILL.md's own frontmatter declares
triggers including finance (雪球/股票), but the local copy has no finance routing line (upstream main has it — local copy also lags upstream).
Facts verified
- The files DO exist upstream, at
agent_reach/skill/references/ (same directory as SKILL.md): search.md, social.md, career.md, dev.md, web.md, video.md, finance.md — all HTTP 200, containing full commands and retry chains.
- Because SKILL.md and references/ live in the same directory upstream, relative links resolve correctly only if the whole directory is installed.
- Root cause: the install instructions/sample only copy SKILL.md, so any user following official docs reproduces this.
Impact
- Retry-chain instructions (rule 3) reference files that don't exist locally → agent hits a dead end on any platform failure.
- finance trigger (雪球/股票行情) has no local execution path.
- Local copy is an older version than upstream main (missing finance routing line, Twitter cookie env-var warning, etc.) — version drift on install.
Suggested fix
- Update install.md Skills row (and any installer script) to copy the whole
agent_reach/skill/ directory (SKILL.md + references/), or explicitly document that references/ must be fetched from the upstream repo.
- Consider bumping the shipped SKILL.md to match upstream main.
Summary
Installing per docs/install.md's Skills row leaves the skill directory with only SKILL.md — the
references/directory it links to is never installed, breaking 15 relative links (routing table, detailed-docs section, retry-chain rule, command comments, frontmatter description).Repro
| Skills | ~/.openclaw/skills/agent-reach/ | SKILL.md |ls <skill dir>→ onlySKILL.md(noreferences/)references/*.md:triggersincludingfinance(雪球/股票), but the local copy has no finance routing line (upstream main has it — local copy also lags upstream).Facts verified
agent_reach/skill/references/(same directory as SKILL.md): search.md, social.md, career.md, dev.md, web.md, video.md, finance.md — all HTTP 200, containing full commands and retry chains.Impact
Suggested fix
agent_reach/skill/directory (SKILL.md + references/), or explicitly document that references/ must be fetched from the upstream repo.