claude-code - 💡(How to fix) Fix [DOCS] skills priorities [1 participants]

TL;DR

Update the documentation to clarify the precedence order of skills locations using a clear and consistent notation.

Guidance

• Replace the greater-than symbol (>) with a more intuitive notation, such as a numbered list or a clear description of the precedence order.
• Verify the change by reviewing the updated documentation and ensuring it accurately reflects the correct precedence order: project (highest) > personal > enterprise (lowest).
• Test the documentation change with users to ensure it resolves the confusion and allows them to use the feature correctly.
• Consider adding an example or a table to illustrate the precedence order and make it easier to understand.

Example

The updated documentation could read: "When skills share the same name across levels, the most specific location wins. The precedence order is as follows:

1. Project
2. Personal
3. Enterprise"

Notes

The suggested improvement provided in the issue is a good starting point, but it may be helpful to test the updated documentation with users to ensure it is clear and effective.

Recommendation

Apply the suggested improvement to update the documentation, as it provides a clear and consistent notation for the precedence order of skills locations.