secret-card-setup

Guides placement of API keys into masked plugin variable cards or Bot secret cards.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? API keys pasted into chat, code, logs, or notes become permanently exposed in transcripts and shared environments. This Skill enforces a disciplined workflow that puts every credential into the one masked destination that keeps it out of the conversation record. ## Core Features & Use Cases - Destination selection: Routes each credential to the correct card — the plugin variable card for connector configuration or the Bot secret card for a Bot's own scripts. - Leak prevention and rotation handling: Interrupts attempted key pastes, treats any secret spoken in chat as burned, and triggers a ROTATE finding with owner and date metadata. - Safe verification: Confirms credentials work through read-only calls (whoami, list, get) instead of echoing or printing values, and requires wrapper scripts to live in bot-independent directories like /home/box/mcp-wrappers/. - Use Case: A connector needs an organization API key. The Skill names the ${VAR}, hands the human the exact click path to the plugin variable card, places the wrapper script outside any agent-scoped secrets tree, and verifies with a read-only call — the value never touches chat. ## Quick Start Ask the assistant to set up an API key for a connector using the secret card setup workflow, naming the variable and the plugin that consumes it.

Frequently Asked Questions about secret-card-setup

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

FAQPage Schema
How do I securely add an API key to a Bot or plugin?▼

Enter the key on the plugin variable card for connector configuration or the Bot secret card for the Bot's own scripts. The human performs the masked card entry; scripts reference the value only by its ${VAR} name, never the raw key.

What happens if an API key is pasted into chat?▼

A key pasted into chat is treated as compromised because transcripts are durable and shared with every Bot on the account. The workflow stops, declares the key burned, and requires the owner to rotate it before continuing.

How do I verify a credential works without exposing it?▼

Run one read-only call that only succeeds when the credential resolves, such as a whoami, list, or get request. Never echo, cat, or print the variable, since that copies the secret into logs.

Where should wrapper scripts that read credentials be placed?▼

Place them in a bot-independent directory such as /home/box/mcp-wrappers/, never under agents/<id>/secrets/. Agent-scoped paths break when that Bot is deleted, leaving connectors failing with untraceable missing-file errors.

Can a Bot enter or read the secret value itself?▼

No. Card entry is a human-only click path with no write API, and a Bot claiming it entered a key is fabricating. The Bot never reads, requests, or quotes the raw value; a masked entry it cannot read is the intended state.

Are credentials isolated per Bot on a shared account?▼

No. Every Bot on the account shares one cloud computer, so any credential on that filesystem is reachable by all Bots. If a key must not be usable by another Bot, it must not be placed on that computer at all.