Home / black-yt / skills · wsl-bash-windows/SKILL.md · GitHub

wsl-bash-windows skillA

wsl-bash-windows is agent-read markdown (skill) from black-yt/skills: 当在 Windows + WSL 项目中运行 shell 命令、排查 bash/沙箱启动失败、处理 /mnt/c 或 /mnt/d 路径、读取用户贴来的 Windows 图片/临时截图路径、执行 curl/git/npm/python 等 Linux 命令、排查 GitHub/Hugging Face push、DNS、代理或 token 环境差异、避免误切到 PowerShell/cmd/Windows Node/browser fetch 时使用。.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# WSL Bash on Windows

## 文件导航

| 序号 | 文件内容概览 | 关键词 | 触发时机 | 文件路径 |
| --- | --- | --- | --- | --- |
| 1 | 记录 WSL bash 中执行 GitHub 与 Hugging Face push 的安全流程,覆盖非交互/交互 shell token 差异、一次性 HTTP Basic header、DNS 解析失败、坏代理、沙箱网络、`.git/index.lock` 提权、LFS/Xet 边界和 push 后状态验证。 | WSL push、GitHub、Hugging Face、HF、git push、DNS、getent hosts、proxy、HTTP_PROXY、bash -ic、token env、http.extraheader、credential.helper、LFS、Xet、index.lock、Read-only file system、ahead 1 | 在 WSL 项目中 push GitHub 或 Hugging Face 前必须读取;排查 `Could not resolve host`、代理端口不可达、`You are not authorized to push to this repo` 前必须读取;发现 token 只在交互 shell 中存在、普通 shell 网络失败、`.git/index.lock` 写入失败、HF LFS/Xet 或大文件边界不清时必须读取 | [references/push-dns.md](references/push-dns.md) |

## 核心判断

- 看到 `cwd` 或项目路径是 `/mnt/c/...`、`/mnt/d/...`,默认这是 WSL 项目。
- 在 WSL 项目里优先使用 WSL 的 `bash` 和 Linux 命令链,不要绕到 PowerShell、cmd、Windows 侧 `node.exe`、浏览器 `fetch`。
- 如果普通执行失败,先判断是不是沙箱启动失败,而不是误判为“系统没有 bash”。
- Codex 桌面端可能出现“UI 显示 WSL workspace,但实际执行器在 Windows 侧直接找 `/bin/bash`”的混合坏状态;这时不能继续改文件。
- 有些失败只是普通沙箱权限不足或没有提权,不代表 WSL bash 坏了;例如写 `.git/index.lock`、访问受限路径、联网命令或安装依赖时失败,应优先申请提权/原生 WSL 执行。
- 典型沙箱失败包括:

```text
Unable to spawn ... codex-linux-sandbox because it doesn't exist
```
…

Read the whole file at its exact version.

How to install

Latest version
mdr add black-yt/skills/wsl-bash-windows@git:20260615.f9474ca
Exact content
mdr add black-yt/skills/wsl-bash-windows@sha256:4141caf6c44bc7a9

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_alrjokvie5ilmk6v.svg)](https://markdownregistry.com/a/art_alrjokvie5ilmk6v)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260615.f9474ca latest2026-06-15 f9474ca 12,935 BA view · diff
git:20260613.a6839cb2026-06-13 a6839cb 12,035 BA view · diff
git:20260612.b2408812026-06-12 b240881 10,726 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12935 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

black-yt/skills · 13 stars · license none · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_alrjokvie5ilmk6v
GET https://markdownregistry.com/api/v1/resolve?ref=black-yt/skills/wsl-bash-windows
GET https://markdownregistry.com/api/v1/blob/4141caf6c44bc7a9507f87283661e95c66541954817fb7b1efa36b65c333935f

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from black-yt/skills

AGENTS.md agents
black-yt/skills · AGENTS.md
git:20260804.1ce2bfe · audit B · 13 stars
agents-md-maintenance skill
black-yt/skills · agents-md-maintenance/SKILL.md · 当需要创建、整理、拆分或维护仓库中的 AGENTS.md、CLAUDE.md 或同类默认加载 agent 操作指南时使用;覆盖常驻上下文边界、*.local/ 按需拆分、公开/私有跟踪策略、同步校验和安全编辑。
git:20260803.6c56440 · audit A · 13 stars
ai-conference-paper-writing skill
black-yt/skills · ai-conference-paper-writing/SKILL.md · 当需要撰写、重构或打磨 AI conference paper 时使用;覆盖 research story、章节结构、图表实验布局、引用、case study、术语体系和可复现评测,重点把工作包装成清晰的问题、能力缺口和论证闭环。
git:20260611.295e62a · audit A · 13 stars
browser-render-visualization skill
black-yt/skills · browser-render-visualization/SKILL.md · 当需要用 Playwright 渲染网页前端、GitHub Pages、本地静态页面、Canvas 或 Three.js 页面并保存桌面/移动端截图、检查空白渲染、布局溢出和浏览器报错时使用。
git:20260605.e763408 · audit B · 13 stars
codex-history-sync skill
black-yt/skills · codex-history-sync/SKILL.md · 当需要把一个 CODEX_HOME/.codex 中的 Codex 会话记录、history.jsonl、sessions 和 thread title 元数据单向同步到另一个用户或目录下的 .codex 时使用;强调…
git:20260701.f15c195 · audit A · 13 stars
context-overlay skill
black-yt/skills · context-overlay/SKILL.md · Use when configuring or debugging the context-overlay OpenAI-compatible proxy for deterministic prompt/context…
git:20260713.9b7b32b · audit B · 13 stars
docx-splitting skill
black-yt/skills · docx-splitting/SKILL.md · 当需要在 Windows + Microsoft Word 环境中按页拆分 .docx 文件并尽量保留原始格式、图片、表格和分页效果时使用。
git:20260509.cdf62b1 · audit A · 13 stars
feishu-bot skill
black-yt/skills · feishu-bot/SKILL.md · 当需要创建、配置、调用或排查飞书/Lark 机器人时使用;覆盖自定义机器人 webhook 单向群通知、签名校验、消息格式、错误码,以及应用机器人收发消息、tenant_access_token、权限、事件订阅、卡片交互和资源上传。
git:20260613.d8ec3ec · audit A · 13 stars
frontend-markdown-rendering skill
black-yt/skills · frontend-markdown-rendering/SKILL.md · 当需要在前端把最终 assistant 文本渲染为 Markdown,同时保留工具过程为纯文本/JSON,并支持表格、代码块、图片、KaTeX 公式、Mermaid 图和 workspace 本地图片安全访问时使用。
git:20260605.e763408 · audit B · 13 stars
github-readme-writing skill
black-yt/skills · github-readme-writing/SKILL.md · 当需要为 GitHub 项目创建、重构或审阅高质量 README.md 时使用;参考 ResearchClawBench 风格,覆盖居中标题、徽章、导航、teaser、highlights、news、Mermaid、GitHub…
git:20260611.295e62a · audit A · 13 stars
huggingface-dataset-publishing skill
black-yt/skills · huggingface-dataset-publishing/SKILL.md · 当需要创建、上传、验证和维护 Hugging Face Dataset 时使用,尤其是包含图片、多图字段、文本步骤、答案、JSON/metadata 字段的数据集;包括 datasets Features/Image/Sequence…
git:20260605.e763408 · audit A · 13 stars
lab-cluster-1-web-portal skill
black-yt/skills · lab-cluster-1-web-portal/SKILL.md · 当需要访问、登录、自动化查询或排查 lab-cluster-1 的 h.pjlab.org.cn 集群管理网站时使用;覆盖浏览器/OIDC 登录、h.pjlab.org.cn/kapi/auth endpoint、凭据和 token…
git:20260613.2b94c80 · audit A · 13 stars

Every file in black-yt/skills

Browse by kind, by grade A, or by owner.