Skip to content

feat: use universal .agents/skills/ folder for compatible clients#90

Merged
christso merged 7 commits intomainfrom
feat/universal-agents-folder
Feb 6, 2026
Merged

feat: use universal .agents/skills/ folder for compatible clients#90
christso merged 7 commits intomainfrom
feat/universal-agents-folder

Conversation

@christso
Copy link
Copy Markdown
Contributor

@christso christso commented Feb 6, 2026

Summary

  • Update CLIENT_MAPPINGS and USER_CLIENT_MAPPINGS to use .agents/skills/ for clients that support the universal folder convention (copilot, codex, opencode, gemini, ampcode)
  • Keep provider-specific paths for clients with their own ecosystems (claude, cursor, factory)
  • Add deduplication logic to copy skills once per unique path when multiple clients share .agents/skills/
  • Ensure sync state tracks files for all clients sharing a path for proper cleanup

Why

Many AI coding assistants now support the universal .agents/skills/ folder. This reduces duplication when syncing plugins to multiple clients and aligns with emerging industry convention.

Test Plan

  • Verify [copilot, codex, opencode] results in .agents/skills/ written once
  • Verify [claude, copilot, cursor] results in three separate folders
  • Verify user-level sync deduplication works
  • Verify empty skillsPath (vscode) doesn't cause issues
  • All 554 tests pass

Closes #91

christso and others added 5 commits February 6, 2026 03:55
…MAPPINGS

Update CLIENT_MAPPINGS to use .agents/skills/ for clients that support
the universal agents folder (copilot, codex, opencode, gemini, ampcode).
Keep provider-specific paths for claude, cursor, and factory.

This reduces duplication when syncing plugins to multiple clients that
share the .agents/skills/ convention.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…T_MAPPINGS

Update skillsPath for copilot, codex, opencode, gemini, and ampcode
to use ~/.agents/skills/ instead of provider-specific paths.
This enables skill sharing across agents at the user level.
When multiple clients share the same skillsPath (e.g., copilot, codex,
opencode, gemini, ampcode all use .agents/skills/), skills are now
copied only once instead of multiple times.

Changes:
- Add deduplicateClientsByPath() to group clients by skillsPath
- Update copyValidatedPlugin() to copy only to representative clients
- Update collectSyncedPaths() to track files for ALL clients sharing path
- Add comprehensive tests for deduplication behavior
- Update existing tests to reflect new .agents/skills/ paths
…plication

Verifies:
- vscode client with empty skillsPath is handled as unique (not grouped)
- user-level sync deduplicates universal clients (copilot, codex, opencode)
- mixed unique and universal clients sync to separate paths correctly
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages bot commented Feb 6, 2026

Deploying allagents with  Cloudflare Pages  Cloudflare Pages

Latest commit: 261011c
Status: ✅  Deploy successful!
Preview URL: https://eeda2296.allagents.pages.dev
Branch Preview URL: https://feat-universal-agents-folder.allagents.pages.dev

View logs

@christso christso merged commit 073d908 into main Feb 6, 2026
1 check passed
@christso christso deleted the feat/universal-agents-folder branch February 6, 2026 04:32
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.

feat: use symlinks for shared skills across clients (vercel/skills compatibility)

1 participant