zlacker

[parent] [thread] 3 comments
1. gbaldu+(OP)[view] [source] 2026-02-04 17:02:43
> This is different from swagger / OpenAPI how?

In the way that Swagger / OpenAPI is for API endpoints, but most of the "skills" you need for your agents are not based on API endpoints

replies(1): >>ethbr1+8j
2. ethbr1+8j[view] [source] 2026-02-04 18:23:28
>>gbaldu+(OP)
I mean conceptually.

Why not just extend the OpenAPI specification to skills? Instead of recreating something that's essentially communicating the same information?

T minus a couple years before someone declares that down-mapping skills into a known verb enumeration promotes better skill organization...

replies(1): >>dragon+Tk
◧◩
3. dragon+Tk[view] [source] [discussion] 2026-02-04 18:30:53
>>ethbr1+8j
> Why not just extend the OpenAPI specification to skills?

Because approximately none of what exists in the existing OpenAPI specification is relevant to the task, and nothing needed for the tasks is relevant to the current OpenAPI use case, so trying to jam one use case into a tool designed for the other would be pure nonsense.

It’s like needing to drive nails and asking why grab a hammer when you already have a screwdriver.

replies(1): >>ethbr1+ZV3
◧◩◪
4. ethbr1+ZV3[view] [source] [discussion] 2026-02-05 18:59:50
>>dragon+Tk
You think indexing skills in increasingly structured, parameterized formats has nothing to do with documenting REST API endpoints?
[go to top]