Skip to content

fix(agents): show real description on agent cards, not instructions - #66

Merged
delkc merged 2 commits into
mainfrom
claydelk/agent-card-descriptions-oss
Aug 17, 2026
Merged

fix(agents): show real description on agent cards, not instructions#66
delkc merged 2 commits into
mainfrom
claydelk/agent-card-descriptions-oss

Conversation

@delkc

@delkc delkc commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Why

Agent cards rendered persona.systemPrompt unconditionally, so even a well-described agent showed its raw "You are X..." instructions instead of its description.

What

  • Cards now show the real description when one exists, falling back to instructions only when the description is missing or still the API's placeholder ("Agent"/"Draft").
  • Adds a Description field to the manual agent create/edit rail, which previously only exposed Name and Instructions, silently writing the "Agent" placeholder into every agent's description on save.
  • Unifies the placeholder-detection logic (previously duplicated and inconsistent between PersonaCard.tsx and agentShareCard.ts) behind one shared helper.

References

Ported from the original branch on squareup/berd (now archived) after the migration to block/berd. Verified byte-for-byte equivalent against the original commit for all files whose surrounding code hadn't drifted; hand-ported the two files (PersonaCard.tsx, agentShareCard.ts) where it had.

Generated with Claude Code

delkc and others added 2 commits August 17, 2026 09:45
Agent cards rendered persona.systemPrompt unconditionally, so even a
well-described agent showed its raw "You are X..." instructions instead
of its description. Cards now show the real description when one
exists, falling back to instructions only when the description is
missing or still the API's placeholder ("Agent"/"Draft").

Also adds a Description field to the manual agent create/edit rail,
which previously only exposed Name and Instructions, silently writing
the "Agent" placeholder into every agent's description on save.

Co-Authored-By: Claude <noreply@anthropic.com>
Adds a labeled Description row to the agent detail page's metadata
list (below the divider, alongside Provider/Model/Created/Updated) so
a real description is visible without opening the edit view. Adds a
multiline metadata option distinct from the existing wrap option,
since break-all is meant for unbroken strings like file paths and
would mangle real prose.

Also fixes the "Change avatar" hover label on this page, which
resolved to the raw key editor.changeAvatar instead of real text —
the key only ever existed under builderRail, where the same label is
already used correctly for the same action.

Co-Authored-By: Claude <noreply@anthropic.com>
@delkc
delkc marked this pull request as ready for review August 17, 2026 19:48
@delkc
delkc requested a review from a team August 17, 2026 19:48
@delkc
delkc merged commit 09c171b into main Aug 17, 2026
8 checks passed
@delkc
delkc deleted the claydelk/agent-card-descriptions-oss branch August 17, 2026 21:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants