Skip to content

Conversation

@xl-openai
Copy link
Collaborator

Allow client to specify explicit skill invocation in v2 API.

@xl-openai xl-openai requested a review from celia-oai January 7, 2026 22:26
$skill-creator Add a new skill for triaging flaky CI and include step-by-step usage.
```

As an optimization, clients that detect `$<skill-name>` can include a `skill` input item in v2 requests.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you swap the order of these two? imo this should be at the start of the section as the "recommended" way. this one:

Skills can be invoked by including $<skill-name> in the text input; the model will look for the named skill and try to use it.
is more like a "btw, we can also do this" but we'll let folks know that it's not as optimized as the recommended way


### Example: Start a turn (invoke a skill)

Invoke a skill by sending a text input that begins with `$<skill-name>`.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you update this example to use the new "Skills" user input, since this is the recommended way?

@xl-openai xl-openai merged commit 75076aa into main Jan 8, 2026
26 checks passed
@xl-openai xl-openai deleted the xl/skill-inject branch January 8, 2026 02:26
@github-actions github-actions bot locked and limited conversation to collaborators Jan 8, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants