Skip to content

Include ~/.agents/skills in default skill discovery paths #28

Description

@gevikhn

Include ~/.agents/skills in default skill discovery

Problem

DevSpace currently discovers skills from:

  • the default agent directory, which defaults to ~/.codex and therefore includes ~/.codex/skills
  • project-local .pi/skills
  • extra paths provided through DEVSPACE_SKILL_PATHS

However, ~/.agents/skills is also a common skills directory used by many agent workflows. It is also the default location used by npx skill when installing Codex-compatible skills.

This creates a confusing setup issue: a skill can be installed successfully under ~/.agents/skills, but DevSpace does not show it in open_workspace unless the user manually sets DEVSPACE_SKILL_PATHS.

Example

A skill installed at:

~/.agents/skills/understand/SKILL.md

does not appear in the open_workspace skills list with the default DevSpace configuration.

It appears only after manually setting:

DEVSPACE_SKILL_PATHS="$HOME/.agents/skills"

Expected behavior

DevSpace should include ~/.agents/skills in the default skill discovery paths, or make the effective default for DEVSPACE_SKILL_PATHS include that directory.

Suggested default discovery order:

  • ~/.codex/skills
  • ~/.agents/skills
  • project .pi/skills
  • user-provided DEVSPACE_SKILL_PATHS entries

Why this matters

  • ~/.agents/skills is used by many agent workflows.
  • npx skill installs Codex-compatible skills there by default.
  • Users can otherwise install a skill successfully but still think DevSpace failed to load it.
  • Adding this default path would reduce setup friction and better match the current agent ecosystem.

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