Skip to content

Support OpenCode.ai skills directory during install #71

@danielmeppiel

Description

@danielmeppiel

Summary

OpenCode.ai is an open-source AI coding agent with 80k+ GitHub stars that supports the AGENTS.md standard. However, it has its own skills discovery paths that APM doesn't currently target during apm install.

Current Behavior

When running apm install, skills are placed in:

  • .github/skills/ → VSCode/Copilot
  • .claude/skills/ → Claude Code

OpenCode Skills Discovery

OpenCode looks for skills in these locations (docs):

  • .opencode/skills/<name>/SKILL.md (primary)
  • .claude/skills/<name>/SKILL.md (Claude-compatible)
  • ~/.config/opencode/skills/ (global)
  • ~/.claude/skills/ (global Claude-compatible)

Partial Compatibility

OpenCode has Claude-compatible discovery, so skills installed to .claude/skills/ are already picked up. However, users who only use --target vscode or don't have Claude tooling won't get OpenCode support.

Proposed Solution

During apm install, also output skills to .opencode/skills/<name>/SKILL.md when:

  1. OpenCode is detected (e.g., opencode.json exists in project), OR
  2. A new --target opencode flag is used, OR
  3. .opencode/ directory already exists

The SKILL.md format is identical to what APM already generates, so no transformation is needed—just an additional output path.

Alternative

Document that users should use --target claude or --target all to ensure OpenCode compatibility via the .claude/skills/ path.

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    acceptedDirection approved, safe to start workenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions