Install the "e2e-earn" agent skill from https://github.com/LedgerHQ/ledger-live/tree/develop/.agents/skills/e2e-earn into .claude/skills/e2e-earn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "e2e-earn", then confirm the skill loads.
Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
skills CLI
$ npx skills add LedgerHQ/ledger-live --skill e2e-earn -a codex
Project install goes to .agents/skills/; add -g for ~/.codex/skills/.
Install the "e2e-earn" agent skill from https://github.com/LedgerHQ/ledger-live/tree/develop/.agents/skills/e2e-earn into .agents/skills/e2e-earn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "e2e-earn", then confirm the skill loads.
Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add LedgerHQ/ledger-live --skill e2e-earn -a cursor
Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.
Install the "e2e-earn" agent skill from https://github.com/LedgerHQ/ledger-live/tree/develop/.agents/skills/e2e-earn into .cursor/skills/e2e-earn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "e2e-earn", then confirm the skill loads.
Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
skills CLI
$ npx skills add LedgerHQ/ledger-live --skill e2e-earn -a gemini-cli
Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.
Install the "e2e-earn" agent skill from https://github.com/LedgerHQ/ledger-live/tree/develop/.agents/skills/e2e-earn into .gemini/skills/e2e-earn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "e2e-earn", then confirm the skill loads.
Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
GitHub CLI
$ gh skill install LedgerHQ/ledger-live e2e-earn
Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
skills CLI
$ npx skills add LedgerHQ/ledger-live --skill e2e-earn -a github-copilot
Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.
Install the "e2e-earn" agent skill from https://github.com/LedgerHQ/ledger-live/tree/develop/.agents/skills/e2e-earn into .github/skills/e2e-earn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "e2e-earn", then confirm the skill loads.
GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add LedgerHQ/ledger-live --skill e2e-earn -a opencode
OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
Install the "e2e-earn" agent skill from https://github.com/LedgerHQ/ledger-live/tree/develop/.agents/skills/e2e-earn into .opencode/skills/e2e-earn/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "e2e-earn", then confirm the skill loads.
OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
Skill name
e2e-earn
GitHub stars
622
Token cost
~3.8k tokens
SKILL.md length
1,622 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT
At a glance
Check, update, and RUN Earn E2E tests for Ledger Wallet Desktop (Playwright) and Mobile (Detox).
Works in 5 steps: Confirm scope with the user → Verify environment (Speculos mode, MOCK=0) → Ask whether to rebuild → …
Run earn.v2 / delegate locally
SKILL.md covers Use this skill when, Running the Earn E2E tests, Current source of truth and Platform model, plus 7 more sections
Calls pnpm, docker and npx
What it does
E2E Earn is an agent skill from LedgerHQ/ledger-live. Check, update, and RUN Earn E2E tests for Ledger Wallet Desktop (Playwright) and Mobile (Detox). Covers the Earn v2 dashboard, the native + redirect staking flows, and the delegate specs (owned by the Earn team). Use to run earn.v2 / delegate locally, adapt earn page objects/flows, and triage failures.
Its SKILL.md is about 3.8k 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 Testing & QA, covering End-to-end testing and Browser testing. It works with Playwright and pnpm. The repository describes itself as: Mono-repository for Ledger Wallet apps and related packages. The licence is MIT.
When your agent uses it
Run earn.v2 / delegate locally
Adapt earn page objects/flows
Triage failures
Example prompts
“/e2e-earn”
Requirements
Node.js
Docker
Workflow steps
5 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 9c51f17. 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:
pnpm
docker
npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use pnpm, docker and npx, which can reach the network depending on how they are called.
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
E2E Earn loads about 3.8k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 1,622 words of instructions outside code blocks.
Always· name and description, kept in context so the agent knows when to use it
~78
When it runs· the whole SKILL.md, loaded when a task matches
~3.8k
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.
Download SKILL.mdSave it as .claude/skills/e2e-earn/SKILL.md (or your agent's skills folder).
name
e2e-earn
description
Check, update, and RUN Earn E2E tests for Ledger Wallet Desktop (Playwright) and Mobile (Detox). Covers the Earn v2 dashboard, the native + redirect staking flows, and the delegate specs (owned by the Earn team). Use to run earn.v2 / delegate locally, adapt earn page objects/flows, and triage failures.
Earn E2E Skill
You are both a test runner and a maintenance guide for the Earn E2E suites. When invoked as a command (/e2e-earn), default behaviour is to run the relevant Earn tests locally and triage any failures — but always confirm scope with the user first (see "Running the Earn E2E tests").
Use this skill when
Running the Earn E2E tests locally (earn.v2, delegate, or both) and triaging failures.
Updating Earn specs/page objects in e2e/desktop or e2e/mobile.
Refactoring Earn page objects or moving reusable flow logic out of specs.
Adapting the Earn v2 dashboard flows (ice/cold/hot start, deposit, withdrawal, provider selection, native vs redirect staking).
Fixing PR review comments about dead code, selector ownership, brittle amounts, webview/window context, or feature-flag drift.
Running the Earn E2E tests
This is the primary command behaviour. Follow these steps in order.
Step 1 — Confirm scope with the user
Do not assume. Ask which subset to run before doing anything heavy:
Desktop:
earn.v2 only — pnpm e2e:desktop test:playwright earn.v2
delegate only — pnpm e2e:desktop test:playwright delegate
both — run earn.v2 then delegate
optionally narrow with a --grep (e.g. a single currency/provider): pnpm e2e:desktop test:playwright earn.v2 --grep "Ethereum"
Mobile (heavier — requires a built app + simulator/emulator): ask whether to include it, and if so iOS (debug) or Android (release). Defer build/setup to /e2e-mobile-onboard.
The earn.v2 / delegate argument is a path substring filter Playwright matches against spec file paths — earn.v2 matches tests/specs/earn.v2.spec.ts, delegate matches tests/specs/delegate.spec.ts.
These must be set in the shell that runs the tests. If any are missing, point the user to /e2e-desktop-onboard (or /e2e-mobile-onboard) rather than guessing.
Variable
Required value / note
MOCK
0 (Speculos mode)
SEED
Non-empty. NEVER print or echo it. Read at runtime (e.g. from 1Password).
COINAPPS
Path to a cloned, up-to-date coin-apps repo
SPECULOS_IMAGE_TAG
See "Speculos image" in Troubleshooting — pin to avoid :latest drift
SPECULOS_DEVICE
e.g. nanoSP (options: nanoS, nanoSP, nanoX, stax, flex, nanoGen5)
Docker Desktop must be running, and the Speculos image must be pulled.
Step 3 — Ask whether to rebuild
The Playwright suite runs the built desktop app from apps/ledger-live-desktop/.webpack/main.bundle.js. A stale or partial build is the #1 cause of domcontentloaded timeouts (see Troubleshooting).
Check the build's freshness: ls -la apps/ledger-live-desktop/.webpack/main.bundle.js.
If it's stale (older than recent app changes), missing, or the user is unsure, ask before rebuilding — a rebuild is slow:bash
pnpm desktop build:testing
Only spec/page-object/util changes under e2e/ do not require a rebuild. Any change to app code under apps/ledger-live-desktop/src does.
Step 4 — Run
From the repo root. Example combined run (only after confirming scope + build):
bash
# Desktop, both suites, fresh build
pnpm desktop build:testing && pnpm e2e:desktop test:playwright earn.v2 && pnpm e2e:desktop test:playwright delegate
# Desktop, earn only, no rebuild
pnpm e2e:desktop test:playwright earn.v2
# Desktop, delegate only
pnpm e2e:desktop test:playwright delegate
# Debugging (Playwright inspector + Ledger Wallet devtools)
PWDEBUG=1 DEV_TOOLS=1 pnpm e2e:desktop test:playwright earn.v2
# Allure report after a run
pnpm e2e:desktop allure
Mobile (from e2e/mobile/, after /e2e-mobile-onboard build): pnpm test:android <earnSpecFile> / pnpm test:ios:debug <earnSpecFile>.
Step 5 — Triage failures
On any failure, classify using the Troubleshooting taxonomy below and tell the user the category (environment vs build vs test-flow mismatch) and the concrete fix. Read the run's error-context.md and per-test logs.log under e2e/desktop/tests/artifacts/test-results/<test>/ for the real cause.
Current source of truth
Desktop specs: e2e/desktop/tests/specs/earn.v2.spec.ts, e2e/desktop/tests/specs/delegate.spec.ts (delegate is owned by the Earn team). The legacy Earn v1 suite (earn.spec.ts) has been removed.
Mobile specs/builders: e2e/mobile/specs/earn/** (e.g. earnV2_iceColdStart_ETH_3.spec.ts, earnV2_position_withdrawal_USDT.spec.ts, earnInlineAddAccount.spec.ts), builder e2e/mobile/specs/earn/earnV2.ts (includes runInlineAddAccountTest). The legacy Earn v1 builder (earn.ts) and its consumer specs (correctEarnPage_*, startStakingFromEarnDashboard_*) have been removed.
Mobile page objects: e2e/mobile/page/trade/earnV2Dashboard.page.ts.
Platform model
Desktop:
Electron exposes multiple windows (main app + one or more webviews). The Earn app is a webview.
Resolve the Earn webview via EarnBasePage.getWebView() using webviewIdentifier = "earn" (title matching) — never fixed electronApp.windows()[N] indexes.
The Earn app signals readiness via a console log: goAndWaitForEarnToBeReady() waits for the "Earn Live App Loaded" info message, then for the loading-skeleton test id to be hidden. Prefer this over ad-hoc waits.
Native staking (the delegate modal) acts on the main window; the Earn dashboard/deposit flow acts on the webview.
Mobile:
Webview operations use Detox web helpers; native operations use regular Detox matchers.
Mirror desktop test ids where the Earn web app shares them (e.g. asset-earn-cta-<ticker>, eth-provider-card-<provider>).
Earn flow & feature-flag model (critical)
Earn behaviour is feature-flag driven. Get this wrong and the app routes to the legacy modal instead of the Earn dashboard (or vice versa).
EARN_V2_DESKTOP_FLAGS enables the Earn v2 dashboard. When useLocalEarnManifest (USE_LOCAL_EARN_MANIFEST=1) is set, it also points ptxEarnLiveApp at the local earn-local-manifest (earnLocalManifest.json) and the spec applies localManifestOverride.
FF_STAKE_PROGRAMS_MODAL (stakePrograms) controls native staking vs redirect-to-Earn per currency:
params.list — currencies that use native staking UI.
params.redirects — currencies that redirect into the Earn app (platform earn, with queryParams). For native ETH the redirect carries cryptoAssetId: "ethereum", intent: "deposit", and an ethDepositCohort (e.g. "basic_sorting"). Omitting ethDepositCohort yields a missing_cohort_value sentinel and the wrong screen.
Per-test featureFlags (passed via test.use) override env/remote flags. This is how specs force a deterministic flow.
Desktop patterns (current API)
Keep assertion method prefixes consistent within a page object (verify*).
In EarnV2Page, resolve the webview with const webview = await this.getWebView(); act on webview.getByTestId(...). Do not pass electronApp unless a method needs non-webview windows/events.
Keep test ids as class properties / id-builder functions in the page object (e.g. asset-item-ticker-<ticker>, asset-earn-cta-<ticker>, eth-provider-card-<provider>), never inline literals repeated across specs.
Current dashboard-state helpers: verifyIceColdStartPage(), verifyColdStartPage(), verifyHotStartPage(), verifyAssetReadyToEarn(ticker), verifyRewardsSummaryBoxes().
Provider redirect URL assertions live in EarnBasePage.verifyProviderURL(provider, account) — extend that switch rather than asserting URLs inline.
Native ETH "select validator" now flows through the Earn deposit screen (delegate.spec.ts uses verifyDepositFlowVisible() + selectEthProvider(...) for ETH), not the old stake-provider-container-lido modal. Don't reintroduce removed Lido-modal helpers.
Mobile patterns (current API)
Use the Page Object Model; native vs webview matchers as in "Platform model".
Keep flows in builders (earnV2.ts / earn.ts) and page objects, not inline in specs.
Custom flags can be injected globally via E2E_FEATURE_FLAGS_JSON (merged with defaults; per-test flags still win). Use this to force the Earn v2 / redirect behaviour on mobile.
Use the .skip.spec.ts suffix to temporarily exclude a spec from CI (don't comment-out).
Show full SKILL.md (648 more words)Show less
Troubleshooting / failure taxonomy
Classify every failure as environment, build, or test-flow mismatch, then apply the fix.
page.waitForLoadState: Timeout ... domcontentloaded (build) — the app launched but the renderer never loaded. Almost always a stale/partial .webpack build (e.g. built under a restricted sandbox, or never rebuilt after app changes). Fix in the user's own terminal:bash
Validate with one simple spec (tests/specs/add.account.spec.ts --grep "Bitcoin"). If it still hangs, launch the built app standalone to see it: cd apps/ledger-live-desktop && npx electron .webpack/main.bundle.js --user-data-dir=/tmp/lld-debug (blank/crash ⇒ bad build or native-module ABI mismatch ⇒ pnpm build:lld:deps && pnpm desktop build:testing).
Invariant Violation: SEED is not set (environment) — process.env.SEED is empty in the test process. Ensure the test runs in a shell where SEED is exported (e.g. an e2e_env function sourcing it from 1Password). Never print the value.
speculos.py: error: unrecognized arguments: -p (environment) — image/code mismatch. The harness sets PLAYWRIGHT_RUN, so speculos-transport passes -p to speculos.py; an old cached :latest image doesn't support it. Fix by pinning to the tag the code expects and pulling it:bash
:latest is a moving tag and is NOT pinning; if you stay on it you must docker pull to refresh, and setting the env var alone never changes the cached image. (See "Speculos image" note below.)
WARNING: ... platform (linux/amd64) does not match host (arm64) (benign) — the Speculos image is amd64-only and runs under emulation on Apple Silicon. Not a failure; ignore.
speculos already in use / address already in use / port conflicts (environment) — stale Speculos containers from interrupted runs. Clean up: docker rm -f $(docker ps -a --filter name=speculos -q).
TypeError: Invalid Version: DS_Store (environment) — .DS_Store files in coin-apps break semver lookup: find "$COINAPPS" -name ".DS_Store" -type f -delete.
App + Speculos connect, but a specific Earn element isn't found (test-flow mismatch, not setup) — e.g. expecting the legacy stake modal when the flow now redirects to the Earn dashboard, or a provider card id changed. Check feature flags (FF_STAKE_PROGRAMS_MODAL list vs redirects, ethDepositCohort) and the current test ids in the Earn web app. Report it as a test/scenario issue, not an environment one.
Speculos image note: pin (sha-... / v...) for reproducible, comparable runs (this is what the bot/smoke CI jobs do); :latest tracks the current device/firmware matrix (what the broad e2e matrix uses) but drifts and must be re-pulled. A SHA hardcoded in your shell unblocks a run now but becomes a liability long-term as the code's expected image advances — prefer pinning per-run, or unset SPECULOS_IMAGE_TAG to follow the code's own default.
Validation before finishing (for code changes)
Run validation for the impacted E2E package(s), not the whole monorepo:
Desktop: pnpm --filter ledger-live-desktop-e2e-tests typecheck; run targeted earn.v2 / delegate Playwright tests when the environment allows.
Mobile: pnpm --filter ledger-live-mobile-e2e-tests typecheck; run targeted Detox earn specs when the environment allows.
Pre-commit runs oxfmt (formatting) + gitleaks. If oxfmt flags a file, apply exactly its suggested change.
Reuse an existing watch terminal when available before starting a new watcher. If unrelated pre-existing failures appear, report them as pre-existing and keep scope focused on Earn changes.
PR review comment workflow
For each comment:
Verify current code and usages (rg for symbol usage).
Classify: real change needed / duplicate / stale (already addressed).
Implement only real changes.
Prepare explicit PR replies for stale/duplicate/already-fixed comments.
Quick checklist
Scope confirmed with the user (earn.v2 / delegate / both; desktop and/or mobile).
Env verified (MOCK=0, SEED set but never printed, COINAPPS, pinned SPECULOS_IMAGE_TAG, SPECULOS_DEVICE); Docker running + image pulled.
Build freshness checked; rebuilt only when needed (and confirmed with the user).
Webview resolved via webviewIdentifier = "earn"; readiness via goAndWaitForEarnToBeReady.
No inline repeated test ids in specs when a page object exists; no dead selectors/helpers added.
Feature flags correct for the intended flow (list vs redirects, ethDepositCohort).
Failures classified (environment vs build vs test-flow) with a concrete fix.
Typecheck + relevant test commands attempted/reported.
E2E Earn 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.
A skill your agent uses when manually verifying a Chorus frontend change in a real browser — finding local login credentials, driving the running dev server with the Playwright MCP, logging in…
Find which open PRs are impacted by a migration/sunset/refactor and notify their authors — blocking review when the old path is already gone from develop, heads-up comment when it is only deprecated…
Check, update, and RUN Earn E2E tests for Ledger Wallet Desktop (Playwright) and Mobile (Detox). E2E Earn is an agent skill from LedgerHQ/ledger-live. Check, update, and RUN Earn E2E tests for Ledger Wallet Desktop (Playwright) and Mobile (Detox).
Run `npx skills add LedgerHQ/ledger-live --skill e2e-earn -a claude-code`. Or copy the skill folder (.agents/skills/e2e-earn in LedgerHQ/ledger-live) into .claude/skills/e2e-earn in your project. Claude Code loads it when a task matches its description.
How do I install E2E Earn in Codex?
Run `npx skills add LedgerHQ/ledger-live --skill e2e-earn -a codex`. Or copy the skill folder (.agents/skills/e2e-earn in LedgerHQ/ledger-live) into .agents/skills/e2e-earn in your project. Codex loads it when a task matches its description.
Can I use E2E Earn 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 LedgerHQ/ledger-live --skill e2e-earn -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/e2e-earn, .gemini/skills/e2e-earn, .github/skills/e2e-earn and .opencode/skills/e2e-earn in your project.
What does E2E Earn need to run?
Going by SKILL.md and its folder, E2E Earn needs the command-line tools its instructions call (pnpm, docker and npx). Our summary lists: Node.js; Docker.
Does E2E Earn access the network?
SKILL.md contains no URLs. Its commands use docker and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is E2E Earn 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 E2E Earn use?
E2E Earn 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 E2E Earn use?
About 3.8k tokens (SKILL.md is roughly 15k 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 E2E Earn?
Skills that share tags, products or a category with E2E Earn: E2E Verification (Chorus-AIDLC/Chorus, 1.2k stars), E2E Playwright (Asvarox/allkaraoke, 261 stars), Ha Frontend Testing (home-assistant/frontend, 5.7k stars) and Kouchou AI Testing (digitaldemocracy2030/kouchou-ai, 171 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains E2E Earn?
LedgerHQ (a GitHub organization) maintains it in LedgerHQ/ledger-live, which has 622 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 9, 2026.
Source: LedgerHQ/ledger-live on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.
