english/.opencode/skills/use-mcp/SKILL.md

name, description, argument-hint, metadata

name	description	argument-hint	metadata
ck:use-mcp	Utilize MCP server tools with intelligent discovery and execution.	[task]	author version claudekit 1.0.0

MCP Tool Execution

Execute MCP operations via Gemini CLI to preserve context budget.

Execution Steps

1. Execute task via Gemini CLI (using stdin pipe for MCP support):

   # IMPORTANT: Use stdin piping, NOT -p flag (deprecated, skips MCP init)
   # Read model from .opencode/.ck.json: gemini.model (default: gemini-3-flash-preview)
   echo "$ARGUMENTS. Return JSON only per GEMINI.md instructions." | gemini -y -m <gemini.model>
   

2. Fallback to mcp-manager subagent (if Gemini CLI unavailable):

   • Use mcp-manager subagent to discover and execute tools
   • If the subagent got issues with the scripts of ck:mcp-management skill, use ck:mcp-builder skill to fix them
   • DO NOT create ANY new scripts
   • The subagent can only use MCP tools if any to achieve this task
   • If the subagent can't find any suitable tools, just report it back to the main agent to move on to the next step

Important Notes

• MUST use stdin piping - the deprecated -p flag skips MCP initialization
• Use -y flag to auto-approve tool execution
• GEMINI.md auto-loaded: Gemini CLI automatically loads GEMINI.md from project root, enforcing JSON-only response format
• Parseable output: Responses are structured JSON: {"server":"name","tool":"name","success":true,"result":<data>,"error":null}

Anti-Pattern (DO NOT USE)

# BROKEN - deprecated -p flag skips MCP server connections!
gemini -y -m <gemini.model> -p "..."

# ALSO BROKEN - --model flag with -p
gemini -y -p "..." --model gemini-3-flash-preview