Agent skill

Quick Debug

by DanielSuo117 in DanielSuo117/velocitai

测试失败时免登跳转原地排查修复。触发:排查、纠错、debug、定位符失败、超时、元素找不到、断言失败. An agent skill from DanielSuo117/velocitai.

MITAuto-check passedTesting & QA

Install Quick Debug

skills CLI
$ npx skills add DanielSuo117/velocitai --skill quick-debug -a claude-code

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

GitHub CLI
$ gh skill install DanielSuo117/velocitai quick-debug --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/DanielSuo117/velocitai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/quick-debug .claude/skills/quick-debug && 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
quick-debug
GitHub stars
158
Token cost
~471 tokens
SKILL.md length
114 words
Files
2 (incl. references)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

测试失败时免登跳转原地排查修复。触发:排查、纠错、debug、定位符失败、超时、元素找不到、断言失败. An agent skill from DanielSuo117/velocitai.

  • Works in 5 steps: 解析失败信息 → 构造免登跳转 URL → 免登跳转到目标页面 → …
  • Testing & QA work in your project
  • SKILL.md covers 核心思路, 主干流程(5 步), 诊断决策树(Step 4 展开) and 浏览器工具选择, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Quick Debug is an agent skill from DanielSuo117/velocitai. 测试失败时免登跳转原地排查修复。触发:排查、纠错、debug、定位符失败、超时、元素找不到、断言失败。

Its SKILL.md is about 470 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/diagnosis-tree.md`).

It sits in Testing & QA. It works with Model Context Protocol and Playwright. The repository describes itself as: Next-generation UI automation harness powered by Python & Playwright. Chat with AI Agents to seamlessly generate, architect, and execute enterprise-grade UI test code. The licence is MIT.

When your agent uses it

  • Testing & QA work in your project

Example prompts

  • “/quick-debug”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 解析失败信息
  2. 构造免登跳转 URL
  3. 免登跳转到目标页面
  4. 诊断问题
  5. 修复 + 原地验证

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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 no API keys, tokens, secrets or passwords.

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

Context cost

Quick Debug loads about 471 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 16 tokens; SKILL.md has 114 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~16
When it runs · the whole SKILL.md, loaded when a task matches
~471
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.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

The full file from DanielSuo117/velocitai at commit dfcca7e, republished under its MIT licence (© DanielSuo117). 114 words, ~471 tokens.

Download SKILL.mdSave it as .claude/skills/quick-debug/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
quick-debug
description
测试失败时免登跳转原地排查修复。触发:排查、纠错、debug、定位符失败、超时、元素找不到、断言失败。

Quick Debug — 快速纠错验证

核心思路

跳过从登录到问题节点的完整流程,直接免登到目标页面原地排查。

利用项目已有的 token URL 免登机制,配合浏览器工具直接在问题页面进行 DOM 探索、定位符验证、等待策略调整,修复后原地验证,全程不重跑完整测试流程。


主干流程(5 步)

Step 1: 解析失败信息
    ↓
Step 2: 构造免登跳转 URL
    ↓
Step 3: 免登跳转到目标页面
    ↓
Step 4: 诊断问题(决策树)
    ↓
Step 5: 修复 + 原地验证
Step 1: 解析失败信息

从堆栈 / 用户描述提取:失败用例名、错误类型(TimeoutError / AssertionError)、失败定位符、失败时所在 URL。信息不足时读取测试代码反推。

Step 2: 构造免登跳转 URL

从配置文件读取对应环境的 token。

⚠️ 免登前必须向用户确认 --env(见 agent-behavior P0.2)。

两种情况:

情况策略
目标页面有明确 URL 路径先免登(/entry?token=<JWT>),再导航到目标路径
目标页面需要交互才能到达(弹窗、新 tab 等)免登到最近的可直接访问的父级页面,执行最少量的导航操作到达目标
Step 3: 免登跳转到目标页面

browser_navigate → <base_url>/entry?token=<JWT> → 导航到目标路径 → 验证 is_page_loaded()。免登失败(跳回登录页)→ 提示用户刷新 token。

Step 4: 诊断问题

见下一节「诊断决策树」。

Step 5: 修复 + 原地验证

根据诊断结果调用对应 skill:

诊断结果调用 skill
定位符问题locator-replacer
等待策略问题wait-strategy
页面加载断言问题page-load-assertion
页面大改版报告用户,建议 gen-page-test 重新生成
断言预期值变更报告差异,由用户决策是否更新预期值

原地验证: 修复后在当前浏览器页面直接验证(用 Playwright MCP 重新执行失败操作),确认无误后建议用户重跑完整测试。


诊断决策树(Step 4 展开)

走到 Step 4 需要判断根因时展开 → references/diagnosis-tree.md

浏览器工具选择

DOM 探索/定位符采集 → agent-browser(优先);精确验证/断言 → Playwright MCP;agent-browser 未安装 → 全程 Playwright MCP(P0.4 降级)。


检查清单

每次 quick-debug 结束前,必须确认:

  • 已明确失败原因并归类(A/B/C/D 哪个分支)
  • 修复动作已执行(或已报告用户需人工决策)
  • 原地验证通过(修复后的定位符/等待在当前页面生效)
  • 建议用户重跑完整测试确认回归
  • 保存操作验证失败时,参考 save-verify-strategy(Toast 时序 / 重定向检测 / 数据对比)

© DanielSuo117, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/quick-debug of DanielSuo117/velocitai.

  • SKILL.md
  • references/diagnosis-tree.md

Open the folder on GitHubat commit dfcca7e

Compare with similar skills

Quick Debug 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.

Quick Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Quick Debug this skillDanielSuo117/velocitai158—~471Automated safety check: PassMIT
E2Ecallstack/react-native-pager-view3.4k1 repos~2.1kAutomated safety check: PassMIT
Invisible Playwrightfeder-cr/invisible_dots32k—~989Automated safety check: PassMIT
Debugging Opik E2E Testscomet-ml/opik22k—~1.8kAutomated safety check: PassApache-2.0
Playwright E2E Testsonyx-dot-app/onyx32k1 repos~2.8kAutomated safety check: NotesCustom licence
Shogun Screenshotyohey-w/multi-agent-shogun1.4k—~901Automated safety check: NotesMIT

Similar skills

  • E2E

    callstack/react-native-pager-view

    Agentic end-to-end tests with e2e, the e2e runner. An agent skill from callstack/react-native-pager-view.

    3.4k GitHub starsUsed in 1 repo~2.1k tokens
    Testing & QAAuto-check passed
  • Invisible Playwright

    feder-cr/invisible_dots

    Use the Dot's browser (invisibleplaywright) for any task on a website: logging in, reading pages, filling forms, clicking through a site as a person would.

    32k GitHub stars~989 tokensUpdated today
    Testing & QAAuto-check passed
  • Investigates a failed Opik end-to-end test from CI, TestOps or a local run, decides regression versus flake, and proposes a fix without editing tests.

    22k GitHub stars~1.8k tokensUpdated today
    Testing & QAAuto-check passed
  • Playwright E2E Tests

    onyx-dot-app/onyx

    Write and maintain Playwright end-to-end tests for the Onyx application.

    32k GitHub starsUsed in 1 repo~2.8k tokens
    Testing & QAAuto-check: notes
  • Shogun Screenshot

    yohey-w/multi-agent-shogun

    スクリーンショットの取得・加工を行う。ローカルスクショから最新画像を取得、 PlaywrightでWebページをキャプチャ、画像のトリミング・リサイズ、機微情報を黒塗りマスキング。

    1.4k GitHub stars~901 tokensUpdated 2 mo ago
    Testing & QAAuto-check: notes
  • Playwright Debug

    voicetreelab/voicetree

    This skill should be used when the user asks to "debug the electron app", "connect playwright to VoiceTree", "take screenshots of the running app", "interact with the live UI", "inspect the running…

    923 GitHub stars~1.2k tokensUpdated today
    Testing & QAAuto-check passed

More from DanielSuo117/velocitai

All 13 skills in this repo
  • Architecture

    DanielSuo117/velocitai

    POM 分层与 context 共享决策树。触发:架构、分层、POM、Page Object、基类设计、新增角色. An agent skill from DanielSuo117/velocitai.

    158 GitHub stars~726 tokensUpdated 10 days ago
    Auto-check passed
  • Locator Replacer

    DanielSuo117/velocitai

    替换占位定位符为真实选择器(六级优先级)。触发:替换定位符、locator、selector、定位失败、元素找不到、DOM 分析。

    158 GitHub stars~703 tokensUpdated 10 days ago
    Auto-check passed
  • Page Load Assertion

    DanielSuo117/velocitai

    ispageloaded() 四种验证模式与调用层级。触发:页面断言、ispageloaded、page loaded、页面加载验证。

    158 GitHub stars~776 tokensUpdated 10 days ago
    Auto-check passed
  • Save Verify Strategy

    DanielSuo117/velocitai

    表单保存后验证(Toast / 重定向 / 数据对比 / 富文本清空)。触发:保存验证、toast、重定向检测、Meta+A、保存成功判断。

    158 GitHub stars~547 tokensUpdated 10 days ago
    Auto-check passed
  • Test Runner

    DanielSuo117/velocitai

    运行 pytest + 结构化分析失败原因。触发:运行测试、跑测试、run test、pytest、失败分析、allure。

    158 GitHub stars~404 tokensUpdated 10 days ago
    Auto-check passed
  • Add Regression Point

    DanielSuo117/velocitai

    为已有 PageObject 增量添加回归测试点。触发:新增测试点、添加回归点、add test point、增加覆盖、扩展页面方法。

    158 GitHub stars~639 tokensUpdated 10 days ago
    Auto-check passed

Categories

Questions about Quick Debug

What does Quick Debug do?

测试失败时免登跳转原地排查修复。触发:排查、纠错、debug、定位符失败、超时、元素找不到、断言失败. An agent skill from DanielSuo117/velocitai. Quick Debug is an agent skill from DanielSuo117/velocitai.

When should I use Quick Debug?

Quick Debug fits situations like: testing & QA work in your project.

How do I install Quick Debug in Claude Code?

Run `npx skills add DanielSuo117/velocitai --skill quick-debug -a claude-code`. Or copy the skill folder (skills/quick-debug in DanielSuo117/velocitai) into .claude/skills/quick-debug in your project. Claude Code loads it when a task matches its description.

How do I install Quick Debug in Codex?

Run `npx skills add DanielSuo117/velocitai --skill quick-debug -a codex`. Or copy the skill folder (skills/quick-debug in DanielSuo117/velocitai) into .agents/skills/quick-debug in your project. Codex loads it when a task matches its description.

Can I use Quick Debug 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 DanielSuo117/velocitai --skill quick-debug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/quick-debug, .gemini/skills/quick-debug, .github/skills/quick-debug and .opencode/skills/quick-debug in your project.

What does Quick Debug need to run?

SKILL.md names no scripts, command-line tools or credentials: Quick Debug is instructions for the agent only.

Does Quick Debug 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 Quick Debug 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 Quick Debug use?

Quick Debug is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Quick Debug use?

About 471 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 585 tokens, read only when the agent opens those files.

What are the alternatives to Quick Debug?

Skills that share tags, products or a category with Quick Debug: E2E (callstack/react-native-pager-view, 3.4k stars), Invisible Playwright (feder-cr/invisible_dots, 32k stars), Debugging Opik E2E Tests (comet-ml/opik, 22k stars) and Playwright E2E Tests (onyx-dot-app/onyx, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Quick Debug?

DanielSuo117 (a GitHub user) maintains it in DanielSuo117/velocitai, which has 158 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 27, 2026.

Source: DanielSuo117/velocitai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.