Skip to content

Conversation

@gurdasnijor
Copy link

@gurdasnijor gurdasnijor commented Dec 9, 2025

Add "Run in Smithery" Badge

This badge lets users discover and try your Claude Skills directly from GitHub.

Badge Preview

Run in Smithery

What's Smithery?

Smithery is a platform where developers discover and install Claude Skills and MCP servers. Adding this badge helps users find and install your 262 skills with one click.


Feel free to adjust the placement or close this PR if you're not interested. Thanks for building awesome skills!

Summary by CodeRabbit

  • Documentation
    • Enhanced visibility of the Smithery "Run in Smithery" badge by repositioning it prominently near the top of the documentation.

✏️ Tip: You can customize this high-level summary in your review settings.

@vercel
Copy link

vercel bot commented Dec 9, 2025

@gurdasnijor is attempting to deploy a commit to the Goos Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai
Copy link

coderabbitai bot commented Dec 9, 2025

Warning

.coderabbit.yaml has a parsing error

The CodeRabbit configuration file in this repository has a parsing error and default settings were used instead. Please fix the error(s) in the configuration file. You can initialize chat with CodeRabbit to get help with the configuration file.

💥 Parsing errors (1)
Validation error: Invalid regex pattern for base branch. Received: "release/**" at "reviews.auto_review.base_branches[2]"
⚙️ Configuration instructions
  • Please see the configuration documentation for more information.
  • You can also validate your configuration using the online YAML validator.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Walkthrough

A "Run in Smithery" badge and link were added to the README.md file immediately after the title section, improving visibility of the integration feature without altering functionality or documentation content.

Changes

Cohort / File(s) Summary
Documentation updates
README.md
Added Smithery "Run in Smithery" badge/link near the top of the file after the title

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

🐰 A badge so bright, now takes its place,
Right after the title—a prominent space!
Smithery calls with a link so grand,
No code was harmed across the land. ✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Add "Run in Smithery" badge' accurately reflects the main change in the pull request, which adds a Smithery badge to the README.md file.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 42907a4 and a1bfe79.

📒 Files selected for processing (1)
  • README.md (1 hunks)

Comment on lines +3 to +4
[![Run in Smithery](https://smithery.ai/badge/skills/modu-ai)](https://smithery.ai/skills?ns=modu-ai&utm_source=github&utm_medium=badge)

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Verify badge image and destination URLs are valid

echo "Testing badge image URL..."
curl -s -o /dev/null -w "Badge image: %{http_code}\n" \
  "https://smithery.ai/badge/skills/modu-ai"

echo "Testing destination URL..."
curl -s -o /dev/null -w "Destination link: %{http_code}\n" \
  "https://smithery.ai/skills?ns=modu-ai&utm_source=github&utm_medium=badge"

Repository: modu-ai/moai-adk

Length of output: 176


🌐 Web query:

Smithery badge skills modu-ai

💡 Result:

Do you mean a specific product or site? I can search for:

  • "Smithery" badges/skills,
  • "modu-ai" or "Modu AI" badges,
  • or a "Smithery badge" on a platform like ModLearn/Modu?

Which one should I look up?


🌐 Web query:

Smithery.ai badge endpoint documentation

💡 Result:

Smithery badge image endpoint

  • URL pattern: https://smithery.ai/badge/ (used as an image src). [examples]. [1][2]
  • You can append query params such as ?refresh=1234 to force a refreshed image (seen in examples). [3]
  • Badges are typically embedded as an linking to the server page (e.g. https://smithery.ai/server/… ). [2][1]

Sources:

  1. Smithery badge used in READMEs (example: https://smithery.ai/badge/youtube-watchlater). [turn1search7].
  2. README examples linking badges to server pages (Glama/various MCP repos). [turn1search1].
  3. Example showing ?refresh query param on a smithery badge URL. [turn3search4].

🌐 Web query:

Smithery.ai skills namespace endpoint

💡 Result:

Which exactly do you need — the Smithery API URL for listing skills by namespace, or the Skills Protocol method for filtering by namespace?

  • If you mean Smithery's registry API for servers (similar resource for skills), see the Smithery registry endpoint: https://registry.smithery.ai/servers (example usage). [1]

  • If you mean the Skills Protocol discovery method that supports a namespace filter, use the JSON-RPC list_skills method with the "namespace" param (POST list_skills; detail/limit/cursor available). Example request/response described in the Skills Protocol docs. [2]

Sources:
[1] Smithery — List/Search servers (registry example).
[2] Skills Protocol — Discovery Methods / list_skills (namespace filter).


🌐 Web query:

site:smithery.ai modu-ai skills

💡 Result:

I couldn't find any pages on smithery.ai matching "modu-ai" or "modu‑ai skills." Smithery.ai does host MCP (Model Context Protocol) tools/skills and a registry of MCP servers you can browse for available skills and integrations. See Smithery's homepage/registry and documentation for how to add MCP skills. [1][2]

Sources:
[1] Smithery AI — platform/registry overview.
[2] Smithery.ai docs / examples describing MCP skills and endpoints.


🌐 Web query:

Smithery badge destination URL format example

💡 Result:

Typical Smithery badge URLs use a badge image and a destination link formed from the resource slug. Examples:

References:
[1] Example badge usages.
[2] Example server badge link.
[3] Example protocol page.


🌐 Web query:

Smithery "badges/skills" endpoint

💡 Result:

I couldn't find public Smithery API docs for a "badges/skills" endpoint. I did find a mention of Smithery (smithery.ai) as an MCP provider (used to supply "skills" to other apps) but no official endpoint reference or docs for badges/skills. See Shapes docs referencing Smithery. [1]

If you can, please share:

  • a link or screenshot where you saw "badges/skills", or
  • whether you mean smithery.ai, an MCP server you run, or a different "Smithery" product.

I’ll re-search the exact source and return the endpoint details once you provide that or confirm which Smithery you mean. [1]


Badge URLs do not match Smithery's documented endpoint patterns.

The badge image URL (https://smithery.ai/badge/skills/modu-ai) and destination URL (https://smithery.ai/skills?ns=modu-ai&utm_source=github&utm_medium=badge) do not follow Smithery's standard badge format. Documented patterns use:

  • Badge image: https://smithery.ai/badge/<slug> (e.g., https://smithery.ai/badge/jina-ai-mcp-server)
  • Destination: https://smithery.ai/server/<slug> or https://smithery.ai/protocol/<slug>

The /skills endpoint and /badge/skills/ path are not found in Smithery documentation. Correct the URLs to match the documented pattern or verify these endpoints exist before merging.

🤖 Prompt for AI Agents
In README.md around lines 3-4, the badge image URL and destination use
non‑documented paths (/badge/skills/ and /skills); update them to Smithery's
documented patterns by changing the image src to
https://smithery.ai/badge/<slug> and the link href to either
https://smithery.ai/server/<slug> or https://smithery.ai/protocol/<slug>
(replace <slug> with the actual resource slug for this project), or
alternatively verify that the current /skills endpoints exist and adjust to
match documentation; after editing, confirm both the badge image renders and the
link navigates to the correct Smithery page.

@gurdasnijor
Copy link
Author

Thanks for considering this PR. After reviewing our approach, we've decided to focus on personal repositories for now. Closing this PR - no action needed on your end. Apologies for the noise!

@gurdasnijor gurdasnijor closed this Dec 9, 2025
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