Skip to content

Replace ~~placeholder strings with readable tool names in user-facing text#89

Open
yoheidemachi wants to merge 1 commit intoanthropics:mainfrom
yoheidemachi:fix/placeholder-strings
Open

Replace ~~placeholder strings with readable tool names in user-facing text#89
yoheidemachi wants to merge 1 commit intoanthropics:mainfrom
yoheidemachi:fix/placeholder-strings

Conversation

@yoheidemachi
Copy link

@yoheidemachi yoheidemachi commented Mar 1, 2026

Summary

Several plugin command and skill files display ~~category placeholder strings verbatim to users instead of showing actual tool names. This makes the onboarding experience confusing.

Changes

File Change
bio-research/commands/start.md Replace ~~literature database, ~~chemical database, etc. with actual server names (PubMed, ChEMBL, BioRender, etc.) from .mcp.json, keeping ~~category in parentheses for reference
enterprise-search/commands/search.md Replace ~~chat, ~~email etc. in the "no sources connected" error message with readable examples (e.g. Slack, Jira, Notion)
sales/skills/draft-outreach/SKILL.md Replace "check ~~email" with "check your email client"

The ~~category convention in CONNECTORS.md is preserved for internal/workflow references — only user-facing text (welcome messages, error messages, examples) is updated.

Note

The original start.md contained a ~~clinical data platform entry ("clinical trial site ranking and platform help") which has no corresponding category in CONNECTORS.md or server in .mcp.json. This line was removed as it appears to be an outdated/orphaned entry. If this should be kept, please let me know what the correct tool name is and I'll add it back.

Fixes #71

… text

The ~~category convention is used internally for tool-agnostic references,
but user-facing text (welcome messages, error messages, examples) should
show actual tool names for clarity.

- bio-research/commands/start.md: Replace ~~literature database, ~~chemical
  database, etc. with PubMed, ChEMBL, BioRender and other actual server names
- enterprise-search/commands/search.md: Replace ~~chat, ~~email etc. in the
  "no sources connected" message with readable examples (e.g. Slack, Jira)
- sales/skills/draft-outreach/SKILL.md: Replace "check ~~email" with
  "check your email client"

Fixes anthropics#71

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@XinySu8
Copy link

XinySu8 commented Mar 2, 2026

Thanks for opening this PR for #71.

One concern: in bio-research/commands/start.md, replacing categories with specific server names (PubMed/ChEMBL/BioRender, etc.) could be misleading for users who haven’t connected those MCP servers. Would you consider making these explicitly examples (e.g., “Literature (e.g., PubMed, bioRxiv)”) or switching to generic wording like “your literature database / your chemical database” while keeping the ~~category reference internally?

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.

Bug: ~~placeholder strings shown verbatim to users in bio-research, enterprise-search, and sales commands

2 participants