Wallet skills package (stellar-wallet-skills)

[aristidesstaffieri]

Part of the Improve Agent UX for Wallets epic.

Summary

stellar-skills is the agent-facing wallet: a package of markdown SKILL.md playbooks that direct an agent to compose existing CLI commands. Distributed separately from the CLI, cross-referenced with it (discoverable from the CLI and vice versa). The "wallet" is knowledge pushed outward — no stellar wallet namespace.

Contents

Prerequisites

• How to install stellar-cli on major operating systems.
• How to configure the CLI with an RPC and/or a Relayer.

Using the CLI as your wallet

• Setting up and managing keys; private-key security dos and don'ts.
• Funding an account; checking balance(s).
• Transaction details & examples (with references to docs).

Tokens

• Script to pull the list of trusted tokens; links to trustline docs.
• Deep token knowledge (anatomy of an asset).

Composition map (existing commands)

Wallet operation	Composed from
create / import / export / fund	keys generate / keys add / keys secret / keys fund
list / select	keys ls / keys use
balance / status / readiness	ledger entry fetch account / trustline, token balance
diagnose a tx	tx fetch --hash
trustline	tx new change_trust
submit a prepared XDR	tx sign + tx send
drain (sweep + close)	token transfer / tx new payment + account_merge

Tagging/renaming wallets has no existing support (config/alias.rs is contract-only) — left to a skill or out of scope for v0. Protocol discovery stays in the agent's skill layer; no in-CLI registry.

Acceptance criteria

• Agent session that proves the value of the skill, displays an agent using the skill to complete wallet actions more directly, using less token, and/or hitting fewer errors in the process.

Dependencies

Depends on the stellar token command and the structured-output/CLI-API task.

[aristidesstaffieri]

some prior art - https://github.com/tomerweller/stellar-wallets-skill/blob/main/SKILL.md