context-overlay SKILL.md skillB

context-overlay 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/context-overlay@git:20260713.9b7b32b

Pins git:20260713.9b7b32b in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
black-yt/skills
Path
context-overlay/SKILL.md
Versions recorded
3
Latest version
git:20260713.9b7b32b, committed Jul 13, 2026
First version recorded
Jun 5, 2026
Size
15,095 bytes
Repository stars
16
License
none declared

Use when configuring or debugging the context-overlay OpenAI-compatible proxy for deterministic prompt/context injection, prompt patching, rule matching, request routing, rejection rules, skill_dir retrieval, streaming forwarding, and local or tunneled proxy validation.

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

# Context Overlay

## 使用边界

- `context-overlay` 是 OpenAI-compatible request proxy,位于 SDK client 和上游模型服务之间。
- 用于按规则注入 context、skill、policy、memory、profile、prompt patch,或把特定请求 route 到另一个上游。
- 它不运行 agent loop、不执行 tools、不解释模型输出。
- 它应保留 OpenAI-compatible 字段,例如 `tools`、`image_url`、`response_format`、`stream`。
- 不要把 secrets 写进 overlay 文本、skill JSON 或公开配置;优先用环境变量展开。
- 暴露到公网前必须配置 `auth.api_key`,不要公开无认证 proxy。
- 需要安装、开公网 tunnel、改服务端口或改长期配置时,先征得用户同意。

## 安装与最小配置

- PyPI 安装:`pip install context-overlay`
- GitHub 源码:https://github.com/black-yt/context-overlay

## 上游版本锚点

- 当前 skill 对照 context-overlay GitHub `VERSION`:`0.0.5`。
- 当前 skill 对照 GitHub HEAD:`e7a7c83924a225c443c454c80aab0735ca1bbe6c`。
- 维护本 skill 前,先重新检查上游 `VERSION` 和 HEAD;如果任一变化,必须阅读 README、`pyproject.toml`、CLI help 和相关源码后再更新。

安装模板:

```bash
pip install context-overlay
```

开发版本模板:

```bash
git clone https://github.com/black-yt/context-overlay.git
cd context-overlay
pip install -e ".[dev]"
pytest -q
```

## 源码追溯

- 如果配置字段、transform 行为或转发逻辑不确定,优先追溯已安装包源码。
- `inspect.getsource(...)` 适合查看 `apply_rules`、`load_config`、`SkillStore`、FastAPI app 创建逻辑。
- `module.__file__` 可定位包安装路径,再按需打开源码文件。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add black-yt/skills/context-overlay@sha256:7bbbcf656da7b90f

The line at the top of this page pins the label git:20260713.9b7b32b, 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_q5dzmzyuytlanqgl.svg)](https://markdownregistry.com/a/art_q5dzmzyuytlanqgl)

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

Versions

The registry has recorded 3 versions of this file, between Jun 5, 2026 and Jul 13, 2026, about one every 19 days.

versioncommittedcommitsizeaudit
git:20260713.9b7b32b latest2026-07-13 9b7b32b 15,095 BB view · diff
git:20260613.2b94c802026-06-13 2b94c80 14,566 BB view · diff
git:20260605.e7634082026-06-05 e763408 12,281 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:8011)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15095 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 script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

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_q5dzmzyuytlanqgl
GET https://markdownregistry.com/api/v1/resolve?ref=black-yt/skills/context-overlay
GET https://markdownregistry.com/api/v1/blob/7bbbcf656da7b90f06d3097aa85e331a973fbdffc799643fe0b790d1f60c2fd6

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
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
frontend-markdown-rendering SKILL.md skill
black-yt/skills · frontend-markdown-rendering/SKILL.md · 当需要在前端把最终 assistant 文本渲染为 Markdown,同时保留工具过程为纯文本/JSON,并支持表格、代码块、图片、KaTeX 公式、Mermaid 图和 workspace 本地图片安全访问时使用。
git:20260605.e763408 · audit B · 16 stars

Every file in black-yt/skills

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