playground
Skill216 starsChanged 17 days agoApache-2.0View on GitHub
Mounts an agent against this tree's build in an isolated home and a fresh fixture, then measures it, probes it, or adds it, before any release publishes that build.
- Pipes a download into a shell
- Reads credentials
- Installs packages
15 other projects use a version of this.
Adopted by
Most recently taken up by
- azizkadi84000-hash/claude-skillstheir own version, first seen Nov 15, 2026
- ChainGPT-org/chaingpt-claude-skilltheir own version, first seen Nov 1, 2026
- sunnysxg/claude_skillstheir own version, first seen Oct 20, 2026
- davidanthonyn/claude-skillstheir own version, first seen Oct 20, 2026
- anthropics/claude-plugins-officialtheir own version, first seen Oct 13, 2026
- vuetifyjs/vuetifytheir own version, first seen Oct 8, 2026
Used with
Projects with it also use stripe-best-practices.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
OpenAISkillstripe-best-practices
Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial accounts, integration surfaces (Checkout, Payment Element), and migrating from deprecated Stripe APIs. Use when building, modifying, or reviewing any Stripe integration — including accepting payments, building marketplaces, integrating Stripe, processing payments, setting up subscriptions, or creating connected accounts.
Also in 3 projects that use this
Other versions15 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 15
- anthropics/claude-plugins-official★ 47ksame name
- vuetifyjs/vuetify★ 41ksame name
- cline/skills★ 35same name
- skateddu/claude-code-python-setup★ 28same name
- jorgeasaurus/agent-skills★ 14same name
- ChainGPT-org/chaingpt-claude-skill★ 7same name
- HK-hub/AgentSkills★ 6same name
- kvivek0591/claude-code-skills★ 2same name
- gcapodeferro02/my-agent-skills★ 1same name
- azizkadi84000-hash/claude-skills★ 0same name
5 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository24 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- architectureSkill
- blind-reviewSkill
- calibrateSkill
- cdpSkill
- dashboardSkill
- engineeringSkill
- ingestSkill
- mcp-catalogSkill
- refineSkill
- simulateSkill
- specializeSkill
- testingSkill
- uiSkill
- writerSkill
- lagune-charterSkill
- lagune-detectSkill
- lagune-hardenSkill
- lagune-planSkill
- lagune-proveSkill
- lagune-repairSkill
- laguneSkill
- lagune-specializeSkill
- lagune-verifySkill
The file
We split this skill into the rules it gives an agent
5 rules. 0 are common, 4 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 14 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 18
Mount it: When its CLI is missing, give the user its install command from "Supported agents", step by step, and wait.
- Distinctive: line 28
Free models only: When an agent runs a prompt itself, it picks a free model or the agent's Auto choice.
- Distinctive: line 30
Nothing escapes: Every write lands in the isolated home or the project.
- Very specific: line 37
Create the keys file with bash scripts/playground/agents.sh keys, then let the owner fill it:
- Distinctive: line 77
Create a bare repository whose default branch holds a placeholder and whose plugin branch holds the bundle.
“Common” is measured: kept by at least 6 in 10 of the 14 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Playgrounds
A playground runs one agent against this tree's build, in an isolated home and a fresh copy of a fixture, so a session measures exactly what a release would publish for that agent, before the release exists. Two scripts drive it: scripts/playground/agents.sh for every agent but Claude Code, and scripts/playground/mount.sh for Claude Code. Their helpers live in tools/playground/.
When invoked
- Pick the agent from the arguments. Without one, list the supported agents as a numbered list and ask which to measure, probe, or add.
- Mount it. When its CLI is missing, give the user its install command from "Supported agents", step by step, and wait.
- Run what needs no session yourself: the mount, the report, the server switch, and headless checks. For everything that needs the user's session, hand over the exact steps: the command to start it, what to type, what to approve, and when to stop.
- Read the verdict from the report, and the agent's transcript in the isolated home when the report alone does not explain it.
- Report back each measurement's verdict, with its evidence.
Ground rules
- The keys file is the owner's alone. No agent ever reads, opens, searches, parses, or inspects it in any way, not even to check whether a key is set. This rule is absolute and has no exception. Only the playground loads it, into the agent it starts.
- Free models only. When an agent runs a prompt itself, it picks a free model or the agent's Auto choice.
- Nothing approved up front. A session allows only the rules its measurement needs, and never a flag that approves every tool.
- Nothing escapes. Every write lands in the isolated home or the project. The owner's own configuration, global git settings, and sign-ins stay untouched.
Set up once
- Install the agent's CLI, as "Supported agents" lists, or point
LAGUNE_PLAYGROUND_BINat one outsidePATH. - Create the keys file with
bash scripts/playground/agents.sh keys, then let the owner fill it:LAGUNE_BYOK_BASE_URL,LAGUNE_BYOK_API_KEY, andLAGUNE_BYOK_MODEL: one OpenAI-compatible endpoint that each mount preselects as "Playground" for Factory Droid, Grok Build, Qwen Code, OpenCode, and Pi. Pick a model that supports tool calls, since a free one may be overloaded and a weak one may never load the tools an agent defers.GEMINI_API_KEY: Gemini CLI and Antigravity CLI.CURSOR_API_KEY: Cursor CLI, whose sign-in reaches for the macOS keychain, which the isolated home hides.
Everything lives in ~/.lagune-playground, or wherever LAGUNE_PLAYGROUND points: each agent's isolated home, where sign-ins stay across mounts, its project, and its measurements. The agent starts with a clean environment, as outside any editor: only PATH, the user and shell, the terminal, the locale, proxy and certificate settings, and the keys file reach it.
Measure an agent
- Mount:
bash scripts/playground/agents.sh <agent> mount, ormount sign-into use the agent's own sign-in instead of the keys file's BYOK. It builds the tree, installs what the release would publish into the isolated home, copies the fixture into a fresh project, and prints the command to type. - Run:
bash scripts/playground/agents.sh <agent> runstarts a session in the project. Type the printed command and answer each prompt as it comes. The verdict needs only the first engine call. - Report:
bash scripts/playground/agents.sh <agent> reportprints each engine call's route, the exact command for npx, and the verdict. - Server off:
bash scripts/playground/agents.sh <agent> server offtakes the plugin's server out and starts a new measurement, whichrunandreportrepeat.server onputs it back.reportkeeps every measurement until the next mount.
| Server | Expected first engine call |
| On | A call to a tool whose name ends in lagune_read or lagune_write, or a tool search followed by one |
| Off | The pinned npx --yes lagune@<version> followed by the tool's prefix, such as read validate charter |
The pinned npx call reaches this tree's build through a local registry the playground serves at that version, never the release npm still serves under it.
Claude Code
bash scripts/playground/mount.sh [fixture] installs the plugin from a local marketplace into the project under the repository's ignored playground folder, with a unique version on every mount and this repository's CLAUDE.md excluded. It then serves the pinned build from a local registry outside the project, which the project's settings point npx at, until Ctrl+C, so start Claude Code there from another terminal, with the owner's account. The fixture is image-upload-service by default, or template-toolkit.
Headless checks
run hands its arguments to the agent's CLI, so an agent can run a session itself through the CLI's print mode, or list what the CLI sees, such as its models or plugins. A headless run denies whatever would ask, which ends the turn, so it measures only what its allow rules let through: pass the rules a check needs for that session alone. When a behavior shows only in the interactive interface, as Antigravity CLI's first message does, the owner runs it, and the agent reads the transcript the agent keeps in the isolated home.
Probes
The copilot and kimi playgrounds install a stub server instead of the plugin, since neither agent can carry the engine yet. After mount and run, ask the session to call the where tool of the lagune-probe server, and report shows the folder, variables, environment, and MCP roots that server received. Kimi Code installs the stub inside the session, with the /plugins install command mount prints.
Test an install from GitHub before a release
- Assemble the bundle with
bash scripts/plugins/bundle.sh <plugin> <empty folder>. - Create a bare repository whose default branch holds a placeholder and whose plugin branch holds the bundle.
- Point the agent at it:
- With a
file://URL or a commit SHA, where the agent takes one, asmountdoes for Factory Droid and Grok Build. - Through the GitHub URL, where the agent accepts nothing else: map
https://github.com/wellwelwel/lagune, with and without.git, to the bare repository throughurl.<bare repository>.insteadOfin the isolated home's git config. The agent clones what the release would publish, and nothing reaches GitHub.
- With a
- A step the agent's own servers run, such as Cursor's marketplace re-index, still fetches from github.com. Pair it with a commit GitHub already serves.
Supported agents
| Agent | <agent> | Kind | CLI | Model |
| Claude Code | (mount.sh) | Acceptance | claude | The owner's account |
| Factory Droid | droid | Acceptance | droid, from npm install --global @factory/cli | BYOK or its sign-in |
| Grok Build | grok | Acceptance | grok, from npm install --global @xai-official/grok | BYOK or its sign-in |
| Gemini CLI | gemini | Acceptance | gemini, from npm install --global @google/gemini-cli | A paid GEMINI_API_KEY or a Code Assist Standard or Enterprise sign-in |
| Qwen Code | qwen | Acceptance | qwen, from npm install --global @qwen-code/qwen-code | BYOK or its sign-in |
| OpenCode | opencode | Acceptance | opencode, from opencode-ai (1.x) or @opencode/cli (2.x) | BYOK or its sign-in |
| Pi | pi | Acceptance | pi, from npm install --global @earendil-works/pi-coding-agent | BYOK or its sign-in |
| Cursor CLI | cursor | Acceptance | agent, from curl https://cursor.com/install -fsS | bash | CURSOR_API_KEY |
| Antigravity CLI | antigravity | Acceptance | agy, from curl -fsSL https://antigravity.google/cli/install.sh | bash | GEMINI_API_KEY or a Google sign-in |
| GitHub Copilot CLI | copilot | Probe | copilot, from npm install --global @github/copilot | The owner's account, through /login |
| Kimi Code | kimi | Probe | kimi, from npm install --global @moonshot-ai/kimi-code | The owner's account, through /login |
For manual tests and debugging, prefer OpenCode with BYOK, and without it, Grok Build, then Antigravity CLI, then Cursor CLI. Antigravity CLI loads the plugin's tools only once a session's first message runs, so send its command after any other message.
Add an agent
- Learn how the agent loads a plugin: where it installs from, the file that declares an MCP server, which variables it expands there, the folder it starts the server in, how it names and allows tools, and where it keeps its settings, sign-in, and transcripts.
- Teach the agents script about it: its CLI and how to install it, the variables that keep its configuration inside the isolated home, how
mountinstalls what the release publishes for it (its bundle, a bare repository's branch, or the package from the local registry), whereserver offfinds its server declaration, the form of its charter command, and how its model is chosen. An agent that cannot carry the engine yet gets a probe instead, with a stub plugin in the form it installs. - Confirm the isolation: with a marker file, check that a session writes nothing outside the isolated home.
- Measure it with the server on and off.
- List it under "Supported agents".
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

