wsl-bash-windows SKILL.md skillA

wsl-bash-windows from black-yt/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add black-yt/skills/wsl-bash-windows@git:20260615.f9474ca

Pins git:20260615.f9474ca in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
black-yt/skills
Path
wsl-bash-windows/SKILL.md
Versions recorded
3
Latest version
git:20260615.f9474ca, committed Jun 15, 2026
First version recorded
Jun 12, 2026
Size
12,935 bytes
Repository stars
16
License
none declared

当在 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 时使用。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file 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

The exact contents, by fingerprint
mdr add black-yt/skills/wsl-bash-windows@sha256:4141caf6c44bc7a9

The line at the top of this page pins the label git:20260615.f9474ca, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Jun 12, 2026 and Jun 15, 2026, about one every day.

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. Fixed automatic checks with no AI involved, so the same checks give the 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 · 16 stars · license none declared · pushed 2026-11-05 · 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 AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from black-yt/skills

AGENTS.md AGENTS.md file
black-yt/skills · AGENTS.md
git:20260804.1ce2bfe · audit B · 16 stars
agent-orchestration SKILL.md skill
black-yt/skills · agent-orchestration/SKILL.md · 当任务包含大量相似工作、长时间管线或需要并行陪跑与异常修复时,组织主 Codex、原生子 agent 或 Claude Code/Atria 中层监督者,以及确定性底层执行者;控制权限、资源、证据和接管边界。
git:20261016.9ee6ddd · audit A · 16 stars
agents-md-maintenance SKILL.md skill
black-yt/skills · agents-md-maintenance/SKILL.md · 当需要创建、整理、拆分或维护仓库中的 AGENTS.md、CLAUDE.md 或同类默认加载 agent 操作指南时使用;覆盖常驻上下文边界、*.local/ 按需拆分、公开/私有跟踪策略、同步校验和安全编辑。
git:20260803.6c56440 · audit A · 16 stars
ai-conference-paper-writing SKILL.md skill
black-yt/skills · ai-conference-paper-writing/SKILL.md · 当需要撰写、重构或打磨 AI conference paper,或从通用 LaTeX 技术报告模板开始写论文时使用;覆盖 research story、章节结构、图表实验布局、引用、case study 和可复现评测。
git:20261027.fc8e805 · audit A · 16 stars
bilibili-video-download SKILL.md skill
black-yt/skills · bilibili-video-download/SKILL.md · 当用户要下载哔哩哔哩普通 BV 投稿视频为 MP4、选择画质或分 P,或将其音频导出为 MP3 时使用;提供完整的标准库 Python 下载脚本、ffmpeg 安装与调用步骤、登录态处理和结果验证。
git:20261022.f462695 · audit A · 16 stars
browser-render-visualization SKILL.md skill
black-yt/skills · browser-render-visualization/SKILL.md · 当需要用 Playwright 渲染网页前端、GitHub Pages、本地静态页面、Canvas 或 Three.js 页面并保存桌面/移动端截图、检查空白渲染、布局溢出和浏览器报错时使用。
git:20260605.e763408 · audit B · 16 stars
cloudflare-flux-image-generation SKILL.md skill
black-yt/skills · cloudflare-flux-image-generation/SKILL.md · 使用 Cloudflare Workers AI 的 FLUX.1 schnell 免费额度按文字生成 JPEG 图片时使用;覆盖账号注册、Workers AI API Token、Python 标准库脚本调用、额度核算和故障排查。
git:20261023.26b4d66 · audit A · 16 stars
codex-app-troubleshooting SKILL.md skill
black-yt/skills · codex-app-troubleshooting/SKILL.md · 排查 Codex App 登录、更新中断、WSL 后端、CLI 定位、项目迁移、MCP 和代理故障,保护 provider、活动对话与历史;也覆盖用户明确涉及的 CC Switch、Claude Code 代理迁移、Gemini CLI…
git:20261104.2f62771 · audit A · 16 stars
codex-history-sync SKILL.md skill
black-yt/skills · codex-history-sync/SKILL.md · 当需要把一个 CODEX_HOME/.codex 中的 Codex 会话记录、history.jsonl、sessions 和 thread title 元数据单向同步到另一个用户或目录下的 .codex 时使用;强调…
git:20260701.f15c195 · audit A · 16 stars
context-overlay SKILL.md 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 · 16 stars
docx-splitting SKILL.md skill
black-yt/skills · docx-splitting/SKILL.md · 当需要在 Windows + Microsoft Word 环境中按页拆分 .docx 文件并尽量保留原始格式、图片、表格和分页效果时使用。
git:20260509.cdf62b1 · audit A · 16 stars
feishu-bot SKILL.md skill
black-yt/skills · feishu-bot/SKILL.md · 当需要创建、配置、调用或排查飞书/Lark 机器人时使用;覆盖自定义机器人 webhook 单向群通知、签名校验、消息格式、错误码,以及应用机器人收发消息、tenant_access_token、权限、事件订阅、卡片交互和资源上传。
git:20260613.d8ec3ec · audit A · 16 stars

Every file in black-yt/skills

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