fix: bare URLs in SKILL.md to stop malformed-link traffic - #243
Conversation
GA records 404-shaped requests for '/docs/development-guide/api-changelog).' - a markdown link immediately followed by a period. SKILL.md's primary consumers are LLM agents reading raw markdown, and naive linkification includes the ').' in the URL. Bare URLs with no trailing punctuation are unambiguous for both humans and agents.
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
There was a problem hiding this comment.
Pull request overview
This PR updates the Nevermined payments skill markdown (skills/nevermined-payments/SKILL.md) to prevent “malformed link” traffic caused by consumers mis-linkifying markdown links followed immediately by sentence punctuation (e.g., .../api-changelog).).
Changes:
- Replaced two
[text](url).markdown link patterns with bare URLs to avoid)/.being captured as part of the URL. - Ensured the affected URLs are now the final token on their respective lines (no trailing punctuation).
Agents copy the URLs they read: nevermined.ai/docs is the canonical host (both domains already emit it as canonical), so printed links should teach it. MCP endpoint URLs (docs.nevermined.app/mcp) are functional service addresses and deliberately untouched.
aaitor
left a comment
aaitor
left a comment
There was a problem hiding this comment.
Approving — a clean data-hygiene fix. Replacing the two [text](url). patterns with trailing-punctuation-free bare URLs is the right call for a skill file whose primary consumers are LLM agents reading raw markdown (exactly the population that mis-linkifies …api-changelog).).
Verification I ran
- Read the full diff (
skills/nevermined-payments/SKILL.md, +2/-2) and both post-change lines in context. - Resolved both new bare URLs —
https://nevermined.ai/docs/development-guide/api-changelog→ 200,https://nevermined.ai/docs/getting-started/get-your-api-key→ 200. Mintlify link-rot + vale checks green. - Leanness: 2-line change, nothing to cut.
One thing worth noting (non-blocking): the changelog line didn't just lose its link punctuation — the host also changed from docs.nevermined.app/docs/development-guide/api-changelog (which still 200s) to nevermined.ai/docs/development-guide/api-changelog. That's a good canonicalization onto the proxied marketing domain where the GA property lives, but the description frames it purely as a punctuation fix, so flagging that it's also a deliberate host change. No action needed.
GA on the website property records requests for the malformed URL
…/development-guide/api-changelog).— a markdown link immediately followed by sentence punctuation, mis-linkified by whatever consumed it.Both instances of the
[text](url).pattern inskills/nevermined-payments/SKILL.mdare replaced with bare URLs and no trailing punctuation. This file's primary consumers are LLM agents reading raw markdown (it's a skill file), which is exactly the population that produces these malformed links; bare URLs are unambiguous for humans and agents alike.Part of the Growth Analytics epic's data-hygiene story (nevermined.ai-website#195).
🤖 Generated with Claude Code