Agent skill

Coin Families Contract

by LedgerHQ in LedgerHQ/ledger-live

Coin-specific families logic must live in families/. An agent skill from LedgerHQ/ledger-live.

MITAuto-check passedBackend & APIs

Install Coin Families Contract

skills CLI
$ npx skills add LedgerHQ/ledger-live --skill coin-families-contract -a claude-code

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

GitHub CLI
$ gh skill install LedgerHQ/ledger-live coin-families-contract --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/LedgerHQ/ledger-live.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/coin-families-contract .claude/skills/coin-families-contract && 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
coin-families-contract
GitHub stars
622
Token cost
~1k tokens
SKILL.md length
421 words
Files
1
Skills in repo
51
Repo updated
First seen
Licence
MIT

At a glance

Coin-specific families logic must live in families/. An agent skill from LedgerHQ/ledger-live.

  • Works in 3 steps: Define a slot on the contract → Implement only in the family → Use the contract in generic code
  • Tasks that involve Smart contracts
  • SKILL.md covers Do not do (anti-patterns), Do (correct pattern), Reference example: Scan Device… and Paths
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Coin Families Contract is an agent skill from LedgerHQ/ledger-live. Coin-specific families logic must live in families/. Generic UI uses the families contract only (no if (family === "evm") in shared code). Use this guidance for work in "/families/", "/mvvm/", "/renderer/" and "/screens/".

Its SKILL.md is about 1k 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 Backend & APIs, covering Smart contracts. The repository describes itself as: Mono-repository for Ledger Wallet apps and related packages. The licence is MIT.

When your agent uses it

  • Tasks that involve Smart contracts

Example prompts

  • “) in shared code). Use this guidance for work in”
  • “/mvvm/”
  • “/renderer/”
  • “/coin-families-contract”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Define a slot on the contract
  2. Implement only in the family
  3. Use the contract in generic code

What it can do on your machine

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

Coin Families Contract loads about 1k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 421 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~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 LedgerHQ/ledger-live at commit 46bd13a, republished under its MIT licence (© LedgerHQ). 421 words, ~1,049 tokens.

Download SKILL.mdSave it as .claude/skills/coin-families-contract/SKILL.md (or your agent's skills folder).
name
coin-families-contract
description
Coin-specific families logic must live in families/. Generic UI uses the families contract only (no if (family === "evm") in shared code). Use this guidance for work in "**/families/**", "**/mvvm/**", "**/renderer/**" and "**/screens/**".

Coin families contract (Desktop & Mobile UI)

Principle: Coin-specific UI and behavior must live in families/. Generic screens, hooks, and components must not branch on family === "evm" (or any family name). They must use the families contract: optional slots defined in the family type, implemented per family, and consumed via a single lookup (e.g. getLLDCoinFamily(currency.family).SlotName). This keeps generic code family-agnostic and supports modularisation and lazy loading.

Do not do (anti-patterns)

  • Generic code (outside families/<family>/):
    • if (currency.family === "evm") / if (transaction.family === "solana") to render or behave differently.
    • Coin-specific hooks or logic in shared ViewModels / screens (e.g. Canton onboarding branch inside a generic Scan Device VM).
    • Importing a specific coin module (e.g. @ledgerhq/coin-canton) in generic UI to branch on that coin.
  • Exception: Type-narrowing inside a family folder (e.g. invariant(transaction.family === "bitcoin", "...") in families/bitcoin/) is acceptable; the rule applies to generic (shared) code only.

Do (correct pattern)

  1. Define a slot on the contract

    • Desktop: Add an optional property to LLDCoinFamily in apps/ledger-live-desktop/src/renderer/families/types.ts (e.g. NoAssociatedAccounts?: React.ComponentType<...>).
    • Mobile: Use the same idea: a typed contract (or generated map like noAssociatedAccountsByFamily) that families can optionally fill.
  2. Implement only in the family

    • Put the component or logic in families/<family>/ (e.g. families/hedera/NoAssociatedAccounts.tsx) and export it from the family index (Desktop: in the object passed to generated; Mobile: in the generated aggregation if applicable).
  3. Use the contract in generic code

    • Generic code looks up by family and uses the slot if present, with no if (family === "hedera"):
    • Desktop: getLLDCoinFamily(currency.family).NoAssociatedAccounts → use it when defined.
    • Mobile: e.g. getCustomNoAssociatedAccounts(currency) returning a component from a family map, then pass it to the screen (e.g. as CustomNoAssociatedAccounts in route params).
Show full SKILL.md (155 more words)Show less

Reference example: Scan Device "no associated accounts"

  • Contract (Desktop):
    apps/ledger-live-desktop/src/renderer/families/types.ts — NoAssociatedAccounts?: React.ComponentType<AddAccountsStepProps> on LLDCoinFamily.
  • Family implementation:
    apps/ledger-live-desktop/src/renderer/families/hedera/NoAssociatedAccounts.tsx and hedera/index.ts exporting it in the family object.
  • Generic usage (Desktop):
    StepImport.tsx / useScanAccounts.ts: getLLDCoinFamily(mainCurrency.family).NoAssociatedAccounts — no Hedera-specific branch.
  • Generic usage (Mobile):
    useScanDeviceAccountsViewModel.ts: getCustomNoAssociatedAccounts(currency) from ~/generated/NoAssociatedAccounts; result passed as CustomNoAssociatedAccounts to the NoAssociatedAccounts screen. No if (family === "hedera") in the VM.

When you need new coin-specific behavior in a generic flow (e.g. post-add-account navigation, custom empty state): extend the contract (add a new optional slot and document it), implement it in the relevant family folder, and have the generic code only read from the contract. Do not add new if (family === "…") branches in shared UI.

Paths

  • Desktop: apps/ledger-live-desktop/src/renderer/families/ — contract in types.ts, implementations per family, aggregation in generated.ts; generic code under renderer/, mvvm/.
  • Mobile: apps/ledger-live-mobile/src/families/ — family-specific UI and flows; generic code under mvvm/, screens/. Use generated maps or a small helper (e.g. getCustomNoAssociatedAccounts) so generic code never branches on family name.

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

Files

Just SKILL.md in .agents/skills/coin-families-contract of LedgerHQ/ledger-live.

Open the folder on GitHubat commit 46bd13a

Compare with similar skills

Coin Families Contract 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.

Coin Families Contract compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Coin Families Contract this skillLedgerHQ/ledger-live622—~1kAutomated safety check: PassMIT
Fizz Convertpashov/skills1.2k2 repos~3.7kAutomated safety check: PassMIT
Solana Devsolana-foundation/solana-dev-skill573—~3.8kAutomated safety check: PassMIT
Feynman Auditor0xiehnnkta/nemesis-auditor2431 repos~11kAutomated safety check: PassMIT
Smart Contract Auditgreatpie/smart-contract-audit-skill101—~1.1kAutomated safety check: PassNone
RadarAuditware/radar154—~2.1kAutomated safety check: PassGPL-3.0

Similar skills

  • Fizz Convert

    pashov/skills

    Convert English-language properties in PROPERTIES.md (produced by the Fizz skill) into Solidity assertions inside the existing fuzz harness, then flip their checkboxes.

    1.2k GitHub starsUsed in 2 repos~3.7k tokens
    Backend & APIsAuto-check passed
  • Solana Dev

    solana-foundation/solana-dev-skill

    A skill your agent uses when user asks to "build a Solana dapp", "write an Anchor program", "create a token", "debug Solana errors", "set up wallet connection", "test my Solana program", "fuzz my…

    573 GitHub stars~3.8k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Feynman Auditor

    0xiehnnkta/nemesis-auditor

    Deep business logic bug finder using the Feynman technique. An agent skill from 0xiehnnkta/nemesis-auditor.

    243 GitHub starsUsed in 1 repo~11k tokens
    Backend & APIsAuto-check passed
  • Smart Contract Audit

    greatpie/smart-contract-audit-skill

    Script-backed, out-of-box auditing workflow for Solidity/EVM repositories based on EVMbench detect/patch/exploit methodology.

    101 GitHub stars~1.1k tokensUpdated 7 mo ago
    Backend & APIsAuto-check passed
  • Radar

    Auditware/radar

    Use radar for smart contract security analysis, AST generation, and detection template development.

    154 GitHub stars~2.1k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Solidity Auditor

    Gabson0x/bountyforge

    Security audit of Solidity code while you develop. An agent skill from Gabson0x/bountyforge.

    442 GitHub stars~3.7k tokensUpdated 24 days ago
    Backend & APIsAuto-check passed

More from LedgerHQ/ledger-live

All 51 skills in this repo
  • Impacting PRs

    LedgerHQ/ledger-live

    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…

    622 GitHub stars~3.3k tokensUpdated yesterday
    Auto-check passed
  • Cloud Sync Module

    LedgerHQ/ledger-live

    Write, review or debug a cloudSyncModule.ts — a CloudSyncDataManager that syncs one slice of user data through Ledger Sync (Cloud Sync).

    622 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Codeownership

    LedgerHQ/ledger-live

    Maintain CODEOWNERS file and team directories. An agent skill from LedgerHQ/ledger-live.

    622 GitHub stars~687 tokensUpdated yesterday
    Auto-check passed
  • Data Layer Advanced

    LedgerHQ/ledger-live

    Structure a Ledger Wallet data layer where one API response serves several entities.

    622 GitHub stars~509 tokensUpdated yesterday
    Auto-check passed
  • Debug Rn Native Crash

    LedgerHQ/ledger-live

    Investigate native React Native crashes (Fabric/Hermes/iOS) in ledger-live-mobile when JS error logs are missing or unhelpful.

    622 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Detect Data Leaks

    LedgerHQ/ledger-live

    Detect new PII leaks introduced by the current branch. An agent skill from LedgerHQ/ledger-live.

    622 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Coin Families Contract

What does Coin Families Contract do?

Coin-specific families logic must live in families/. An agent skill from LedgerHQ/ledger-live. Coin Families Contract is an agent skill from LedgerHQ/ledger-live. Coin-specific families logic must live in families/.

When should I use Coin Families Contract?

Coin Families Contract fits situations like: tasks that involve Smart contracts.

How do I install Coin Families Contract in Claude Code?

Run `npx skills add LedgerHQ/ledger-live --skill coin-families-contract -a claude-code`. Or copy the skill folder (.agents/skills/coin-families-contract in LedgerHQ/ledger-live) into .claude/skills/coin-families-contract in your project. Claude Code loads it when a task matches its description.

How do I install Coin Families Contract in Codex?

Run `npx skills add LedgerHQ/ledger-live --skill coin-families-contract -a codex`. Or copy the skill folder (.agents/skills/coin-families-contract in LedgerHQ/ledger-live) into .agents/skills/coin-families-contract in your project. Codex loads it when a task matches its description.

Can I use Coin Families Contract 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 coin-families-contract -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/coin-families-contract, .gemini/skills/coin-families-contract, .github/skills/coin-families-contract and .opencode/skills/coin-families-contract in your project.

What does Coin Families Contract need to run?

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

Does Coin Families Contract 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 Coin Families Contract 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 Coin Families Contract use?

Coin Families Contract 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 Coin Families Contract use?

About 1k tokens (SKILL.md is roughly 4.2k 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 Coin Families Contract?

Skills that share tags, products or a category with Coin Families Contract: Fizz Convert (pashov/skills, 1.2k stars), Solana Dev (solana-foundation/solana-dev-skill, 573 stars), Feynman Auditor (0xiehnnkta/nemesis-auditor, 243 stars) and Smart Contract Audit (greatpie/smart-contract-audit-skill, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Coin Families Contract?

LedgerHQ (a GitHub organization) maintains it in LedgerHQ/ledger-live, which has 622 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 10, 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.