Align skill descriptions with Anthropic best practices

Update all SKILL.md descriptions to lead with what the skill does
(third person) followed by trigger conditions, per Anthropic's
skill authoring docs. All original trigger conditions preserved.
Update description max chars to match Anthropic spec (1024).
Retain workflow-summary warning in skill-anatomy.md to prevent
agents from following descriptions instead of reading full skills.
Add Table of Contents to reference files longer than 100 lines so
Claude can see the full scope of available information even when
previewing with partial reads.
This commit is contained in:
Federico Bartoli committed 2026-03-31 22:41:45 +02:00
1 parent 2ca6fec681
commit fea75b1647
26 files changed
+64 -24

No files matched your search

+1 -1
View File
@@ -1,6 +1,6 @@
---
name: code-simplification
description: Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.
description: Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend than it should be. Use when reviewing code that has accumulated unnecessary complexity.
---
# Code Simplification