local-plugin-surfaces

Diagnose why scaffolded plugins are missing from Grok Bot Marketplace listings.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/JYeswak/grok_bot_playground --skill local-plugin-surfaces-jyeswak
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: local-plugin-surfaces
Source: https://github.com/JYeswak/grok_bot_playground/tree/main/plugin/skills/local-plugin-surfaces
Command: npx skills add https://github.com/JYeswak/grok_bot_playground --skill local-plugin-surfaces-jyeswak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Operators scaffold a plugin (like gb-receipt) and then cannot find it in Grok Bot Settings → Plugins, leading to confusion about whether the install failed. This Skill explains that Marketplace never lists folders on disk and helps you identify which plugin surface you are actually looking at. ## Core Features & Use Cases - Surface identification: Distinguishes Grok Bot Marketplace, the Yours tab, Cursor local plugins (~/.cursor/plugins/local), cloud computer paths, and the separate Grok Build CLI (~/.grok/plugins). - Correct install path guidance: Walks through the real add flow — Marketplace → Add → confirm under Yours → enable per Bot — plus the private skill path via SKILL.md and the Yours toggle. - Validation checks: Provides proof commands like gb inventory plugins, gb plugins show NAME, and manifest checks for .cursor-plugin/plugin.json. - Use Case: After Create Plugin writes /workspace/plugins/gb-receipt and you copy it to ~/.cursor/plugins/local on your Mac, use this Skill to confirm why Marketplace search still shows nothing and what the correct next click is. ## Quick Start Ask the assistant to explain why the gb-receipt plugin does not appear in Grok Bot Settings → Plugins after scaffolding and copying it to the local Cursor plugins folder.

Frequently Asked Questions about local-plugin-surfaces

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why is my plugin not showing in Grok Bot Marketplace?▼

Grok Bot Marketplace only lists plugins published to the xAI/Cursor catalog, never folders on disk. A scaffolded plugin like gb-receipt stays invisible there until it is officially listed and you click Add; this is expected behavior, not a bug.

How do I install a local plugin in Cursor?▼

Copy the plugin folder containing .cursor-plugin/plugin.json into ~/.cursor/plugins/local/<name> on the Mac where Cursor runs, then reload Cursor. This makes it visible to Cursor only, not to Grok Bot.app.

Does copying a plugin folder to Grok Bot register it?▼

No. Grok Bot.app has no folder picker or load-from-folder control; copying directories or restarting the app never calls ListUserPluginInstalls. Plugins are added only through Settings → Plugins → Marketplace → Add, then enabled per Bot under Yours.

What is the difference between Grok Bot plugins and Grok Build CLI plugins?▼

Grok Build CLI uses ~/.grok/plugins/ and is a different product from Grok Bot.app. A plugin placed in the Grok Build directory will never appear in Grok Bot Settings → Plugins, and vice versa.

How do I add a private skill to a Grok Bot?▼

Ask the Bot to save a SKILL.md, then open the Yours tab and enable it on that specific Bot, then invoke it with /name in chat. Installs are account-wide but enabling is per Bot, and pasting the SKILL.md into a chat turn does not attach it.