Agent skill

Vechain Kit

by vechain in vechain/x-app-template

VeChain Kit and dapp-kit packages — installation, hooks, components, wallet connection, social login, smart accounts, theming, and Privy setup.

MITAuto-check passedFrontend & Design

Install Vechain Kit

skills CLI
$ npx skills add vechain/x-app-template --skill vechain-kit -a claude-code

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

GitHub CLI
$ gh skill install vechain/x-app-template vechain-kit --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/vechain/x-app-template.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/vechain-kit .claude/skills/vechain-kit && 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
vechain-kit
GitHub stars
450
Token cost
~1.4k tokens
SKILL.md length
650 words
Files
8 (incl. references)
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

VeChain Kit and dapp-kit packages — installation, hooks, components, wallet connection, social login, smart accounts, theming, and Privy setup.

  • Works in 6 steps: Check Node version → Detect project structure → Choose the right library → …
  • Tasks that involve Smart contracts
  • SKILL.md covers CRITICAL RULES, Scope, Default stack and Operating procedure, plus 1 more section
  • Calls nvm and npm

What it does

Vechain Kit is an agent skill from vechain/x-app-template. VeChain Kit and dapp-kit packages — installation, hooks, components, wallet connection, social login, smart accounts, theming, and Privy setup.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `references/frontend-dappkit.md`, `references/kit-components.md` and `references/kit-hooks.md`).

It sits in Frontend & Design, covering Smart contracts and Theming and dark mode. It works with React. The repository describes itself as: Vechain VeBetterDAO X-App template. The licence is MIT.

When your agent uses it

  • Tasks that involve Smart contracts
  • Tasks that involve Theming and dark mode

Example prompts

  • “/vechain-kit”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Check Node version
  2. Detect project structure
  3. Choose the right library
  4. Clarify before implementing
  5. Implement with VeChain-specific correctness
  6. Verify and deliver

What it can do on your machine

Read from SKILL.md and the folder at commit 8692b6a. 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:

    • nvm
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, 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

Vechain Kit loads about 1.4k tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 39 tokens; SKILL.md has 650 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~17k

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 vechain/x-app-template at commit 8692b6a, republished under its MIT licence (© vechain). 650 words, ~1,438 tokens.

Download SKILL.mdSave it as .claude/skills/vechain-kit/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
vechain-kit
description
VeChain Kit and dapp-kit packages — installation, hooks, components, wallet connection, social login, smart accounts, theming, and Privy setup.
license
MIT
metadata.author
VeChain
metadata.version
0.1.0

VeChain Kit Skill

CRITICAL RULES

  1. Read reference files FIRST. When the user's request involves any topic in the reference table below, read those files before doing anything else — before writing code, before making decisions. Briefly mention which files you are reading so the user can confirm the skill is active (e.g., "Reading VeChain Kit reference...").
  2. Information priority for VeChain topics: (a) Reference files in this skill — always the primary source. (b) VeChain MCP tools — use @vechain/mcp-server for on-chain data, transaction building, and live network queries; use Kapa AI MCP for VeChain documentation lookups. (c) Web search — only as a last resort, and only for topics NOT covered in the reference files.
  3. Prefer working directly in the main conversation for VeChain tasks. Plan mode and subagents do not inherit skill context and may fall back to web search instead of using reference files.
  4. After compaction or context loss, re-read this SKILL.md to restore awareness of the reference table and operating procedure before continuing work.

Scope

Use this Skill for the VeChain Kit and dapp-kit packages specifically:

  • VeChain Kit: installation, setup, configuration, Privy integration
  • dapp-kit: lightweight wallet connection for non-React or minimal setups
  • Wallet connection, social login (email, Google, passkey), smart accounts
  • Pre-built UI components (WalletButton, TransactionModal)
  • Hooks (useWallet, useSendTransaction, useCallClause, token/domain/oracle hooks)
  • Theming and Privy setup
  • i18n with react-i18next: bi-directional language sync (Kit ↔ host app), pre-commit/ESLint for missing or unused translation keys

For generic frontend patterns (React Query, Turborepo, state management, Chakra UI, transaction UX), see the frontend skill.

Default stack

LayerDefaultAlternative
Frontend@vechain/vechain-kit@vechain/dapp-kit-react (lightweight/non-React)
NodeNode 20 LTS (managed via nvm)--

Operating procedure

1. Check Node version

Before installing dependencies or running any command:

  • Check if .nvmrc exists in the project root. If yes, run nvm use.
  • If .nvmrc does not exist, create one with 20 (Node 20 LTS) and run nvm use.
2. Detect project structure
  • turbo.json present → follow Turborepo conventions (apps/frontend, packages/*)
  • Use useThor for Thor client access (both VeChain Kit and dapp-kit v2). useConnex is deprecated everywhere.
  • Apply conditional patterns (Chakra UI, i18n, Zustand) only when the project uses them
3. Choose the right library

When to ask the user: If the project doesn't already use VeChain Kit or dapp-kit and the user hasn't specified which to use, ask before choosing. Key questions:

  • Do you need social login (email, Google, passkey)? → VeChain Kit
  • Do you want pre-built UI modals and hooks (WalletButton, TransactionModal, token hooks)? → VeChain Kit
  • Do you want a lightweight wallet-only integration with minimal dependencies? → dapp-kit
  • Non-React framework? → dapp-kit
Show full SKILL.md (229 more words)Show less
4. Clarify before implementing

When the user's request is ambiguous or could be solved multiple ways, ask before building. Separate research from implementation.

5. Implement with VeChain-specific correctness
  • Network: always explicit (mainnet/testnet/solo)
  • Social login: Generic Delegator auto-enabled (users pay gas in VET/VTHO/B3TR); app-sponsored delegation optional for better UX; smart accounts; pre-fetch data before sendTransaction
6. Verify and deliver

A task is not complete until all applicable gates pass:

  1. Code compiles — no build errors (npm run build or equivalent succeeds)
  2. Tests pass — existing tests still pass; new logic has test coverage
  3. Risk notes documented — any signing, fee, or token-transfer implications are called out

Reference files

Read the matching files BEFORE doing anything else. See Critical Rules above.

TopicFileRead when user mentions...
Setup & configreferences/kit-setup.mdInstalling VeChain Kit, provider setup, CSS framework, Tailwind, env vars, login methods, legal documents, ecosystem apps, common pitfalls
Hooksreferences/kit-hooks.mduseWallet, useCallClause, useSendTransaction, useBuildTransaction, useSignMessage, contract reads, transactions, VET domains, NFTs, blockchain hooks, language/currency, @vechain/contract-getters
Components & modalsreferences/kit-components.mdWalletButton, TransactionModal, TransactionToast, modal hooks, isolated views
Social loginreferences/kit-social-login.mdSocial login, smart accounts, account abstraction, Privy setup, fee delegation for social login, DIY social login
Themingreferences/kit-theming.mdTheming, colors, fonts, buttons, glass effects, bottom sheet, Chakra UI compatibility, webpack fallbacks
dapp-kitreferences/frontend-dappkit.mddapp-kit, DAppKitProvider, lightweight wallet
Translations + Kitreferences/translations-vechain-kit.mdi18n, translations, language sync, VeChain Kit language, missing translations, pre-commit, ESLint, unused keys

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

Files

SKILL.md and 7 other files (references) in .agents/skills/vechain-kit of vechain/x-app-template.

  • SKILL.md
  • references/frontend-dappkit.md
  • references/kit-components.md
  • references/kit-hooks.md
  • references/kit-setup.md
  • references/kit-social-login.md
  • references/kit-theming.md
  • references/translations-vechain-kit.md

Open the folder on GitHubat commit 8692b6a

Compare with similar skills

Vechain Kit 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.

Vechain Kit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vechain Kit this skillvechain/x-app-template450—~1.4kAutomated safety check: PassMIT
Frontend UXaustintgriffith/ethskills295—~1.5kAutomated safety check: PassNone
UI UX Pro Maxsaoudi-h/solar-icons19018 repos~11kAutomated safety check: NotesCustom licence
Ask Sonnerleepokai/Codync2324 repos~1.8kAutomated safety check: WarnApache-2.0
Tailwind CSS Patternsever-works/ever-works1623 repos~1.6kAutomated safety check: NotesAGPL-3.0
Golemuigolemui/golemui113—~2.2kAutomated safety check: PassMIT

Similar skills

  • Frontend UX

    austintgriffith/ethskills

    Frontend UX rules for Ethereum dApps that prevent the most common AI agent UI bugs.

    295 GitHub stars~1.5k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • UI UX Pro Max

    saoudi-h/solar-icons

    UI/UX design intelligence for web and mobile. An agent skill from saoudi-h/solar-icons.

    190 GitHub starsUsed in 18 repos~11k tokens
    Frontend & DesignAuto-check: notes
  • Ask Sonner

    leepokai/Codync

    Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and…

    232 GitHub starsUsed in 4 repos~1.8k tokens
    Frontend & DesignAuto-check: warnings
  • Tailwind CSS Patterns

    ever-works/ever-works

    Provides comprehensive Tailwind CSS utility-first styling patterns including responsive design, layout utilities, flexbox, grid, spacing, typography, colors, and modern CSS best practices.

    162 GitHub starsUsed in 3 repos~1.6k tokens
    Frontend & DesignAuto-check: notes
  • Golemui

    golemui/golemui

    Build, validate, and debug GolemUI forms in React, Angular, Vue, Lit, or vanilla JS.

    113 GitHub stars~2.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Graz

    graz-sh/graz

    React hooks for Cosmos blockchain interactions — connect wallets, query balances, send tokens, sign messages.

    123 GitHub stars~4.2k tokensUpdated 23 days ago
    Frontend & DesignAuto-check passed

More from vechain/x-app-template

All 11 skills in this repo
  • Create Vechain Dapp

    vechain/x-app-template

    Scaffold a VeChain dApp with Next.js, VeChain Kit, Chakra UI v3, and GitHub Pages deployment.

    450 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Secure GitHub Actions

    vechain/x-app-template

    Secure GitHub Actions workflows against supply-chain, privilege, and shell-injection risks.

    450 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Translate

    vechain/x-app-template

    Manages translation files for react-i18next. An agent skill from vechain/x-app-template.

    450 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Frontend

    vechain/x-app-template

    Generic frontend development patterns for VeChain dApps — React Query, Turborepo architecture, state management, Chakra UI, i18n, loading states, and transaction UX.

    450 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Smart Contract Development

    vechain/x-app-template

    Solidity smart contract development on VeChainThor — Hardhat setup, ERC-20/721 patterns, upgradeable contracts, gas optimization, testing with Thor Solo, security auditing, and ABI codegen.

    450 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Vebetterdao

    vechain/x-app-template

    VeBetterDAO and X2Earn app development — B3TR/VOT3 tokens, reward distribution, sustainability proofs, app submission, governance, VeVote, quadratic funding, B3MO Quests, and navigators.

    450 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about Vechain Kit

What does Vechain Kit do?

VeChain Kit and dapp-kit packages — installation, hooks, components, wallet connection, social login, smart accounts, theming, and Privy setup. Vechain Kit is an agent skill from vechain/x-app-template. VeChain Kit and dapp-kit packages — installation, hooks, components, wallet connection, social login, smart accounts, theming, and Privy setup.

When should I use Vechain Kit?

Vechain Kit fits situations like: tasks that involve Smart contracts; tasks that involve Theming and dark mode.

How do I install Vechain Kit in Claude Code?

Run `npx skills add vechain/x-app-template --skill vechain-kit -a claude-code`. Or copy the skill folder (.agents/skills/vechain-kit in vechain/x-app-template) into .claude/skills/vechain-kit in your project. Claude Code loads it when a task matches its description.

How do I install Vechain Kit in Codex?

Run `npx skills add vechain/x-app-template --skill vechain-kit -a codex`. Or copy the skill folder (.agents/skills/vechain-kit in vechain/x-app-template) into .agents/skills/vechain-kit in your project. Codex loads it when a task matches its description.

Can I use Vechain Kit 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 vechain/x-app-template --skill vechain-kit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vechain-kit, .gemini/skills/vechain-kit, .github/skills/vechain-kit and .opencode/skills/vechain-kit in your project.

What does Vechain Kit need to run?

Going by SKILL.md and its folder, Vechain Kit needs the command-line tools its instructions call (nvm and npm).

Does Vechain Kit access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Vechain Kit 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 Vechain Kit use?

Vechain Kit is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vechain Kit use?

About 1.4k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 15k tokens, read only when the agent opens those files.

What are the alternatives to Vechain Kit?

Skills that share tags, products or a category with Vechain Kit: Frontend UX (austintgriffith/ethskills, 295 stars), UI UX Pro Max (saoudi-h/solar-icons, 190 stars), Ask Sonner (leepokai/Codync, 232 stars) and Tailwind CSS Patterns (ever-works/ever-works, 162 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vechain Kit?

vechain (a GitHub organization) maintains it in vechain/x-app-template, which has 450 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on July 20, 2026.

Source: vechain/x-app-template on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.