Agent skill

Hosted Studio Debug

by genlayerlabs in genlayerlabs/genlayer-studio

Debug GenLayer Studio deployments via ArgoCD CLI. An agent skill from genlayerlabs/genlayer-studio.

MITAuto-check passedDevOps & Cloud

Install Hosted Studio Debug

skills CLI
$ npx skills add genlayerlabs/genlayer-studio --skill hosted-studio-debug -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install genlayerlabs/genlayer-studio hosted-studio-debug --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/genlayerlabs/genlayer-studio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/hosted-studio-debug .claude/skills/hosted-studio-debug && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hosted-studio-debug
GitHub stars
180
Token cost
~1.3k tokens
SKILL.md length
227 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Debug GenLayer Studio deployments via ArgoCD CLI. An agent skill from genlayerlabs/genlayer-studio.

  • Tasks that involve Container orchestration
  • SKILL.md covers Workload Manifests, Prerequisites, Full Status Check and Quick Commands, plus 4 more sections
  • Calls argocd, kubectl and uvicorn
  • Tasks that involve Deployment

What it does

Hosted Studio Debug is an agent skill from genlayerlabs/genlayer-studio. Debug GenLayer Studio deployments via ArgoCD CLI

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Container orchestration, Deployment and Debugging. It works with Argo CD. The repository describes itself as: An interactive sandbox to explore the GenLayer Protocol. The licence is MIT.

When your agent uses it

  • Tasks that involve Container orchestration
  • Tasks that involve Deployment
  • Tasks that involve Debugging

Example prompts

  • “/hosted-studio-debug”

What it can do on your machine

Read from SKILL.md and the folder at commit c940729. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • argocd
    • kubectl
    • uvicorn

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use kubectl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hosted Studio Debug loads about 1.3k tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 227 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from genlayerlabs/genlayer-studio at commit c940729, republished under its MIT licence (© genlayerlabs). 227 words, ~1,255 tokens.

Download SKILL.mdSave it as .claude/skills/hosted-studio-debug/SKILL.md (or your agent's skills folder).
name
hosted-studio-debug
description
Debug GenLayer Studio deployments via ArgoCD CLI

Hosted Studio Debug Skill

Debug GenLayer Studio deployments via ArgoCD CLI.

Workload Manifests

Kubernetes manifests are in sibling repo ../devexp-apps-workload (assume by default, ask user if not found):

devexp-apps-workload/workload/
├── dev/           # studio-dev, rally-studio-dev
├── stg/           # studio-stg
├── prd/           # studio-prd, rally-studio-prd

Each contains Deployments, Services, Ingresses, ExternalSecrets managed by ArgoCD.

Prerequisites

  • Logged into ArgoCD CLI
  • Access to target cluster

Full Status Check

To get complete visibility into Studio status, check all components across all replicas:

bash
# 1. Overall app health
argocd app get <app>-workload

# 2. List all pods and their status
argocd app resources <app>-workload --kind Pod

# 3. Check consensus worker logs (all 4 replicas in prd)
argocd app logs <app>-workload --name studio-consensus-worker --tail 500 2>&1 | grep -iE "(error|exception|timeout|failed)"

# 4. Check JSON-RPC logs (all 2 replicas in prd)
argocd app logs <app>-workload --name studio-jsonrpc --tail 500 2>&1 | grep -iE "(error|exception|timeout|failed)"

# 5. Check webdriver logs
argocd app logs <app>-workload --name studio-webdriver --tail 200 2>&1 | grep -iE "(error|exception|crash)"

Quick Commands

bash
# Check app health
argocd app get <app>-workload

# List all resources (pods, deployments, services, etc.)
argocd app resources <app>-workload

# List all pods with their status
argocd app resources <app>-workload --kind Pod

# Tail consensus worker logs (aggregates from ALL replicas)
argocd app logs <app>-workload --name studio-consensus-worker --tail 200

# Tail JSON-RPC logs (aggregates from ALL replicas)
argocd app logs <app>-workload --name studio-jsonrpc --tail 200

# Check for errors across all replicas
argocd app logs <app>-workload --name studio-consensus-worker --tail 500 2>&1 | grep -i error
argocd app logs <app>-workload --name studio-jsonrpc --tail 500 2>&1 | grep -i error

Multi-Replica Log Access

Important: The argocd app logs --name <container> command automatically aggregates logs from ALL pod replicas. This ensures full visibility across the entire deployment.

bash
# Get logs from all consensus worker replicas (production has 4)
argocd app logs <app>-workload --name studio-consensus-worker --tail 500

# Get logs from all JSON-RPC replicas (production has 2)
argocd app logs <app>-workload --name studio-jsonrpc --tail 500

# Get logs from a specific pod (if needed for isolation)
argocd app logs <app>-workload --pod <pod-name> --tail 200

# List pods first to get pod names
argocd app resources <app>-workload --kind Pod

Common Issues

Transaction Timeouts

Consensus worker timeouts usually mean GenVM Manager is unresponsive. Check all 4 workers in production:

bash
# Check for GenVM timeouts across all consensus worker replicas
argocd app logs <app>-workload --name studio-consensus-worker --tail 500 2>&1 | grep -E "(timeout|SocketTimeoutError|127.0.0.1:3999)"

# Empty stdout = GenVM never started
argocd app logs <app>-workload --name studio-consensus-worker --tail 500 2>&1 | grep "stdout=''"

Root cause: GenVM Manager (genvm-modules manager --port 3999) becomes unresponsive. Fix: Worker restart (auto or manual) restarts GenVM Manager.

Key files:

  • backend/node/genvm/origin/base_host.py:463 - where timeouts occur
  • backend/node/base.py - Manager.create() spawns GenVM
  • backend/consensus/worker_service.py - worker startup/health
Pod Restarts
bash
# Check restart timestamps in logs
argocd app logs <app>-workload --name studio-consensus-worker --tail 500 2>&1 | grep -E "(Started|Uvicorn running)"

# Via kubectl
kubectl get pods -n <namespace> -o wide
kubectl get events -n <namespace> --sort-by='.lastTimestamp'
External API Failures

Contracts calling external APIs (Twitter, etc.) through proxies:

bash
# Check for HTTP errors in contract execution
argocd app logs <app>-workload --name studio-consensus-worker --tail 500 2>&1 | grep -E "(HTTP|fetch|proxy|api)"

Environment Apps

EnvAppNamespace
devstudio-dev-workloadstudio-dev
stgstudio-stg-workloadstudio-stg
prdstudio-prd-workloadstudio-prd
rally-prdrally-studio-prd-workloadrally-studio-prd

Components

ComponentPurposePrd ReplicasCommon Issues
studio-consensus-workerTx processing4Timeouts, GenVM crashes
studio-jsonrpcRPC API2DB connections
studio-webdriverBrowser sandbox1Memory, crashes
database-migrationSchema updates1 (job)Lock contention

Note: When debugging, always check logs from ALL replicas to get complete visibility. The argocd app logs --name <container> command handles this automatically.

© genlayerlabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/hosted-studio-debug of genlayerlabs/genlayer-studio.

Open the folder on GitHubat commit c940729

Compare with similar skills

Hosted Studio Debug next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hosted Studio Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hosted Studio Debug this skillgenlayerlabs/genlayer-studio180—~1.3kAutomated safety check: PassMIT
Frontend Forge Extension Operationskubesphere/kubesphere17k—~3.2kAutomated safety check: PassCustom licence
Frontend Forge FI Operationskubesphere/kubesphere17k—~1.3kAutomated safety check: PassCustom licence
GitOps with ArgoCD and Fluxwshobson/agents40k11 repos~1.5kAutomated safety check: PassMIT
Deploying Applicationsancoleman/ai-design-components526—~3.1kAutomated safety check: PassMIT
Implementing Gitopsancoleman/ai-design-components526—~2.9kAutomated safety check: PassMIT

Similar skills

  • Runs the lifecycle of FrontendExtension resources in a Kubernetes cluster: create, rebuild, package, publish, unpublish, delete and debug stuck states.

    17k GitHub stars~3.2k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Frontend Forge FI Operations

    kubesphere/kubesphere

    Operates FrontendIntegration resources and the frontend-forge extension with kubectl: create from YAML, update, enable, disable, delete, inspect and troubleshoot builds.

    17k GitHub stars~1.3k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Sets up GitOps continuous delivery for Kubernetes with ArgoCD or Flux, covering installation, repository layout, sync policies, progressive delivery and secrets.

    40k GitHub starsUsed in 11 repos~1.5k tokens
    DevOps & CloudAuto-check passed
  • Deploying Applications

    ancoleman/ai-design-components

    Deployment patterns from Kubernetes to serverless and edge functions.

    526 GitHub stars~3.1k tokensUpdated 10 mo ago
    DevOps & CloudAuto-check passed
  • Implementing Gitops

    ancoleman/ai-design-components

    Implement GitOps continuous delivery for Kubernetes using ArgoCD or Flux.

    526 GitHub stars~2.9k tokensUpdated 10 mo ago
    DevOps & CloudAuto-check passed
  • Deploy

    ww-w-ai/bkit-claude-code

    Deploy feature to target environment (dev/staging/prod) with level-based strategy.

    600 GitHub stars~1.2k tokensUpdated 10 days ago
    DevOps & CloudAuto-check: notes

More from genlayerlabs/genlayer-studio

All 10 skills in this repo
  • Cloudflare CLI

    genlayerlabs/genlayer-studio

    Debug and manage Cloudflare DNS, cache, and proxy settings using flarectl

    180 GitHub stars~692 tokensUpdated 7 days ago
    Auto-check passed
  • Create PR

    genlayerlabs/genlayer-studio

    Create GitHub pull requests by analyzing branch diff and following the project template

    180 GitHub stars~635 tokensUpdated 7 days ago
    Auto-check passed
  • Discord Community Feedback

    genlayerlabs/genlayer-studio

    Monitor Discord community channel for user-reported bugs and issues

    180 GitHub stars~786 tokensUpdated 7 days ago
    Auto-check passed
  • Integration Tests

    genlayerlabs/genlayer-studio

    Setup Python virtual environment and run integration tests with gltest

    180 GitHub stars~1.1k tokensUpdated 7 days ago
    Auto-check passed
  • Linear Issue Fixer

    genlayerlabs/genlayer-studio

    Fetch the most urgent Linear issue with tag "studio" and size XS, then fix it

    180 GitHub stars~2.2k tokensUpdated 7 days ago
    Auto-check passed
  • Sentry Issue Fixer

    genlayerlabs/genlayer-studio

    Fetch, analyze, fix Sentry issues, run tests, and create PRs

    180 GitHub stars~2k tokensUpdated 7 days ago
    Auto-check passed

Works with

Categories

Questions about Hosted Studio Debug

What does Hosted Studio Debug do?

Debug GenLayer Studio deployments via ArgoCD CLI. An agent skill from genlayerlabs/genlayer-studio. Hosted Studio Debug is an agent skill from genlayerlabs/genlayer-studio.

When should I use Hosted Studio Debug?

Hosted Studio Debug fits situations like: tasks that involve Container orchestration; tasks that involve Deployment; tasks that involve Debugging.

How do I install Hosted Studio Debug in Claude Code?

Run `npx skills add genlayerlabs/genlayer-studio --skill hosted-studio-debug -a claude-code`. Or copy the skill folder (.claude/skills/hosted-studio-debug in genlayerlabs/genlayer-studio) into .claude/skills/hosted-studio-debug in your project. Claude Code loads it when a task matches its description.

How do I install Hosted Studio Debug in Codex?

Run `npx skills add genlayerlabs/genlayer-studio --skill hosted-studio-debug -a codex`. Or copy the skill folder (.claude/skills/hosted-studio-debug in genlayerlabs/genlayer-studio) into .agents/skills/hosted-studio-debug in your project. Codex loads it when a task matches its description.

Can I use Hosted Studio Debug in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add genlayerlabs/genlayer-studio --skill hosted-studio-debug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hosted-studio-debug, .gemini/skills/hosted-studio-debug, .github/skills/hosted-studio-debug and .opencode/skills/hosted-studio-debug in your project.

What does Hosted Studio Debug need to run?

Going by SKILL.md and its folder, Hosted Studio Debug needs the command-line tools its instructions call (argocd, kubectl and uvicorn).

Does Hosted Studio Debug access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hosted Studio Debug safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hosted Studio Debug use?

Hosted Studio Debug is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hosted Studio Debug use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hosted Studio Debug?

Skills that share tags, products or a category with Hosted Studio Debug: Frontend Forge Extension Operations (kubesphere/kubesphere, 17k stars), Frontend Forge FI Operations (kubesphere/kubesphere, 17k stars), GitOps with ArgoCD and Flux (wshobson/agents, 40k stars) and Deploying Applications (ancoleman/ai-design-components, 526 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hosted Studio Debug?

genlayerlabs (a GitHub organization) maintains it in genlayerlabs/genlayer-studio, which has 180 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 30, 2026.

Source: genlayerlabs/genlayer-studio on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.