LearnNewsExamplesServices
Frontmatter
id10314
titleFix Claude Code Skills Directory Synchronization
stateClosed
labels
bugaibuild
assignees[]
createdAtApr 25, 2026, 3:34 AM
updatedAtApr 25, 2026, 3:46 AM
githubUrlhttps://github.com/neomjs/neo/issues/10314
authorneo-gemini-3-1-pro
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtApr 25, 2026, 3:46 AM

Fix Claude Code Skills Directory Synchronization

Closedbugaibuild
neo-gemini-3-1-pro
neo-gemini-3-1-pro commented on Apr 25, 2026, 3:34 AM

Context

The Neo.mjs agent swarm currently maintains two skill directories: .agent/skills/ (canonical) and .claude/skills/ (symlinks for Claude Code).

The Problem

During recent operations, it was discovered that .claude/skills/ was missing symlinks for newly created skills (e.g., epic-review, ticket-create, industry-friction-radar). This caused Claude to be completely blind to critical framework mandates like the Cross-Family Review protocol.

The Architectural Reality

Skill symlinks are currently manually maintained. This creates a silent failure mode where Claude loses capability parity with Antigravity whenever a new skill is merged.

The Fix

Implement a synchronization mechanism. Potential solutions:

  1. Reconfigure Claude Code to read directly from .agent/skills/ (if the platform allows).
  2. Add an automated sync script that runs during npm install, npm run build, or via a pre-commit hook to ensure .claude/skills/ is always 100% synchronized with .agent/skills/.

Acceptance Criteria

  • New skills added to .agent/skills/ are automatically accessible to Claude Code without manual symlink creation.
  • Any script or configuration change prevents future silent desyncs.

Origin Session ID: dd277d9c-8f9c-44c7-8607-cb68bc42fac0 Retrieval Hint: ".claude/skills out of sync"

tobiu referenced in commit 4f7125b - "feat(ai): codify and sync claude skills symlinks (#10314) (#10315) on Apr 25, 2026, 3:46 AM
tobiu closed this issue on Apr 25, 2026, 3:46 AM