Agent skill

Vision Model Retry Policy

by skuramatata in skuramatata/my-pi-agent

A skill your agent uses when image reading, screenshot analysis, visual diff, design mockup analysis, pasted image handling, or Z.AI Vision MCP fails, times out, returns 429/Too Many Requests, or…

No licenceAuto-check passedAI & LLM Engineering

Install Vision Model Retry Policy

skills CLI
$ npx skills add skuramatata/my-pi-agent --skill vision-model-retry-policy -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install skuramatata/my-pi-agent vision-model-retry-policy --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/skuramatata/my-pi-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/vision-model-retry-policy .claude/skills/vision-model-retry-policy && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
vision-model-retry-policy
GitHub stars
114
Token cost
~1k tokens
SKILL.md length
541 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when image reading, screenshot analysis, visual diff, design mockup analysis, pasted image handling, or Z.AI Vision MCP fails, times out, returns 429/Too Many Requests, or…

  • Works in 3 steps: Use the configured OpenCode/Z.AI vision… → If zai-vision-mcp is disconnected, run… → If Z.AI vision reaches the retry budget,…
  • Screenshot analysis
  • SKILL.md covers Current Repository Assumption, Retry Budget, Image Transport Contract and Fallback Order, plus 3 more sections
  • Calls opencode; needs ZAI_CODING_CN_API_KEY

What it does

Vision Model Retry Policy is an agent skill from skuramatata/my-pi-agent. Use when image reading, screenshot analysis, visual diff, design mockup analysis, pasted image handling, or Z.AI Vision MCP fails, times out, returns 429/Too Many Requests, or appears stuck in retry.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Computer vision and Visual regression testing. It works with Model Context Protocol and Zhipu GLM.

When your agent uses it

  • Screenshot analysis
  • Design mockup analysis
  • Pasted image handling
  • Z.AI Vision MCP fails

Example prompts

  • “/vision-model-retry-policy”

Requirements

  • A credential in ZAI_CODING_CN_API_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Use the configured OpenCode/Z.AI vision MCP path first when zai-vision-mcp is connected.
  2. If zai-vision-mcp is disconnected, run opencode mcp list or inspect OpenCode config before retrying.
  3. If Z.AI vision reaches the retry budget, stop vision automation and ask for one of

What it can do on your machine

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

    • opencode

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

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ZAI_CODING_CN_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Vision Model Retry Policy loads about 1k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 541 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
~1k

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 541 words (~1,021 tokens).

“Use this skill to prevent image recognition work from getting trapped in repeated provider retries or broken attachment transport.”

— opening of SKILL.md by skuramatata
name
vision-model-retry-policy

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .opencode/skills/vision-model-retry-policy of skuramatata/my-pi-agent.

Open the folder on GitHubat commit ed83ff1

Compare with similar skills

Vision Model Retry Policy next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Vision Model Retry Policy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vision Model Retry Policy this skillskuramatata/my-pi-agent114—~1kAutomated safety check: PassNone
Luma Vision Image AnalysisJochenYang/luma-mcp116—~295Automated safety check: PassMIT
Pi AgentK-Dense-AI/scientific-agent-skills48k1 repos~2.1kAutomated safety check: PassMIT
Chorus Openspec AwareChorus-AIDLC/Chorus1.2k—~6.8kAutomated safety check: PassAGPL-3.0
Openspec AwareChorus-AIDLC/Chorus1.2k—~7.2kAutomated safety check: PassAGPL-3.0
Openspec AwareChorus-AIDLC/Chorus1.2k—~7.3kAutomated safety check: PassAGPL-3.0

Similar skills

  • Luma Vision Image Analysis

    JochenYang/luma-mcp

    Calls an external vision model through vision.js to analyze an image when the user explicitly invokes /skill luma-vision, for agents whose own model cannot see images.

    116 GitHub stars~295 tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check passed
  • Pi Agent

    K-Dense-AI/scientific-agent-skills

    Builds with and operates Pi, the minimal terminal coding harness.

    48k GitHub starsUsed in 1 repo~2.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Chorus Openspec Aware

    Chorus-AIDLC/Chorus

    OpenSpec-mode authoring for Chorus PM workflows in Kiro CLI.

    1.2k GitHub stars~6.8k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Openspec Aware

    Chorus-AIDLC/Chorus

    OpenSpec-mode authoring for Chorus PM workflows in Pi. An agent skill from Chorus-AIDLC/Chorus.

    1.2k GitHub stars~7.2k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Openspec Aware

    Chorus-AIDLC/Chorus

    OpenSpec-mode authoring for Chorus PM workflows in Codex. An agent skill from Chorus-AIDLC/Chorus.

    1.2k GitHub stars~7.3k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Openspec Aware

    Chorus-AIDLC/Chorus

    OpenSpec-mode authoring for Chorus PM workflows in Claude Code.

    1.2k GitHub stars~6.9k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed

More from skuramatata/my-pi-agent

All 24 skills in this repo
  • Documentation And Adrs

    skuramatata/my-pi-agent

    A skill your agent uses when my-pi-agent changes architecture, runtime/workflow/executor behavior, prompt-engine contracts, memory/state, channel behavior, MCP/OpenCode config, README content, or…

    114 GitHub stars~588 tokensUpdated 3 mo ago
    Auto-check passed
  • Documentation And Adrs

    skuramatata/my-pi-agent

    A skill your agent uses when my-pi-agent changes architecture, orchestration, execution, prompt-engine, memory, Feishu/channel behavior, skill scope, verifier semantics, public commands, or…

    114 GitHub stars~635 tokensUpdated 3 mo ago
    Auto-check passed
  • Openspec Apply Change

    skuramatata/my-pi-agent

    A skill your agent uses when the user wants to implement, continue, or work through tasks from an existing OpenSpec change.

    114 GitHub stars~433 tokensUpdated 3 mo ago
    Auto-check passed
  • Openspec Propose

    skuramatata/my-pi-agent

    A skill your agent uses when the user wants to propose a new OpenSpec change and generate proposal, design, specs, and tasks before implementation.

    114 GitHub stars~351 tokensUpdated 3 mo ago
    Auto-check passed
  • Code Review

    skuramatata/my-pi-agent

    A skill your agent uses when reviewing a my-pi-agent change before merge or handoff: 代码审查、review、PR review、改动盘点、merge readiness、风险找漏、提交前质量检查。

    114 GitHub stars~596 tokensUpdated 3 mo ago
    Auto-check passed
  • Code Review And Quality

    skuramatata/my-pi-agent

    A skill your agent uses when reviewing my-pi-agent changes, PRs, worker output, verifier repair results, prompt/skill edits, Feishu channel changes, or shared runtime refactors.

    114 GitHub stars~777 tokensUpdated 3 mo ago
    Auto-check: notes

Questions about Vision Model Retry Policy

What does Vision Model Retry Policy do?

A skill your agent uses when image reading, screenshot analysis, visual diff, design mockup analysis, pasted image handling, or Z.AI Vision MCP fails, times out, returns 429/Too Many Requests, or…. Vision Model Retry Policy is an agent skill from skuramatata/my-pi-agent.AI Vision MCP fails, times out, returns 429/Too Many Requests, or appears stuck in retry.

When should I use Vision Model Retry Policy?

Vision Model Retry Policy fits situations like: screenshot analysis; design mockup analysis; pasted image handling; Z.AI Vision MCP fails.

How do I install Vision Model Retry Policy in Claude Code?

Run `npx skills add skuramatata/my-pi-agent --skill vision-model-retry-policy -a claude-code`. Or copy the skill folder (.opencode/skills/vision-model-retry-policy in skuramatata/my-pi-agent) into .claude/skills/vision-model-retry-policy in your project. Claude Code loads it when a task matches its description.

How do I install Vision Model Retry Policy in Codex?

Run `npx skills add skuramatata/my-pi-agent --skill vision-model-retry-policy -a codex`. Or copy the skill folder (.opencode/skills/vision-model-retry-policy in skuramatata/my-pi-agent) into .agents/skills/vision-model-retry-policy in your project. Codex loads it when a task matches its description.

Can I use Vision Model Retry Policy in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add skuramatata/my-pi-agent --skill vision-model-retry-policy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vision-model-retry-policy, .gemini/skills/vision-model-retry-policy, .github/skills/vision-model-retry-policy and .opencode/skills/vision-model-retry-policy in your project.

What does Vision Model Retry Policy need to run?

Going by SKILL.md and its folder, Vision Model Retry Policy needs the command-line tools its instructions call (opencode) and credentials named ZAI_CODING_CN_API_KEY. Our summary lists: A credential in ZAI_CODING_CN_API_KEY.

Does Vision Model Retry Policy access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Vision Model Retry Policy safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Vision Model Retry Policy use?

No licence was found for Vision Model Retry Policy or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Vision Model Retry Policy use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Vision Model Retry Policy?

Skills that share tags, products or a category with Vision Model Retry Policy: Luma Vision Image Analysis (JochenYang/luma-mcp, 116 stars), Pi Agent (K-Dense-AI/scientific-agent-skills, 48k stars), Chorus Openspec Aware (Chorus-AIDLC/Chorus, 1.2k stars) and Openspec Aware (Chorus-AIDLC/Chorus, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vision Model Retry Policy?

skuramatata (a GitHub user) maintains it in skuramatata/my-pi-agent, which has 114 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on July 10, 2026.

Source: skuramatata/my-pi-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.