# Modlens (agent skill)

> Modlens is an agent skill (a SKILL.md file) from liustack/modlens. Plug-in vision for text-only models. Hard rule: when a file path or URL with an image extension (.png, .jpg, .jpeg, .webp, .gif, .heic, .heif) appears anywhere in the conversation (typed by the. It works with Claude Code, Codex and OpenCode and has 4,143 GitHub stars.

Plug-in vision for text-only models. Hard rule: when a file path or URL with an image extension (.png, .jpg, .jpeg, .webp, .gif, .heic, .heif) appears anywhere in the conversation (typed by the user, injected as a [Image: source: ] line, or inside a tag) and you cannot see that image's content, run this skill on it before any other approach: no self-built OCR, no PIL, no tesseract. Also triggers on pasted-image placeholders such as [Image #1] and [Unsupported Image].

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/liustack/modlens |
| Skill path | skills/modlens/SKILL.md |
| Skill name | modlens |
| GitHub stars | 4,143 |
| Installs on skills.sh | not listed |
| License | MIT |
| Skills in repo | 1 |
| Plugin marketplace | no |
| Official | no |
| Works with | Claude Code, Codex, OpenCode |
| Category | Coding |
| Last commit | Oct 4, 2026 |

## When it triggers

- user, injected as a [Image: source: ] line, or inside a tag) and you cannot see that image's content, run this skill on it before any other approach: no self-built OCR, no PIL, no tesseract.
- triggers on pasted-image placeholders such as [Image #1] and [Unsupported Image].
- use when the user asks how to install, configure, or switch modlens providers (Gemini API key, OpenAI-compatible endpoints, Claude API or Claude Code CLI).

## Add this skill

### Claude Code

```sh
git clone --depth 1 https://github.com/liustack/modlens.git
cp -r modlens/skills/modlens ~/.claude/skills/modlens   # personal, or .claude/skills in a project
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
git clone --depth 1 https://github.com/liustack/modlens.git
cp -r modlens/skills/modlens .agents/skills/modlens   # repo; ~/.agents/skills for all projects
```

### Cursor

```sh
git clone --depth 1 https://github.com/liustack/modlens.git
cp -r modlens/skills/modlens .cursor/skills/modlens   # project; ~/.cursor/skills for all projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

---

Canonical page: https://appsgit.com/skills/liustack-modlens
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.