Skip to content

docs: explain ~~placeholder convention inline instead of linking ../../CONNECTORS.md (#1381) - #1389

Closed
viwe-monai wants to merge 1 commit into
anthropics:mainfrom
viwe-monai:docs/inline-connector-placeholder-explanation
Closed

viwe-monai wants to merge 1 commit into
anthropics:mainfrom
viwe-monai:docs/inline-connector-placeholder-explanation

Conversation

@viwe-monai

Copy link
Copy Markdown

Fixes #1381

Problem

66 skills across 13 plugins opened with a pointer to ../../CONNECTORS.md. In this repo that resolves to the plugin root, where CONNECTORS.md lives — but on claude.ai each skill folder is installed without the plugin root, so the link resolves to nothing and the ~~category placeholders go unexplained.

Strategy chosen (least invasive that fully fixes it)

  • 68 skills — replaced the dead link with a two-line inline explanation of the ~~category placeholder convention (wording adapted from the CONNECTORS.md "How tool references work" section), so the convention is always explained where it appears, with no per-skill copies to keep in sync.
  • 2 skills — productivity/skills/start and productivity/skills/update: the line is removed entirely, since these skills use no ~~ placeholders (per the note in the issue).

The issue lists 66 skills / 13 plugins; the repo also has the same dead link in 4 partner-built/zoom-plugin skills (debug-zoom, plan-zoom-integration, plan-zoom-product, setup-zoom-mcp), so those are covered by the same inline fix — 70 files changed in total. (Those 4 also use no ~~ placeholders; happy to drop the line there too if maintainers prefer.)

Verification

  • grep -rn '\.\./\.\./CONNECTORS\.md' after the change → 0 matches anywhere in the repo.
  • git diff --numstat: 68 files 2 insertions, 1 deletion (inline replacement) + 2 files 2 deletions (line removal). No other content touched.
  • Spot-checked diffs across productivity, design, data, legal, finance, engineering, and partner-built/zoom-plugin.

…./CONNECTORS.md

Skills linked to ../../CONNECTORS.md, which resolves to the plugin root in
this repo but to nothing when plugins are installed on claude.ai (skill
folders are installed without the plugin root), leaving the ~~category
placeholders unexplained.

- 68 skills: replace the dead link with a two-line inline explanation of
  the `~~category` placeholder convention (wording adapted from the
  CONNECTORS.md "How tool references work" section).
- productivity/skills/start and productivity/skills/update: remove the
  line entirely — these skills use no ~~ placeholders (anthropics#1381).

Fixes anthropics#1381
@github-actions

Copy link
Copy Markdown
Contributor

Thanks for your interest! This repo only accepts contributions from Anthropic team members. If you'd like to submit a plugin to the marketplace, please submit your plugin here.

@github-actions github-actions Bot closed this Oct 24, 2026
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.

Skills link to ../../CONNECTORS.md, which isn't installed when plugins are added on claude.ai

1 participant