Env Troubleshoot

What it does

When your agent uses it

• Tasks that involve Containers

Example prompts

• “/env-troubleshoot”

Requirements

• Python 3
• Node.js
• Docker

What it can do on your machine

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

  • npm
  • docker
  • node
  • python
  • pip
  • npx
  • nvm

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

• Network

  No URLs in SKILL.md. Its commands use npm, docker, pip and npx, 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

Env Troubleshoot loads about 900 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 281 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~56

When it runs · the whole SKILL.md, loaded when a task matches

~900

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

• NoteRuns commands with sudoSKILL.md:45

  ACCES permission denied` | 权限不足 | 1. 不要用 sudo 装 npm 2. 检查 npm 全局目录权限 3. 用 nvm 管理 node |

• NoteMentions a .env fileSKILL.md:56

  | 环境变量相关错误 | .env 缺失或变量缺失 | 1. `cp .env.example .env` 2. 对照检查必填变量 |

• WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:84

  | SSH key 权限 | `chmod 600 ~/.ssh/id_*`，`chmod 700 ~/.ssh` |

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 312362115/claude at commit 2d4fa49, republished under its MIT licence (© 312362115). 281 words, ~900 tokens.

name

env-troubleshoot

description

环境排障技能：结构化排查开发环境问题。 覆盖 Node.js/Python/Docker 环境、依赖安装失败、端口冲突、权限问题等。 触发词：装不上、跑不起来、报错了、环境问题、npm install 失败、Docker 起不来、端口被占。 触发场景：依赖安装失败、服务启动报错、Docker 构建失败、环境变量缺失、版本冲突。 即使用户没有说"环境问题"，只要是开发环境配置/启动相关的报错，都应触发此技能。

version

1.0.0

last_updated

2026-04-08

repository

https://github.com/312362115/claude

环境报错
  │
  ├─ 1. 读错误信息（完整读，不跳过）
  ├─ 2. 分类问题
  ├─ 3. 按类别排查
  ├─ 4. 修复并验证
  └─ 5. 记录（如果是常见问题，建议加到项目 docs/guides/）

# Node.js 环境
node -v && npm -v              # 版本检查
npm ls --depth=0               # 已安装依赖
npm cache clean --force        # 清理缓存
npx envinfo                    # 环境信息汇总

# Python 环境
python --version && pip --version
which python                   # 确认解释器路径
pip list                       # 已安装包
python -m venv .venv && source .venv/bin/activate  # 创建虚拟环境

# 端口/进程
lsof -i :3000                  # 查端口占用
kill -9 <PID>                  # 杀进程

# Docker
docker ps -a                   # 所有容器
docker logs <container>        # 容器日志
docker system df               # 磁盘占用
docker system prune            # 清理

# 通用
echo $PATH                     # PATH 检查
env | grep -i proxy            # 代理设置

© 312362115, 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 skills/env-troubleshoot of 312362115/claude.

Open the folder on GitHubat commit 2d4fa49