Comment by Ross00781

The tension between discoverability and flexibility is real. I wonder if there's room for a hybrid approach - structured skill metadata (think OpenAPI-style specs for inputs/outputs) that can be compiled down to markdown context when needed. This would let agents validate tool calls before making them, while still keeping the LLM-friendly text format for reasoning about when to use them.