Skip to content

CodexMonitor: project skills under <workspace>/.agents/skills are not reliably discovered #523

@szcascsa

Description

@szcascsa

Summary

When using CodexMonitor, the Codex CLI / app-server can read project-scoped skills from:

  • <workspace>/.agents/skills/*/SKILL.md

…but CodexMonitor does not reliably surface these skills in the UI (e.g. $ autocomplete, skills list), especially after switching workspaces.

Expected

  1. Project skills under <workspace>/.agents/skills are always discovered and listed.
  2. $ autocomplete includes these project skills.
  3. Switching workspaces refreshes the skills list and it matches the active workspace.
  4. When discovery fails, show actionable diagnostics (source path + reason).

Actual

  • Project skills sometimes do not appear.
  • The list may be stale after switching workspaces.

Repro

  1. In a workspace, create: ./.agents/skills/<skill-name>/SKILL.md.
  2. Open CodexMonitor and connect that workspace.
  3. In the composer, type $ and check autocomplete.
  4. Switch between workspaces and observe skills list inconsistency.

Why this matters

Project-scoped skills are a core workflow for per-project automation. When CodexMonitor fails to discover them reliably, users cannot access the intended skills and it becomes hard to diagnose.

Suggested direction

  • Ensure skills/list includes the default project skills path <workspace>/.agents/skills.
  • Add non-breaking diagnostics fields (e.g. sourcePaths, sourceErrors) so the UI can surface why a source was skipped.
  • Ensure workspace switching triggers a proper refresh.

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