Skip to content

🤖 feat: add universal skills load path#2419

Merged
ammario merged 1 commit intomainfrom
feat/universal-skill-load-path
Feb 13, 2026
Merged

🤖 feat: add universal skills load path#2419
ammario merged 1 commit intomainfrom
feat/universal-skill-load-path

Conversation

@ammar-agent
Copy link
Collaborator

Summary

Add support for a universal skills directory at ~/.agents/skills so Mux can discover and load shared skills beyond ~/.mux/skills.

Background

Users may already keep cross-tool skills under ~/.agents/skills. Mux previously only scanned project-local .mux/skills and ~/.mux/skills, so those shared skills were not visible unless manually mirrored.

Implementation

  • Extended AgentSkillsRoots with optional universalRoot and set default to ~/.agents/skills.
  • Updated skill discovery/read paths to scan global roots in deterministic order:
    • project .mux/skills
    • ~/.mux/skills
    • ~/.agents/skills
    • built-ins fallback
  • Added a focused unit test covering precedence and universal-only lookup.
  • Updated tool description and docs to reflect the new root and precedence.

Validation

  • bun test src/node/services/agentSkills/agentSkillsService.test.ts
  • make typecheck
  • make static-check

Risks

Low. Changes are scoped to skill root enumeration/lookup and preserve existing precedence by keeping ~/.mux/skills ahead of ~/.agents/skills.


Generated with mux • Model: openai:gpt-5.3-codex • Thinking: xhigh • Cost: $0.00

Add support for loading skills from ~/.agents/skills in addition to existing project and ~/.mux global roots.

This updates discovery and read resolution to scan both global roots in deterministic order (~/.mux first, ~/.agents second), and adds coverage + docs/tooling text updates for the new root and precedence.

---

_Generated with `mux` • Model: `openai:gpt-5.3-codex` • Thinking: `xhigh` • Cost: `bash.00`_

<!-- mux-attribution: model=openai:gpt-5.3-codex thinking=xhigh costs=0.00 -->
@ammario ammario merged commit d762c7b into main Feb 13, 2026
22 checks passed
@ammario ammario deleted the feat/universal-skill-load-path branch February 13, 2026 16:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants