Context
The .agent/skills/ router markdown files and their references historically hardcoded /Users/Shared/github/neomjs/neo/ for absolute paths in instructions, breaking when agents run from alternative workspace paths such as /Users/Shared/antigravity/neomjs/neo/ (the Antigravity IDE configuration). This mismatch caused configuration hiccups where skills fail to resolve their payloads.
The Problem
A previous session initiated a mandate for .claude/skills symlinks and recognized that "we use just relative paths everywhere else". However, the hardcoded absolute paths inside the markdown instructions were not holistically cleaned up.
The Architectural Reality
The agent prompt parsing mechanism relies on reading these SKILL.md files. We updated 23 instances across 11 skills to use workspace-relative paths (e.g. .agent/skills/...).
The Fix
- Convert all
SKILL.md and references inside .agent/skills/ to use relative paths for the view_file tool instructions.
- Ensure the newly created
.claude/skills symlinks for epic-review, industry-friction-radar, and ticket-create are generated with relative paths.
- Add explicit instruction in
skill-authoring-guide.md specifying the relative-path ln -s command for new skills.
Acceptance Criteria
Origin Session ID
0b29a8fa-c6b0-42e2-ab3b-8015a99db2d8
Context The
.agent/skills/router markdown files and their references historically hardcoded/Users/Shared/github/neomjs/neo/for absolute paths in instructions, breaking when agents run from alternative workspace paths such as/Users/Shared/antigravity/neomjs/neo/(the Antigravity IDE configuration). This mismatch caused configuration hiccups where skills fail to resolve their payloads.The Problem A previous session initiated a mandate for
.claude/skillssymlinks and recognized that "we use just relative paths everywhere else". However, the hardcoded absolute paths inside the markdown instructions were not holistically cleaned up.The Architectural Reality The agent prompt parsing mechanism relies on reading these
SKILL.mdfiles. We updated 23 instances across 11 skills to use workspace-relative paths (e.g..agent/skills/...).The Fix
SKILL.mdand references inside.agent/skills/to use relative paths for theview_filetool instructions..claude/skillssymlinks forepic-review,industry-friction-radar, andticket-createare generated with relative paths.skill-authoring-guide.mdspecifying the relative-pathln -scommand for new skills.Acceptance Criteria
/Users/Shared/github/neomjs/neo/paths exist in.agent/skills/.create-skill/references/skill-authoring-guide.mdinstructs using relative paths for tool parameters and symlinking..claude/skillssymlinks are present.Origin Session ID 0b29a8fa-c6b0-42e2-ab3b-8015a99db2d8