Add SKILL.md for Stellar CLI agents

[Copilot]

What

Adds SKILL.md — a structured reference document enabling AI agents to install and use the Stellar CLI effectively.

Why

Agents need a concise, scannable reference to bootstrap CLI usage without relying on scattered docs. Based on content iterated with Claude by @janewang, following the agent skills pattern from stellar-wallets-skill.

The file covers:

• Installation — install script, Homebrew, winget, Cargo, Nix, GitHub Actions, SVM
• Subcommands — full top-level command reference
• Common patterns — keys, networks, contract build/upload/deploy/invoke, aliases, SAC, TTL extension, restore, bindings, transactions, events, XDR
• Signing & fee options — source account formats, --sign-with-*, fee flags
• Important concepts — wasm upload vs deploy, state archival, slop pattern, aliases, friendbot
• Typical dev workflow — end-to-end from contract init to binding generation
• Safety rules — key hygiene, payment confirmation, testnet-first guidance

Known limitations

N/A

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add a SKILL.md for the CLI for agents</issue_title>
<issue_description>

What problem does your feature solve?

Help agents to learn how to use the CLI

What would you like to see?

A markdown file to help agents install the cli in their env, and to use the CLI

This is a good video series to learn about skills: https://anthropic.skilljar.com/introduction-to-agent-skills

Start with Tomer's markdown used with openclaw: tomerweller/stellar-wallets-skill@c5090b6

</issue_description>

Comments on the Issue (you are @copilot in this section)

@janewang Iterated on the following with Claude

# Stellar CLI Skill

## Overview
The Stellar CLI (`stellar`) is the command-line multi-tool for building, deploying, and interacting with Stellar smart contracts (Soroban) and the Stellar network. It's written in Rust and installed via `cargo install --locked stellar-cli`, Homebrew (`brew install stellar-cli`), or the install script.

Docs: https://developers.stellar.org/docs/tools/cli/stellar-cli
Cookbook: https://developers.stellar.org/docs/tools/cli/cookbook
Repo: https://github.com/stellar/stellar-cli

## Installation

### Install Script (macOS, Linux) — Recommended
```bash
curl -fsSL https://github.com/stellar/stellar-cli/raw/main/install.sh | sh

With dependency setup (installs Rust toolchain, wasm32 target, Linux dev libs):

curl -fsSL https://github.com/stellar/stellar-cli/raw/main/install.sh | sh -s -- --install-deps

Homebrew (macOS, Linux)

brew install stellar-cli

winget (Windows)

winget install --id Stellar.StellarCLI

Cargo from Source

Requires Rust and a C build system (build-essential on Debian/Ubuntu).

cargo install --locked stellar-cli

Without optional native library features:

cargo install --locked stellar-cli --no-default-features

Nix

nix run 'github:stellar/stellar-cli' -- --help
# or install permanently
nix profile install github:stellar/stellar-cli

GitHub Actions

uses: stellar/stellar-cli@v25.1.0

Version Manager

SVM (Stellar Version Manager) — install and switch between different stellar-cli versions.

Shell Autocomplete

# Generate completions (bash, zsh, fish, powershell, elvish)
stellar completion --shell bash

# Enable in current session
source > ~/.bashrc

Top-Level Subcommands

• contract — Build, deploy, invoke, extend, restore, and inspect smart contracts
• keys — Create and manage identities (key pairs, aliases)
• network — Configure connections to networks (testnet, mainnet, local)
• container — Start local networks in Docker containers (quickstart)
• tx — Build, sign, simulate, and send arbitrary transactions (up to 100 ops)
• events — Watch the network for contract events
• xdr — Decode and encode XDR
• strkey — Decode and encode strkey
• snapshot — Download a ledger snapshot from an archive
• cache — Manage transaction and contract spec cache
• ledger — Fetch ledger information
• message — Sign and verify arbitrary messages (SEP-53)
• fees — Fetch network fee stats and configure CLI fee settings
• completion — Generate shell completions (bash, zsh, fish, powershell, elvish)
• plugin — Manage CLI plugins
• doctor — Diagnose and troubleshoot CLI and network issues
• config — Manage CLI configuration
• env — Print environment variables

Global Options

• --config-dir <DIR> — Config directory (default: $XDG_CONFIG_HOME/stellar or ~/.config/stellar)
• -f, --filter-logs <FILTER> — Filter log output (or use RUST_LOG env var)
• -q, --quiet — Suppress logs including INFO
• -v, --verbose — Log DEBUG events
• --very-verbose / --vv — Log DEBUG and TRACE events
• --no-cache — Don't cache simulations/transactions

Common Patterns

Identity / Key Management

# Generate a new key and fund on testnet
stellar keys generate --fund alice --network testnet

# Generate without funding
stellar keys generate bob

# Add an existing public key
stellar keys add --public-key GBUG7Q... charlie

# Show address for a key
stellar keys address alice

# List all keys
stellar keys ls

Network Configuration

# Set default network to testnet
stellar network use testnet

# Add a custom network
stellar network add mynet --rpc-url https://rpc.example.com --network-passphrase "My Network"

# List networks
stellar network ls

Contract Build

# Build all cdylib crates in workspace for wasm32 target
stellar contract build

# Build specific package with optimization
stellar contract build --package my-contract --optimize

# Add metadata on build
stellar contract build --meta key=va...

</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

- Fixes stellar/stellar-cli#2409

<!-- START COPILOT CODING AGENT TIPS -->
---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more [Copilot coding agent tips](https://gh.io/copilot-coding-agent-tips) in the docs.