Skip to content

meta: carry the category phrase and tags in the strings marketplaces display - #6

Merged
TueJon merged 2 commits into
mainfrom
feature/discoverability-metadata
Aug 6, 2026
Merged

meta: carry the category phrase and tags in the strings marketplaces display#6
TueJon merged 2 commits into
mainfrom
feature/discoverability-metadata

Conversation

@TueJon

@TueJon TueJon commented Aug 5, 2026

Copy link
Copy Markdown
Owner

Why

Measured 2026-08-05: a Google search for webmcp agent skill surfaces no webmcpify result
at all, and on the brand query webmcpify the top ten are third-party directories —
webmcpify.at itself does not appear. Those directories therefore are the description
most humans and AI answers get, and they get it wrong: mcpservers.org files this skill as
"Webmcpify (agent Skill) MCP Server", awesomeskills.dev calls it an "Antigravity
agent skill"
, and three others credit github/awesome-copilot rather than TueJon.

They read SKILL.md frontmatter and the manifest descriptions. Neither carried the phrase
"WebMCP agent skill", and SKILL.md had no tags: at all — so a crawler that wants a
category has to invent one.

Diagnosis: devlog/history/generic/2026-08-05-webmcpify-search-visibility-diagnosis.md ·
lesson: knowledge/generic/webmcpify-search-visibility-root-cause.md (workbench).

What changed

  • SKILL.md: tags: (webmcp, agent-skill, document.modelContext, browser-agents,
    web-development, chrome) and the category phrase at the front of the description
    trigger phrases ("webmcpify", "add WebMCP", "expose app actions to AI agents")
    are unchanged.
  • package.json + skill.json descriptions, and the README <h1>: same phrase.
  • AGENTS.md: records both constraints — why the phrase must stay, and that the
    frontmatter is plain YAML, so no : in an unquoted scalar (the first draft of this
    change used "WebMCP agent skill: make a web app…" and would have broken every
    consumer's parser; caught by parsing the frontmatter, not by eye).

Verification

npm run check → typecheck + syntaxcheck + 17/17 tests. Frontmatter parsed with
PyYAML: all five keys resolve, tags is a list. Versions untouched, so manifest parity
holds.

Not in this PR (needs Jonas)

The v0.3.0 release tag (several directories gate on stars/releases; this repo has 2 stars
and no tag), corrections/recrawls at the directories themselves, and the
webmcpify.at/webmcp-agent-skill/ page that pairs with this — TueJon/webmcpify.at#8.

…display

Directory listings that outrank webmcpify.at for its own brand name describe the
skill wrongly — one files it as an "MCP Server", another as an "Antigravity agent
skill". They read SKILL.md frontmatter and the manifest descriptions, and neither
carried the phrase "WebMCP agent skill" nor any tags to categorize by.

Adds tags to SKILL.md, puts the phrase at the front of the SKILL.md, package.json
and skill.json descriptions and in the README h1, and records both constraints in
AGENTS.md so the next edit does not quietly drop them.

npm run check: 17/17.
@TueJon TueJon self-assigned this Aug 5, 2026
@TueJon
TueJon merged commit b1e0335 into main Aug 6, 2026
1 check passed
@TueJon
TueJon deleted the feature/discoverability-metadata branch August 6, 2026 14:10
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.

1 participant