Skip to content

install.md Skills table only lists SKILL.md — references/ dir missing after install, all relative links broken #622

Description

@HiSeax

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

  1. Install per docs/install.md (Skills row): | Skills | ~/.openclaw/skills/agent-reach/ | SKILL.md |
  2. ls <skill dir> → only SKILL.md (no references/)
  3. 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
  4. 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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions