
Agent Skills Anti-Patterns: 10 Problems and Better Fixes
Ten real Agent Skills failure modes—from invalid metadata and false portability claims to unsafe scripts and invented evidence—with standards-based fixes.
Read more

Ten real Agent Skills failure modes—from invalid metadata and false portability claims to unsafe scripts and invented evidence—with standards-based fixes.

Separate standards compliance, vendor compatibility, workflow quality, and runtime evidence with a ten-point Agent Skills audit designed for real engineering repositories.

Skill selection begins with metadata, not the hidden body. Learn the documented progressive-disclosure model and the observable evaluation method we use to improve routing.

The SKILL.md content format is portable, but discovery paths and runtime behavior differ. Use this vendor matrix and adapter strategy to avoid false one-setup claims.