[Feature Request]: `{agent-skill}` callout enhancements?

[shainaraskas]

Prerequisites

• I have searched existing issues to ensure this feature hasn't already been requested
• I have tested using the latest version of docs-builder

What problem are you trying to solve?

the agent-skill output is limited:

when we put it on a page, the scope of the page and the scope of the skill usually is a slight mismatch in a way that can't be solved by changing the placement.

suggest:

• allowing a sentence of clarification of the scope of the skill
• possibly allowing two skills to be linked in the same callout (surfacing titles so people don't try to pursue the same skills over and over?)
• possibly reassessing the formatting - is that smaller font size on the second line intended?
• do we have ANY other colors at our disposal? I don't want these to get confused with tips (there are lots of tips)

Proposed Solution

seeeee above

Examples and Research

No response

Alternative Solutions

No response

Additional Context

No response

How important is this feature to you?

Important