Agent skill

Remote Task

by imran31415 in imran31415/kube-coder

Launch a Claude task on a remote kube-coder workspace, check task status, or attach to a running session.

MITAuto-check: notes

Install Remote Task

skills CLI
$ npx skills add imran31415/kube-coder --skill remote-task -a claude-code

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

GitHub CLI
$ gh skill install imran31415/kube-coder remote-task --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/imran31415/kube-coder.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/remote-task .claude/skills/remote-task && 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
remote-task
GitHub stars
388
Token cost
~1.3k tokens
SKILL.md length
388 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Launch a Claude task on a remote kube-coder workspace, check task status, or attach to a running session.

  • Works in 5 steps: If $ARGUMENTS is "status" — List all tasks → If $ARGUMENTS starts with "attach" —… → If $ARGUMENTS starts with "output" —… → …
  • The user wants to send work to a remote workspace pod
  • SKILL.md covers Prerequisites, How It Works, Commands and API Reference, plus 1 more section
  • Calls kubectl, python3 and curl

What it does

Remote Task is an agent skill from imran31415/kube-coder. Launch a Claude task on a remote kube-coder workspace, check task status, or attach to a running session. Use when the user wants to send work to a remote workspace pod.

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 works with tmux. The repository describes itself as: helm chart for a isolated dev coding environment pod in kubernetes. The licence is MIT.

When your agent uses it

  • The user wants to send work to a remote workspace pod

Example prompts

  • “/remote-task”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash, Read, Grep

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. If $ARGUMENTS is "status" — List all tasks
  2. If $ARGUMENTS starts with "attach" — Show how to attach to a task
  3. If $ARGUMENTS starts with "output" — Show task output
  4. If $ARGUMENTS starts with "kill" — Kill a task
  5. Otherwise — Launch a new task

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • kubectl
    • python3
    • curl
    • make

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

  • Network

    No URLs in SKILL.md. Its commands use kubectl and curl, 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

Remote Task loads about 1.3k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 388 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep

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 imran31415/kube-coder at commit f5da764, republished under its MIT licence (© imran31415). 388 words, ~1,345 tokens.

Download SKILL.mdSave it as .claude/skills/remote-task/SKILL.md (or your agent's skills folder).
name
remote-task
description
Launch a Claude task on a remote kube-coder workspace, check task status, or attach to a running session. Use when the user wants to send work to a remote workspace pod.
allowed-tools
Bash, Read, Grep
user-invocable
true
argument-hint
prompt or "status" or "attach TASK_ID"

Remote Task Skill

Launch Claude tasks on remote kube-coder workspace pods, check their status, or view output.

Prerequisites

This skill requires:

  1. kubectl access to the cluster
  2. A running workspace pod (deployed via make deploy-<user>)
  3. An API token generated on the pod

How It Works

The workspace pod runs a Python HTTP server on port 6080 that exposes a Claude Task API. Tasks launch as interactive tmux sessions running claude — users can attach to approve permissions and provide input.

Commands

Based on $ARGUMENTS, perform ONE of the following:

1. If $ARGUMENTS is "status" — List all tasks
bash
# Port-forward if needed
kubectl port-forward -n coder svc/ws-imran 6080:6080 &
PF_PID=$!
sleep 2

TOKEN=$(kubectl exec -n coder $(kubectl get pods -n coder -l app=ws-imran -o jsonpath='{.items[0].metadata.name}') -c ide -- cat /home/dev/.claude-tasks/.api-token 2>/dev/null)

curl -s "http://localhost:6080/api/claude/tasks" \
  -H "Authorization: Bearer $TOKEN" | python3 -m json.tool

kill $PF_PID 2>/dev/null

Display the results as a formatted table showing: task_id, status, prompt (truncated), and created_at (as relative time).

2. If $ARGUMENTS starts with "attach" — Show how to attach to a task

Extract the task ID from the arguments. Then tell the user:

  • Open the dashboard at the workspace URL and click "Attach" on the task
  • Or run: kubectl exec -it -n coder <pod> -c ide -- tmux attach-session -t claude-<task_id>

Also show recent output:

bash
kubectl exec -n coder <pod> -c ide -- tmux capture-pane -t claude-<TASK_ID> -p -S -30
3. If $ARGUMENTS starts with "output" — Show task output

Extract the task ID from the arguments. Run:

bash
kubectl exec -n coder <pod> -c ide -- tmux capture-pane -t claude-<TASK_ID> -p -S -50
4. If $ARGUMENTS starts with "kill" — Kill a task

Extract the task ID from the arguments. Run:

bash
kubectl port-forward -n coder svc/ws-imran 6080:6080 &
PF_PID=$!
sleep 2

TOKEN=$(kubectl exec -n coder $(kubectl get pods -n coder -l app=ws-imran -o jsonpath='{.items[0].metadata.name}') -c ide -- cat /home/dev/.claude-tasks/.api-token 2>/dev/null)

curl -s -X DELETE "http://localhost:6080/api/claude/tasks/<TASK_ID>" \
  -H "Authorization: Bearer $TOKEN" | python3 -m json.tool

kill $PF_PID 2>/dev/null
5. Otherwise — Launch a new task

The $ARGUMENTS is the prompt to send to the remote Claude. Execute:

bash
# Ensure port-forward is active
lsof -ti:6080 | xargs kill 2>/dev/null
kubectl port-forward -n coder svc/ws-imran 6080:6080 &
PF_PID=$!
sleep 2

# Get the API token from the pod
POD=$(kubectl get pods -n coder -l app=ws-imran -o jsonpath='{.items[0].metadata.name}')
TOKEN=$(kubectl exec -n coder $POD -c ide -- cat /home/dev/.claude-tasks/.api-token 2>/dev/null)

# If no token exists, create one
if [ -z "$TOKEN" ]; then
  TOKEN=$(kubectl exec -n coder $POD -c ide -- python3 -c "
import secrets, os
d = '/home/dev/.claude-tasks'
os.makedirs(d, mode=0o700, exist_ok=True)
t = secrets.token_urlsafe(36)
with open(os.path.join(d, '.api-token'), 'w') as f: f.write(t)
os.chmod(os.path.join(d, '.api-token'), 0o600)
print(t)
")
fi

# Create the task
curl -s -X POST "http://localhost:6080/api/claude/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d "$(python3 -c "import json; print(json.dumps({'prompt': $(python3 -c "import json,sys; print(json.dumps(sys.argv[1]))" "$ARGUMENTS"), 'workdir': '/home/dev'}))")" \
  | python3 -m json.tool

kill $PF_PID 2>/dev/null

After launching, wait a few seconds and check the tmux pane to confirm the task started:

bash
sleep 8
kubectl exec -n coder $POD -c ide -- tmux capture-pane -t claude-<TASK_ID> -p -S -20

Report the task_id and tmux_session name back to the user so they know how to attach.

Show full SKILL.md (134 more words)Show less

API Reference

All endpoints are under http://localhost:6080/api/claude/ (via port-forward) and require Authorization: Bearer <token> header.

MethodEndpointDescription
GET/api/claude/tasksList all tasks
POST/api/claude/tasksCreate task. Body: {"prompt": "...", "workdir": "/home/dev"}
GET/api/claude/tasks/{id}Get task details + recent output
GET/api/claude/tasks/{id}/output?tail=NGet task output (last N lines)
POST/api/claude/tasks/{id}/messageSend follow-up. Body: {"prompt": "..."}
DELETE/api/claude/tasks/{id}Kill a task
POST/api/claude/tasks/{id}/prepare-terminalPrepare terminal for one-click attach

Notes

  • Tasks run as interactive Claude sessions in tmux. The user can attach to approve file writes or provide input.
  • The workspace must have Claude authenticated (run claude then /login in the pod terminal if needed).
  • GitHub App credentials are auto-configured if set in the Helm values — private repo access works out of the box.
  • The default workspace is ws-imran in the coder namespace. Adjust pod labels/names for other users.

© imran31415, 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/remote-task of imran31415/kube-coder.

Open the folder on GitHubat commit f5da764

Compare with similar skills

Remote Task 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.

Remote Task compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Remote Task this skillimran31415/kube-coder388—~1.3kAutomated safety check: NotesMIT
1passwordtrpc-group/trpc-agent-go1.8k13 repos~656Automated safety check: PassApache-2.0
CodeGraph Agent Evalcolbymchenry/codegraph73k—~950Automated safety check: PassMIT
Tmuxtrpc-group/trpc-agent-go1.8k23 repos~868Automated safety check: PassApache-2.0
CodexBar Live QAsteipete/CodexBar22k—~1.2kAutomated safety check: PassMIT
Agent Feature ReproductionQwenLM/qwen-code28k—~1.5kAutomated safety check: PassApache-2.0

Similar skills

  • 1password

    trpc-group/trpc-agent-go

    Set up and use 1Password CLI (op). An agent skill from trpc-group/trpc-agent-go.

    1.8k GitHub starsUsed in 13 repos~656 tokens
    AI & LLM EngineeringAuto-check passed
  • CodeGraph Agent Eval

    colbymchenry/codegraph

    Benchmarks how much CodeGraph helps a coding agent on a real repository, comparing runs with and without it for a chosen local or published version.

    73k GitHub stars~950 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Tmux

    trpc-group/trpc-agent-go

    Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.

    1.8k GitHub starsUsed in 23 repos~868 tokens
    Data & AnalyticsAuto-check passed
  • CodexBar Live QA

    steipete/CodexBar

    Runs live QA for the CodexBar app: provider usage matrix checks through its packaged CLI, config validation and menu checks, with 1Password-backed credentials handled safely.

    22k GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed
  • Reproduces a feature from Codex or Claude Code in Qwen Code by running the reference agent under capture, reading the traces, then implementing matching behavior.

    28k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Codex Plugin QA

    code-yeongyu/oh-my-openagent

    Tests the omo Codex plugin in an isolated CODEX_HOME with a local mock model, proving hooks fired through app-server notifications without touching ~/.codex.

    70k GitHub stars~1.9k tokensUpdated today
    Testing & QAAuto-check passed

More from imran31415/kube-coder

All 8 skills in this repo
  • Kc Entrypoint Change

    imran31415/kube-coder

    Safely edit the workspace pod's boot scripts (start.sh, the entrypoint/ssh-server configmaps) in kube-coder.

    388 GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check: notes
  • Kc Issue

    imran31415/kube-coder

    Spin up an isolated agent to work a GitHub issue of kube-coder or any other repo checked out in the workspace.

    388 GitHub stars~1.9k tokensUpdated 4 days ago
    Auto-check: notes
  • Kc Screenshot

    imran31415/kube-coder

    Capture desktop + mobile, dark + light screenshots of the kube-coder dashboard SPA for visual QA of a UI change.

    388 GitHub stars~870 tokensUpdated 4 days ago
    Auto-check: notes
  • Kc Ship PR

    imran31415/kube-coder

    Commit local changes and open a pull request against kube-coder from inside a workspace pod.

    388 GitHub stars~2k tokensUpdated 4 days ago
    Auto-check: notes
  • Kc Preflight

    imran31415/kube-coder

    Run kube-coder's full CI suite locally before pushing — helm lint + unit tests, server.py tests, dashboard + controller SPA builds + vitest, and shell syntax checks.

    388 GitHub stars~1k tokensUpdated 4 days ago
    Auto-check: notes
  • Kc Scope PR

    imran31415/kube-coder

    Scope a kube-coder change before you open or update a PR — what the diff actually touches, which tests reach it, what the change made worse, and what is left untested.

    388 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check: notes

Works with

Questions about Remote Task

What does Remote Task do?

Launch a Claude task on a remote kube-coder workspace, check task status, or attach to a running session. Remote Task is an agent skill from imran31415/kube-coder. Launch a Claude task on a remote kube-coder workspace, check task status, or attach to a running session.

When should I use Remote Task?

Remote Task fits situations like: the user wants to send work to a remote workspace pod.

How do I install Remote Task in Claude Code?

Run `npx skills add imran31415/kube-coder --skill remote-task -a claude-code`. Or copy the skill folder (.claude/skills/remote-task in imran31415/kube-coder) into .claude/skills/remote-task in your project. Claude Code loads it when a task matches its description.

How do I install Remote Task in Codex?

Run `npx skills add imran31415/kube-coder --skill remote-task -a codex`. Or copy the skill folder (.claude/skills/remote-task in imran31415/kube-coder) into .agents/skills/remote-task in your project. Codex loads it when a task matches its description.

Can I use Remote Task 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 imran31415/kube-coder --skill remote-task -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/remote-task, .gemini/skills/remote-task, .github/skills/remote-task and .opencode/skills/remote-task in your project.

What does Remote Task need to run?

Going by SKILL.md and its folder, Remote Task needs the command-line tools its instructions call (kubectl, python3, curl and make). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash, Read, Grep.

Does Remote Task access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Remote Task safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Remote Task use?

Remote Task 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 Remote Task use?

About 1.3k tokens (SKILL.md is roughly 5.4k 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 Remote Task?

Skills that share tags, products or a category with Remote Task: 1password (trpc-group/trpc-agent-go, 1.8k stars), CodeGraph Agent Eval (colbymchenry/codegraph, 73k stars), Tmux (trpc-group/trpc-agent-go, 1.8k stars) and CodexBar Live QA (steipete/CodexBar, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Remote Task?

imran31415 (a GitHub user) maintains it in imran31415/kube-coder, which has 388 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 3, 2026.

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