Skip to content

agent: Warn about long skill descriptions - #58356

Merged
anantdgoel merged 11 commits into
mainfrom
skills-md-drop-description-hard-limit
Jun 5, 2026
Merged

agent: Warn about long skill descriptions#58356
anantdgoel merged 11 commits into
mainfrom
skills-md-drop-description-hard-limit

Conversation

@anantdgoel

@anantdgoel anantdgoel commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Closes #58046
Closes AI-353

Skills with descriptions over the 1024-byte limit now load with a warning instead of failing. The warning appears in the thread footer with clickable skill file rows, and the skill picker keeps the skill icon while showing a right-aligned warning badge whose hover text explains the issue.

Warning for single out-of-spec skill
image

Warning for multiple out-of-spec skills
image

Skill selection popup
image

Skill management in settings
image

Release Notes:

  • Allow loading skills whose descriptions exceed the 1024-byte limit by showing warnings instead of failing to load them.

Co-authored-by: Martin Ye <martin@zed.dev>
@cla-bot cla-bot Bot added the cla-signed The user has signed the Contributor License Agreement label Jun 2, 2026
@anantdgoel
anantdgoel marked this pull request as draft June 2, 2026 19:13
@zed-community-bot zed-community-bot Bot added the staff Pull requests authored by a current member of Zed staff label Jun 2, 2026
anantdgoel and others added 3 commits June 2, 2026 13:14
Co-authored-by: Martin Ye <martin@zed.dev>
- Introduce CompletionDocumentation::WarningAndMultiLinePlainText
- Render warnings alongside completion text and adjust size calculations
- Refactor skill issue rows to a file-centric layout with icons and
  tooltips
- Add file-open behavior on clicking skill issue rows
- Use uri-based icons for skill completion paths
- Update skill completion docs to use the new warning variant
- Move skill loading UI placement within ThreadView
- Extend LSP store display logic to support the new warning variant

Co-authored-by: Martin Ye <martin@zed.dev>
@anantdgoel anantdgoel changed the title init agent: Warn about long skill descriptions Jun 2, 2026
@anantdgoel
anantdgoel marked this pull request as ready for review June 5, 2026 15:37
@anantdgoel anantdgoel self-assigned this Jun 5, 2026
@anantdgoel
anantdgoel requested a review from MartinYe1234 June 5, 2026 19:28
@anantdgoel
anantdgoel enabled auto-merge June 5, 2026 19:36
@anantdgoel
anantdgoel added this pull request to the merge queue Jun 5, 2026
Merged via the queue into main with commit 6d68395 Jun 5, 2026
32 checks passed
@anantdgoel
anantdgoel deleted the skills-md-drop-description-hard-limit branch June 5, 2026 19:48
TomPlanche pushed a commit to TomPlanche/zed that referenced this pull request Jun 8, 2026
Closes zed-industries#58046 
Closes AI-353

Skills with descriptions over the 1024-byte limit now load with a
warning instead of failing. The warning appears in the thread footer
with clickable skill file rows, and the skill picker keeps the skill
icon while showing a right-aligned warning badge whose hover text
explains the issue.

Warning for single out-of-spec skill
<img width="2790" height="870" alt="image"
src="https://github.com/user-attachments/assets/f454b55a-8e05-438e-b4ff-356259ff6843"
/>

Warning for multiple out-of-spec skills
<img width="2796" height="646" alt="image"
src="https://github.com/user-attachments/assets/a0808cdd-4857-4a6b-a26e-15156afbffe9"
/>

Skill selection popup
<img width="1234" height="1118" alt="image"
src="https://github.com/user-attachments/assets/5bb463f6-7adb-4e39-8522-e322bf078aff"
/>

Skill management in settings
<img width="1768" height="1390" alt="image"
src="https://github.com/user-attachments/assets/85c6b179-e268-4518-8ca7-c73b55f92355"
/>


Release Notes:

- Allow loading skills whose descriptions exceed the 1024-byte limit by
showing warnings instead of failing to load them.

---------

Co-authored-by: Martin Ye <martin@zed.dev>
Co-authored-by: zed-zippy[bot] <234243425+zed-zippy[bot]@users.noreply.github.com>
This was referenced Jun 18, 2026
jonx pushed a commit to jonx/zed-aros that referenced this pull request Jul 17, 2026
Closes zed-industries#58046 
Closes AI-353

Skills with descriptions over the 1024-byte limit now load with a
warning instead of failing. The warning appears in the thread footer
with clickable skill file rows, and the skill picker keeps the skill
icon while showing a right-aligned warning badge whose hover text
explains the issue.

Warning for single out-of-spec skill
<img width="2790" height="870" alt="image"
src="https://github.com/user-attachments/assets/f454b55a-8e05-438e-b4ff-356259ff6843"
/>

Warning for multiple out-of-spec skills
<img width="2796" height="646" alt="image"
src="https://github.com/user-attachments/assets/a0808cdd-4857-4a6b-a26e-15156afbffe9"
/>

Skill selection popup
<img width="1234" height="1118" alt="image"
src="https://github.com/user-attachments/assets/5bb463f6-7adb-4e39-8522-e322bf078aff"
/>

Skill management in settings
<img width="1768" height="1390" alt="image"
src="https://github.com/user-attachments/assets/85c6b179-e268-4518-8ca7-c73b55f92355"
/>


Release Notes:

- Allow loading skills whose descriptions exceed the 1024-byte limit by
showing warnings instead of failing to load them.

---------

Co-authored-by: Martin Ye <martin@zed.dev>
Co-authored-by: zed-zippy[bot] <234243425+zed-zippy[bot]@users.noreply.github.com>
jolutz pushed a commit to jolutz/zed that referenced this pull request Aug 8, 2026
Closes zed-industries#58046 
Closes AI-353

Skills with descriptions over the 1024-byte limit now load with a
warning instead of failing. The warning appears in the thread footer
with clickable skill file rows, and the skill picker keeps the skill
icon while showing a right-aligned warning badge whose hover text
explains the issue.

Warning for single out-of-spec skill
<img width="2790" height="870" alt="image"
src="https://github.com/user-attachments/assets/f454b55a-8e05-438e-b4ff-356259ff6843"
/>

Warning for multiple out-of-spec skills
<img width="2796" height="646" alt="image"
src="https://github.com/user-attachments/assets/a0808cdd-4857-4a6b-a26e-15156afbffe9"
/>

Skill selection popup
<img width="1234" height="1118" alt="image"
src="https://github.com/user-attachments/assets/5bb463f6-7adb-4e39-8522-e322bf078aff"
/>

Skill management in settings
<img width="1768" height="1390" alt="image"
src="https://github.com/user-attachments/assets/85c6b179-e268-4518-8ca7-c73b55f92355"
/>


Release Notes:

- Allow loading skills whose descriptions exceed the 1024-byte limit by
showing warnings instead of failing to load them.

---------

Co-authored-by: Martin Ye <martin@zed.dev>
Co-authored-by: zed-zippy[bot] <234243425+zed-zippy[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed The user has signed the Contributor License Agreement staff Pull requests authored by a current member of Zed staff

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Skill failed to load

2 participants