Skip to content

comet update v0.3.7 breaks /comet slash command — symlink targets missing #85

@pioneerAlone

Description

@pioneerAlone

Description

After running comet update to v0.3.7, the /comet slash command is no longer available in Claude Code. comet doctor reports all 16 IDE targets as "missing 16" skill files.

Root Cause

The symlinks in ~/.claude/skills/ point to ~/.agents/skills/comet*, but the target directories don't exist:

$ ls -la ~/.claude/skills/ | grep comet
lrwxr-xr-x  comet -> ../../.agents/skills/comet          ← symlink exists
lrwxr-xr-x  comet-open -> ../../.agents/skills/comet-open  ← symlink exists
...

$ ls ~/.agents/skills/comet/
ls: No such file or directory                              ← target missing

All 8 comet skill directories (comet, comet-open, comet-build, comet-design, comet-verify, comet-archive, comet-hotfix, comet-tweak) have broken symlinks — the target ~/.agents/skills/comet* directories do not exist.

Steps to Reproduce

  1. Have an existing comet installation using the symlink model (~/.claude/skills/comet*~/.agents/skills/comet*)
  2. Run comet update
  3. Output shows "Copying 16 skill files..." successfully
  4. Run comet doctor — all 16 targets show "missing 16"
  5. /comet slash command not available in Claude Code

System Info

  • OS: macOS 14.4.1 (Darwin 23.4.0, Apple Silicon arm64)
  • Node: v25.2.1
  • npm: 11.6.2
  • Comet: v0.3.7
  • openspec CLI: 1.3.1
  • Claude Code: global scope

comet update Output

Comet Update v0.3.7

Updating npm package (global scope)...
  $ npm install -g @rpamis/comet@latest
npm package: updated to latest @rpamis/comet

Updating comet skills on 16 installed target(s):
  - Claude Code (global, en)
    $ copy assets/skills -> ~/.claude/skills/ (global)
  ... (16 targets listed)

Copying 16 skill files...
Comet skill files updated.
Run 'comet doctor' to verify.

comet doctor Output (key excerpt)

✗ working directories: missing — run: comet init
⚠ skills: Claude Code (global): missing 16: comet/SKILL.md, 
  comet/reference/dirty-worktree.md, comet/scripts/comet-env.sh, 
  comet/scripts/comet-guard.sh, comet/scripts/comet-state.sh, 
  comet/scripts/comet-handoff.sh, comet/scripts/comet-archive.sh, 
  comet/scripts/comet-yaml-validate.sh, comet/scripts/comet-hook-guard.sh, 
  comet-open/SKILL.md, comet-design/SKILL.md, comet-build/SKILL.md, 
  comet-verify/SKILL.md, comet-archive/SKILL.md, comet-hotfix/SKILL.md, 
  comet-tweak/SKILL.md
✓ scripts executable: OK (7 scripts)

Same "missing 16" warning repeats for all 16 IDE targets.

Expected Behavior

comet update should either:

  • Copy skill files to the symlink target directories (~/.agents/skills/comet*)
  • Or recreate the symlinks to point to the correct location where the files were copied

comet doctor should show all skills as present across all targets.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    Status
    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions