Agent skill

Tlon Workflow Doctor

by tloncorp in tloncorp/tlon-apps

A skill your agent uses when setting up a machine for mobile agent work on this repository, when the tlon-workflow skill's prerequisite check fails, or when stim, agent-device, eas-cli, gh, or their…

MITAuto-check: notes

Install Tlon Workflow Doctor

skills CLI
$ npx skills add tloncorp/tlon-apps --skill tlon-workflow-doctor -a claude-code

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

GitHub CLI
$ gh skill install tloncorp/tlon-apps tlon-workflow-doctor --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/tloncorp/tlon-apps.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tlon-workflow-doctor .claude/skills/tlon-workflow-doctor && 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
tlon-workflow-doctor
GitHub stars
107
Token cost
~1.2k tokens
SKILL.md length
639 words
Files
2
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when setting up a machine for mobile agent work on this repository, when the tlon-workflow skill's prerequisite check fails, or when stim, agent-device, eas-cli, gh, or their…

  • Setting up a machine for mobile agent work on this repository
  • SKILL.md covers What it checks and When a line stays fix
  • Runs JavaScript scripts from its folder; calls gh, nvm and node; needs DEFAULT_TLON_LOGIN_PASSWORD
  • The tlon-workflow skills prerequisite check fails

What it does

Tlon Workflow Doctor is an agent skill from tloncorp/tlon-apps. Use when setting up a machine for mobile agent work on this repository, when the tlon-workflow skill's prerequisite check fails, or when stim, agent-device, eas-cli, gh, or their skills are missing, outdated, or installed under an old name.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

The repository describes itself as: Native, web clients, and server for Tlon Messenger. The licence is MIT.

When your agent uses it

  • Setting up a machine for mobile agent work on this repository
  • The tlon-workflow skills prerequisite check fails
  • Their skills are missing
  • Installed under an old name

Example prompts

  • “/tlon-workflow-doctor”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit d89f6e2. 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

    Ships script files (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • gh
    • nvm
    • node
    • expo
    • eas
    • npx
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use gh, npx and npm, 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 these keys or tokens, usually read from environment variables:

    • DEFAULT_TLON_LOGIN_PASSWORD

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

Context cost

Tlon Workflow Doctor loads about 1.2k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 639 words of instructions outside code blocks.

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

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.

  • NoteMentions a .env fileSKILL.md:17
    's copy: that is where `apps/tlon-mobile/.env.local` lives, and `stim worktree warm` copies it from there.
  • NoteMentions a .env fileSKILL.md:32
    the source checkout's `apps/tlon-mobile/.env.local` | nothing; they are credentials (see the tlon-workflow skill, Sign

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 tloncorp/tlon-apps at commit d89f6e2, republished under its MIT licence (© tloncorp). 639 words, ~1,163 tokens.

Download SKILL.mdSave it as .claude/skills/tlon-workflow-doctor/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
tlon-workflow-doctor
description
Use when setting up a machine for mobile agent work on this repository, when the tlon-workflow skill's prerequisite check fails, or when stim, agent-device, eas-cli, gh, or their skills are missing, outdated, or installed under an old name.

Tlon workflow doctor

One script checks everything the mobile agent loop depends on, and installs what it can.

bash
node .agents/skills/tlon-workflow-doctor/check.mjs          # report
node .agents/skills/tlon-workflow-doctor/check.mjs --fix    # install and re-check

Run it unsandboxed, from the repository root (the path above is relative to it). It exits 0 when every line is ok or note, and 1 while any line says fix.

Unsandboxed because gh auth status cannot reach the keyring inside a shell sandbox and reports a false not authenticated. It always inspects the source checkout, even when run from a worktree's copy: that is where apps/tlon-mobile/.env.local lives, and stim worktree warm copies it from there.

What it checks

LineRequirement--fix does
gh2.99.0 or newer (the --attach upload flag), authenticatednothing; prints the install or gh auth login line
nodethe major version in .nvmrc, both for the node on PATH (which stim and eas run on) and for the one running this script; on Node 26, expo config cannot load app.config.ts, and eas reports only that simulator:availability printed no JSONnothing; prints the nvm use && nvm alias default line
stimthe stim package, 1.1.0 or newer, resolved first on PATH; a note when npm has a newer oneinstalls or upgrades stim; uninstalls stim-cli when that is what resolves
stim portsthe ports command, which the loop's web and Cosmos steps take their ports fromupgrades stim
stim remotestim ios --remote, which runs the loop's devices on EAS Simulator, from stim 1.9.0 (the first release that gives each worktree's EAS session its own name)upgrades stim
easeas-cli installed, logged in, and EAS Simulator enabled for the project's account; when simulator:availability prints no JSON, the line carries eas's stderrinstalls eas-cli, unless it was expo config that failed; eas login and account access need a person
stim skillstim skill in ~/.agents/skills or this reponpx skills add appandflow/stim -g -y
agent-deviceinstalled, 0.21.13 or newer (the loop was last verified with agent-device 0.21.14 and stim 1.10.0; older pairs lost Fast Refresh and broke the session lease); a note when npm has a newer onenpm install -g agent-device
agent-device skillagent-device skill in ~/.agents/skills or this reponpx skills add callstack/agent-device -g -y
ship loginDEFAULT_SHIP_LOGIN_URL + DEFAULT_SHIP_LOGIN_ACCESS_CODE, or DEFAULT_TLON_LOGIN_EMAIL + DEFAULT_TLON_LOGIN_PASSWORD, in the source checkout's apps/tlon-mobile/.env.localnothing; they are credentials (see the tlon-workflow skill, Sign in)
stim doctorno cost finding in apps/tlon-mobile; one is a note with its fix, since it slows builds without blocking themnothing; prints each finding and its fix
Show full SKILL.md (233 more words)Show less

--fix only installs global npm and Homebrew packages and adds skills under ~/.agents/skills. It touches nothing in this repository.

It deliberately does not run stim doctor --fix, which writes .claude/settings.local.json -- your own agent permission configuration -- and can delete generated Android .cxx directories. Both are decisions for the person running this, not repairs to apply on a tool's say-so. The stim doctor line prints what it found and the fix each finding names, as a note: a slow cache costs minutes, not the task.

When a line stays fix

The line carries the exact command. Three that need a person: gh auth login and eas login take the user's own credentials, EAS Simulator access is granted to the Expo account rather than installed, and the ship login values are credentials nobody but the user should type.

node can outlast its own fix. nvm use changes only the shell it runs in, and an agent session keeps the PATH of whatever launched it, so a session started on another Node stays on it even when nvm's default alias already matches .nvmrc. Restart the session from a shell on the pinned version.

The ship login note is worth clearing even though it is only a note. Without those two variables every reproduction that needs a signed-in app stalls on a 2FA code an unattended run cannot read. With them, sign-in is four taps and no typing.

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

Files

SKILL.md and 1 other file in .agents/skills/tlon-workflow-doctor of tloncorp/tlon-apps.

  • SKILL.md
  • check.mjs

Open the folder on GitHubat commit d89f6e2

Compare with similar skills

Tlon Workflow Doctor 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.

Tlon Workflow Doctor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tlon Workflow Doctor this skilltloncorp/tlon-apps107—~1.2kAutomated safety check: NotesMIT
Manage Settingsasgeirtj/system_prompts_leaks69k—~3.1kAutomated safety check: PassCC0-1.0
Doctorsuperset-sh/superset15k—~434Automated safety check: PassCustom licence
Warp Settings Editorwarpdotdev/warp65k1 repos~675Automated safety check: PassAGPL-3.0
Muse Code Product Doctorasgeirtj/system_prompts_leaks69k—~3.5kAutomated safety check: PassCC0-1.0
Doctorbrycewang-stanford/Auto-Empirical-Research-Skills4.6k—~2.4kAutomated safety check: PassCustom licence

Similar skills

  • Manage Settings

    asgeirtj/system_prompts_leaks

    Any explicit Muse Code setting question or change (model, reasoning effort, /settings) requires a silent readskill call for bundled:manage-settings as FIRST ACTION—no assistant text or other tool…

    69k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Doctor

    superset-sh/superset

    Diagnose and fix Superset problems such as connection failures, offline hosts, terminals not attaching, auth or update issues.

    15k GitHub stars~434 tokensUpdated today
    Auto-check passed
  • Warp Settings Editor

    warpdotdev/warp

    Finds and changes Warp application settings by searching a bundled JSON schema and editing the matching TOML settings file at the right nesting depth.

    65k GitHub starsUsed in 1 repo~675 tokens
    Productivity & AutomationAuto-check passed
  • Muse Code Product Doctor

    asgeirtj/system_prompts_leaks

    Diagnoses a Muse Code installation's own failures from binary and session evidence, instead of treating the report as an ordinary repository bug.

    69k GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Doctor

    brycewang-stanford/Auto-Empirical-Research-Skills

    System diagnostics and health checks for Diverga plugin. An agent skill from brycewang-stanford/Auto-Empirical-Research-Skills.

    4.6k GitHub stars~2.4k tokensUpdated 6 days ago
    Auto-check passed
  • How to build a settings page in the Warp desktop client so widgets, page titles and settings search behave correctly, and which common mistakes to avoid.

    65k GitHub starsUsed in 1 repo~4.5k tokens
    Frontend & DesignAuto-check passed

More from tloncorp/tlon-apps

  • Mobile QA

    tloncorp/tlon-apps

    Run a mobile QA checklist on a physical Android device over adb for tlon-apps, then triage what fails into fixes.

    107 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Tlon

    tloncorp/tlon-apps

    Read Tlon activity and message history; manage workspaces (Tlon groups), channels, Markdown notes, shared Bucket files, contacts, profiles, settings, and channel hooks; expose content publicly; send…

    107 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Tlon Workflow

    tloncorp/tlon-apps

    A skill your agent uses when taking a Tlon Messenger task from a fresh worktree to a merged pull request: reproducing or fixing something in the iOS, Android or web app, validating it on a…

    107 GitHub stars~8.9k tokensUpdated today
    Auto-check: notes
  • Verify

    tloncorp/tlon-apps

    Verify tlon-apps web UI changes end-to-end with a single local ship + vite dev server (lighter than the full playwright-dev rig)

    107 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Tlon Product Guide

    tloncorp/tlon-apps

    Answer questions about Tlon, Urbit, Tlon Messenger, Tlonbot, and OpenClaw — what they are, how they work, and how to use them.

    107 GitHub stars~11k tokensUpdated today
    Auto-check passed

Questions about Tlon Workflow Doctor

What does Tlon Workflow Doctor do?

A skill your agent uses when setting up a machine for mobile agent work on this repository, when the tlon-workflow skill's prerequisite check fails, or when stim, agent-device, eas-cli, gh, or their…. Tlon Workflow Doctor is an agent skill from tloncorp/tlon-apps. Use when setting up a machine for mobile agent work on this repository, when the tlon-workflow skill's prerequisite check fails, or when stim, agent-device, eas-cli, gh, or their skills are missing, outdated, or installed under an old name.

When should I use Tlon Workflow Doctor?

Tlon Workflow Doctor fits situations like: setting up a machine for mobile agent work on this repository; the tlon-workflow skills prerequisite check fails; their skills are missing; installed under an old name.

How do I install Tlon Workflow Doctor in Claude Code?

Run `npx skills add tloncorp/tlon-apps --skill tlon-workflow-doctor -a claude-code`. Or copy the skill folder (.agents/skills/tlon-workflow-doctor in tloncorp/tlon-apps) into .claude/skills/tlon-workflow-doctor in your project. Claude Code loads it when a task matches its description.

How do I install Tlon Workflow Doctor in Codex?

Run `npx skills add tloncorp/tlon-apps --skill tlon-workflow-doctor -a codex`. Or copy the skill folder (.agents/skills/tlon-workflow-doctor in tloncorp/tlon-apps) into .agents/skills/tlon-workflow-doctor in your project. Codex loads it when a task matches its description.

Can I use Tlon Workflow Doctor 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 tloncorp/tlon-apps --skill tlon-workflow-doctor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tlon-workflow-doctor, .gemini/skills/tlon-workflow-doctor, .github/skills/tlon-workflow-doctor and .opencode/skills/tlon-workflow-doctor in your project.

What does Tlon Workflow Doctor need to run?

Going by SKILL.md and its folder, Tlon Workflow Doctor needs JavaScript for the scripts in its folder, the command-line tools its instructions call (gh, nvm, node, expo, eas and npx) and credentials named DEFAULT_TLON_LOGIN_PASSWORD. Our summary lists: Node.js.

Does Tlon Workflow Doctor access the network?

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

Is Tlon Workflow Doctor safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Tlon Workflow Doctor use?

Tlon Workflow Doctor 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 Tlon Workflow Doctor use?

About 1.2k tokens (SKILL.md is roughly 4.7k 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 Tlon Workflow Doctor?

Skills that share tags, products or a category with Tlon Workflow Doctor: Manage Settings (asgeirtj/system_prompts_leaks, 69k stars), Doctor (superset-sh/superset, 15k stars), Warp Settings Editor (warpdotdev/warp, 65k stars) and Muse Code Product Doctor (asgeirtj/system_prompts_leaks, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tlon Workflow Doctor?

tloncorp (a GitHub organization) maintains it in tloncorp/tlon-apps, which has 107 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 10, 2026.

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