القائمة
Read-only Libretto workflow for diagnosing live browser state without clicks, typing, navigation, or mutation requests.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/saffron-health/libretto --skill libretto-readonlyيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Browser automation CLI for building, maintaining, and running browser automation workflows by inspecting live pages and prototyping interactions.
Automate user-installed Electron desktop apps (Slack, Discord, VS Code, Notion, Figma, Spotify, etc.) via CDP using this repo's Libretto CLI. Use when the task is to control a local desktop app on the user's machine, not this repo's own Electron app. Triggers: "desktop Slack app", "connect to Electron app", "remote-debugging-port", "CDP desktop app", "automate VS Code desktop app".
errore is Go-style error handling for TypeScript: return errors instead of throwing them. Instead of Go's two-value tuple (val, err), functions return a single Error | T union. Instead of checking err != nil, you check instanceof Error. TypeScript narrows the type automatically — forget to check and your code won't compile. No wrapper types, no Result monads, just unions and instanceof. The errore npm package provides helper utilities (createTaggedError, tryAsync, matchError, findCause, partition) but the core pattern is zero-dependency. Benefits: every error is visible in the return type, callers can't forget to handle errors, flat control flow with early returns instead of nested try-catch, and errors carry typed properties with cause chains for debugging. ALWAYS read this skill when a repo uses the errore "errors as values" convention (errore.org). ALWAYS use errore for new TypeScript projects.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | libretto-readonly |
| description | Read-only Libretto workflow for diagnosing live browser state without clicks, typing, navigation, or mutation requests. |
| license | MIT |
| metadata | {"author":"saffron-health","version":"0.6.45"} |
snapshot and readonly-exec.readonly-exec reuses Libretto's normal execution pipeline, but it only exposes read-only helpers and denies mutating Playwright methods.exec, run, or any direct Playwright action that could change browser or application state.snapshot first when the visible page state is unclear.readonly-exec for focused inspection: titles, HTML, locator text, counts, visibility checks, and GET requests.readonly-exec commands at the same time.connectconnect to attach to an existing CDP endpoint for a preserved browser session.--read-only when creating the Libretto session handle for a preserved browser session.libretto connect http://127.0.0.1:9222 --read-only --session failed-job-debug
pagespages when a popup, new tab, or second page exists.readonly-exec or snapshot complains about multiple pages, list ids first and then pass --page.libretto pages --session failed-job-debug
snapshotsnapshot as the first high-level observation tool.snapshot <ref> to inspect a subtree from the latest full snapshot.readonly-execreadonly-exec for narrow inspection code only.ReadonlyExecDenied: ....page — a read-only Playwright Page proxy. Standard Playwright read methods work normally (url(), title(), content(), frames(), getByRole(), locator(), textContent(), isVisible(), count(), scrollIntoViewIfNeeded(), etc.). frames() returns read-only Frame proxies, including from childFrames() and parentFrame(). Anything that mutates a page or frame (click, fill, goto, evaluate, keyboard, mouse) is blocked.state — the current Libretto session state object.get(url, options?) — HTTP client restricted to GET and HEAD requests. Replaces fetch, which is blocked in readonly mode. Any request with a body or a non-GET/HEAD method throws ReadonlyExecDenied.scrollBy(deltaX, deltaY) — scroll the viewport by pixel offset. Use this to inspect content below the fold without targeting a specific element.Standard JS globals console, URL, Buffer, setTimeout, and setInterval are also available.
libretto readonly-exec "return page.url()" --session failed-job-debug
libretto readonly-exec "return await page.getByRole('heading').first().textContent()" --session failed-job-debug
libretto readonly-exec "return await page.frames()[1]?.getByRole('heading').textContent()" --session failed-job-debug
# HTTP GET inspection
echo "const r = await get('https://api.example.com/status'); return await r.json()" \
| libretto readonly-exec - --session failed-job-debug
# Scroll down to inspect below-the-fold content
libretto readonly-exec "await scrollBy(0, 500)" --session failed-job-debug
closeclose when the inspection session is no longer needed, unless the user explicitly asks to keep the browser open.libretto close --session failed-job-debug