claude-code - 💡(How to fix) Fix [DOCS] Skill file changes in .claude/skills/ require restart — undocumented [1 participants]

TL;DR

Update the skills documentation to clarify whether live change detection applies to the standard project root .claude/skills/ location and specify if a restart is required for changes to take effect.

Guidance

• Review the current documentation for inconsistencies regarding live change detection for .claude/skills/ in both project root and --add-dir directories.
• Verify the actual behavior of live change detection for the project root .claude/skills/ location through testing.
• Consider adding a note to the documentation explicitly stating the requirement for a restart after editing skill files under the project root, if that is the case.
• Ensure that the documentation clearly differentiates between the behavior for --add-dir directories and the standard project root location.

Example

No code snippet is necessary for this issue as it pertains to documentation clarification.

Notes

The solution hinges on accurately documenting the behavior of live change detection for the project root .claude/skills/ location to avoid user confusion and frustration.

Recommendation

Apply workaround: Update the documentation to clearly state the behavior for both --add-dir directories and the standard project root .claude/skills/ location, including any requirements for restarting Claude Code after editing skill files. This will improve user understanding and reduce debugging time.