Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

verify

/verify

Weryfikuje narzędzia WebMCP na działającej stronie: rejestrację, wywołanie i kontrolę jakości każdego narzędzia.

Autor
ora ↗
Repozytorium
webmcp ↗
Licencja
MIT
Ostatnia zmiana repozytorium
07.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 07.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Weryfikuje narzędzia WebMCP na działającej stronie: rejestrację, wywołanie i kontrolę jakości każdego narzędzia.

Wyzwalacze z opisu

verify WebMCP toolstest document.modelContext toolscheck that page tools register
Oryginalny opis (EN)

This skill should be used when the user asks to "verify WebMCP tools", "test document.modelContext tools", "check that page tools register", or after implementing WebMCP tools that need browser verification. Runs a registration, invocation, and security-lint ladder against a locally running site and reports every tool as verified, failed, or could-not-verify.

Jak działa

  1. Prerequisites
  2. Drivers, in order of preference
  3. The ladder
  4. Console fallback
  5. Failure cheatsheet
  6. Report
Sekcje z nagłówków SKILL.md, w oryginale · 103 linii, 708 słów
Podgląd SKILL.md
---
name: verify
description: >-
  This skill should be used when the user asks to "verify WebMCP tools",
  "test document.modelContext tools", "check that page tools register", or
  after implementing WebMCP tools that need browser verification. Runs a
  registration, invocation, and security-lint ladder against a locally
  running site and reports every tool as verified, failed, or
  could-not-verify.
---

# Verify WebMCP tools

Runtime check that a site's WebMCP tools register and work as designed.
Runs standalone on any site with existing tools, and serves as step 5 of
this plugin's `webmcp` skill.

Treat tools like a public API: a tool is done when an agent can call it,
not when the build passes.

## Prerequisites

- The site runs locally (its own dev script or runbook; never assume a
  harness exists).
- Chrome installed. No flags or Canary needed for the packaged driver; it
  launches Chrome itself with
  `--enable-features=WebMCPTesting,DevToolsWebMCPSupport`.

## Drivers, in order of preference

1. **Packaged driver:** `npx @ora-ai/webmcp-verify <url>` lists registered
   tools with a built-in security lint;
   `npx @ora-ai/webmcp-verify <url> --exec <tool> --input '{"k":"v"}'`
   executes one exactly as an agent would (`getTools` + `executeTool`,
   handling Chrome's JSON-string input quirk). `--json` for
   machine-readable output; exit 0 clean, 1 findings/failed, 2 could not
   run. Use it per page/auth state for ladder rungs 2, 3, and 5.
2. **Chrome DevTools MCP** (`list_webmcp_tools`, `execute_webmcp_tool`;
   recent Dev/Canary builds) when rungs need in-page UI/state assertions
   alongside navigation.
3. **Console fallback** below, with any browser automation available, or
   hand the user the snippets to run. Pages needing the polyfill load
   `@mcp-b/webmcp-polyfill` themselves.

## The ladder

Run in order; navigation is the expensive unit, so visit each page and
auth state once and settle everything for that page in one pass.

1. **Boot.** Site starts; baseline page renders; no new console errors
   versus a clean load.
2. **Discover.** On each page and auth state where tools are declared
   (check anonymous and signed-in where relevant): list registered tools.
   Confirm each tool is present where declared, **absent** where it should
   not be (logged-out account tools), gone after its declared exits
   (logout, emptied cart), and re-registered correctly after client-side
   route changes (SPA contextual tools must not point at the previous
   entity). Compare names and schemas against the approved plan when one
   exists.
3. **Invoke read-only.** Call every read-only tool with realistic inputs.
   Assert the returned payload (JSON-serializable, useful, empty results
   carry an explanatory note) and the visible UI effect where one is
   declared. Also probe one invalid input per tool: the error must be
   actionable, not a silent empty success.
4. **Invoke state-changing.** Only against local/dev/seeded data and with
   the user's explicit go-ahead. Never fire writes at production or
   third-party services. Assert both the state change and the visible
   effect. No safe way to invoke: mark could-not-verify.
5. **Security lint.** Static pass over registrations:
   - `readOnlyHint` true only for tools with no state change
   - `untrustedContentHint` true wherever returns carry UGC
   - no agent instructions, secrets, or URLs-to-elsewhere in names,
     titles, or descriptions
   - destructive/payment tools stop at a reversible boundary and
     declarative destructive forms omit `toolautosubmit`
   - `exposedTo` lists only origins the site controls

## Console fallback

```js
const mc = document.modelContext;
const tools = await mc.getTools();
console.table(tools.map((t) => ({ name: t.name, description: t.description })));

const tool = tools.find((t) => t.name === "search_docs");
let raw;
try { raw = await mc.executeTool(tool, { query: "webmcp" }); } // spec shape: object
catch { raw = await mc.executeTool(tool, JSON.stringify({ query: "webmcp" })); } // current Chrome parses only a JSON string
console.log(JSON.parse(raw)); // executeTool resolves to a JSON string, not an object
```

`getTools()` / `executeTool()` are spec APIs: the page can be driven
exactly as an agent would drive it from any console or automation harness.

## Failure cheatsheet

| Symptom | Likely cause |
| --- | --- |
| Empty tool list | no `modelContext` (flag/polyfill missing), insecure context, registration module not loaded on this page |
| Tool missing after navigation | aborted on unmount without re-register on the new page/route |
| Tool targets the wrong entity | contextual tool not re-registered on param change |
| Duplicate-name rejection | re-registered without aborting the previous controller |
| Execute error | input schema mismatch; a bare `UnknownError` means `execute` rejected — the tool should return `{ error }` instead |
| Null/failed result | non-JSON-serializable return or rejected promise |

## Report

One state per tool, in a table: **verified** (note the rung reached),
**failed** (must be fixed or dropped; never ship known-broken), or
**could-not-verify** (ships flagged, with the reason). Restate
could-not-verify items and any security-lint findings in the closing
summary.

Wersje

RepozytoriumWynikLicencja
Ta strona · ora/webmcp100MIT
yonatangross/orchestkit100MIT
yonatangross/orchestkit100MIT
NolwennD/gabier100Apache-2.0
ericrisco/rsc-harness100MIT
sentimony/agentic-workflow100MIT
JoDi-27/JoDi-SDD100MIT
marcel-bich/marcel-bich-claude-marketplace100MIT
kdlbs/kandev100AGPL-3.0

Migawka bazy z 13.11.2026 · wersja paczki 0b4531d24e5b (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90webmcp-site-tools
    Projektuje i testuje narzędzia WebMCP dla istniejącej aplikacji, by oferowała akcje dla agentów na żywo.
  • 90implement
    Dodaje narzędzia WebMCP do strony internetowej, tak by agenty przeglądarki działały przez logikę witryny, a nie przez scraping.
  • 100webmcpx
    Dodaje do strony narzędzia WebMCP, aby agenty AI mogły z niej korzystać, i sprawdza definicje narzędzi.
  • 100webmcp
    Przygotowuje stronę do użycia przez agentów AI w przeglądarce: planuje ścieżki użytkownika i wdraża je przez document.modelContext.
  • 100webmcp-gen
    Tworzy, kompiluje i sprawdza skrypty inicjalizacyjne WebMCP dla stron z adresu URL i wybranej zdolności narzędzia.
  • 100webmcp
    Udostępnia funkcje strony agentom AI jako wywoływalne narzędzia przez WebMCP, szkicowe API przeglądarki document.modelContext z W3C Web Machine Learning Community Group, w tym rejestrację narzędzi i testy w Chrome.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.