Skip to content

graphify opencode install does not copy skill file to ~/.config/opencode/skills/graphify/SKILL.md #2670

Description

@ColaHikari

Bug

graphify opencode install only writes the AGENTS.md section and the tool.execute.before plugin, but does not copy the skill file (skill-opencode.md) to ~/.config/opencode/skills/graphify/SKILL.md. As a result, the /graphify command is unavailable in OpenCode — the skill is never discovered.

Root cause

In install.py, graphify opencode install (without --project) calls _agents_install(Path("."), "opencode") (line 2265):

# line 2259-2265
elif cmd in ("aider", "codex", "opencode", "claw", "droid", "trae", "trae-cn", "hermes"):
    subcmd = sys.argv[2] if len(sys.argv) > 2 else ""
    if subcmd == "install":
        if "--project" in sys.argv[3:]:
            _project_install(cmd, Path("."))
        else:
            _agents_install(Path("."), cmd)  # <-- no _copy_skill_file

_agents_install (line 1470) only writes the AGENTS.md section + plugin, it never calls _copy_skill_file.

Compare with _amp_install (line 1518) and _agents_platform_install (line 1529), which both call _copy_skill_file before _agents_install:

def _amp_install(project_dir):
    _amp_legacy_cleanup()
    _copy_skill_file("amp")           # <-- copies skill
    _agents_install(project_dir, "amp")

def _agents_platform_install(project_dir):
    _copy_skill_file("agents")        # <-- copies skill
    _agents_install(project_dir, "agents")

The platform config at line 338 already defines the correct destination:

"opencode": {
    "skill_file": "skill-opencode.md",
    "skill_dst": Path(".config") / "opencode" / "skills" / "graphify" / "SKILL.md",
    ...
},

But no code path for graphify opencode install ever uses skill_dst to copy the file.

Environment

  • graphifyy 0.9.40 (installed via uv tool install graphifyy)
  • macOS (nix-darwin)
  • OpenCode

Install output (actual)

$ graphify opencode install
graphify section written to /Users/luda/.config/opencode/AGENTS.md
  .opencode/plugins/graphify.js  ->  tool.execute.before hook written
  .opencode/opencode.json  ->  plugin registered

Opencode will now check the knowledge graph before answering
codebase questions and rebuild it after code changes.

No mention of skill file copy. ~/.config/opencode/skills/graphify/SKILL.md does not exist after install.

Expected output

Should also copy the skill file:

  skills/graphify/SKILL.md  ->  skill file written

Suggested fix

Either:

  1. Add a dedicated _opencode_install function (like _amp_install) that calls _copy_skill_file("opencode") before _agents_install, or
  2. Add _copy_skill_file(platform) inside _agents_install for platforms that have a skill_dst (opencode, codex, etc.)

Workaround

Manual copy after install:

mkdir -p ~/.config/opencode/skills/graphify/references
cp <graphify-package>/skill-opencode.md ~/.config/opencode/skills/graphify/SKILL.md
cp <graphify-package>/skills/opencode/references/*.md ~/.config/opencode/skills/graphify/references/

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions