npx skills add for cli-anything doesn't bundle references/ (HARNESS.md + commands/)

Author: xiaov1024Created Aug 14, 2026Updated Aug 28, 2026

Bug: npx skills add doesn't bundle references/ directory for the cli-anything skill

Environment

  • macOS 26.6.1 (arm64)
  • OpenClaw 2026.7.2-beta.7
  • npx 11.18.0
  • Install date: 2026-08-14

Reproduction

npx skills add HKUDS/CLI-Anything --skill cli-anything -g -y
ls ~/.openclaw/skills/cli-anything/
# Expected: SKILL.md, references/, agents/, scripts/, tests/
# Actual:   SKILL.md, agents/, scripts/, tests/   ← no references/

What goes wrong

The installed SKILL.md tells agents to read the methodology like this:

## Read the Full Methodology First

Before implementation, use the full methodology source of truth:

1. Read `references/HARNESS.md` relative to this skill directory.
2. Read the matching mode specification under `references/commands/`.

But neither references/HARNESS.md nor references/commands/ ship with the bundle. Agents using this skill fall back to the condensed rules in SKILL.md and lose access to the full 7-phase methodology.

Root cause

The canonical source lives at cli-anything-plugin/HARNESS.md and cli-anything-plugin/commands/*.md in the repo. These are not referenced by npx skills's manifest and therefore not copied into the install bundle. There also doesn't seem to be a skills/cli-anything/ directory in the repo (only skills/cli-anything-{software}/ for per-application harnesses).

Workaround

SKILL_DIR=~/.agents/skills/cli-anything   # or ~/.openclaw/skills/cli-anything
mkdir -p "$SKILL_DIR/references/commands"
curl -L https://raw.githubusercontent.com/HKUDS/CLI-Anything/main/cli-anything-plugin/HARNESS.md -o "$SKILL_DIR/references/HARNESS.md"
for cmd in cli-anything list refine test validate; do
  curl -L "https://raw.githubusercontent.com/HKUDS/CLI-Anything/main/cli-anything-plugin/commands/${cmd}.md" -o "$SKILL_DIR/references/commands/${cmd}.md"
done

Suggested fix

Either:

  1. Bundle references/ in npx skills add by adding the path to the skill manifest / files list, so the install copies cli-anything-plugin/HARNESS.mdreferences/HARNESS.md and cli-anything-plugin/commands/*.mdreferences/commands/.
  2. Symlink references/ to ../cli-anything-plugin/ at install time (when the skill is used from inside this repo, like the Codex skill does for its HARNESS.md reference).
  3. Create a repo-root skills/cli-anything/ directory with the SKILL.md + symlinked references/, and update the install source.

Happy to send a PR for option 1 or 2 if helpful — let me know which approach the maintainers prefer.