# Miniapp Devtools Gui Check

> Use host-side WeChat DevTools automation to inspect GUI-only runtime and interaction failures that do not show up in CLI `preview`. Trigger when page entry, taps, websocket-based DevTools automation, or run-directory evidence such as `report.json` and `trace.log` are needed to separate repo bugs from IDE session problems, local service blockers, or remaining visual-only issues.

- **Type:** Skill
- **Install:** `agentstack add skill-sun-sunshine06-miniprogram-skills-miniapp-devtools-gui-check`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Sun-sunshine06](https://agentstack.voostack.com/s/sun-sunshine06)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Sun-sunshine06](https://github.com/Sun-sunshine06)
- **Source:** https://github.com/Sun-sunshine06/miniprogram-skills/tree/main/skills/miniapp-devtools-gui-check

## Install

```sh
agentstack add skill-sun-sunshine06-miniprogram-skills-miniapp-devtools-gui-check
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Miniapp Devtools Gui Check

## Overview

Use this skill when CLI `preview` is not enough and the user needs GUI-side runtime evidence. Prefer it for smoke coverage, not for full visual regression.

## Quick Start

1. Read `references/gui-check-playbook.md`.
2. Confirm the run will happen on the real host, not inside a restricted sandbox.
3. Start with one route or one user flow, not the full app.
4. Run the local GUI checker if the repo provides one.
5. Inspect the generated `report.json` before claiming success or failure.
6. If `report.json` is missing, inspect `trace.log` in the same run directory before blaming repo code.

## Core Rules

- Treat the host environment as part of the system under test.
- Prefer narrow smoke checks over "all routes at once" until the session is stable.
- Trust runtime exceptions, console events, page path, and selector presence more than screenshots.
- Treat screenshots as best-effort evidence, not the primary signal.
- Keep the checker config-driven so route specs, backend prerequisites, and output locations are explicit.
- If the run directory contains `trace.log` but no `report.json`, classify the failure by stage first:
  - launcher or websocket stage usually means DevTools session or host setup
  - page stage usually means route-level runtime or state issues
- Separate repo bugs, DevTools session problems, local service blockers, and remaining visual-only questions.

## Output Format

When answering, keep the result operational:

1. which route or flow was checked
2. whether automation really connected
3. what runtime evidence was collected
4. whether the issue is in repo code, session state, a local service dependency, or still needs manual visual confirmation
5. the next command or user action

## Resources

- `references/gui-check-playbook.md`: host prerequisites, failure classification, and reporting guidance
- `../../tools/wechat-gui-check/README.md`: current extraction target for the public harness
- `references/example-prompts.md`: reusable trigger examples and evaluation notes

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Sun-sunshine06](https://github.com/Sun-sunshine06)
- **Source:** [Sun-sunshine06/miniprogram-skills](https://github.com/Sun-sunshine06/miniprogram-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sun-sunshine06-miniprogram-skills-miniapp-devtools-gui-check
- Seller: https://agentstack.voostack.com/s/sun-sunshine06
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.