> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cesto.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Cesto Skill

> An AI agent skill that turns any coding agent into a full Cesto client: create baskets, simulate portfolios, and explore market data.

## What is the Cesto Skill?

The Cesto Skill is an open-source AI agent skill that lets you interact with the Cesto platform through natural conversation. It works with any AI coding agent that supports skills: Claude Code, Cursor, Windsurf, and more.

Create basket posts on Cesto Labs, simulate portfolio performance against the S\&P 500, browse baskets, and analyze token data, all without leaving your editor or terminal.

<CardGroup cols={2}>
  <Card title="Browse & Analyze" icon="magnifying-glass-chart">
    Explore all baskets, view detailed breakdowns, check token performance, and compare historical returns. No login required.
  </Card>

  <Card title="Create Baskets" icon="basket-shopping">
    Design and publish baskets to Cesto Labs with custom token allocations. Preview everything before it goes live.
  </Card>

  <Card title="Simulate Portfolios" icon="chart-line">
    Backtest any custom token allocation against the S\&P 500 benchmark with daily historical data.
  </Card>

  <Card title="Wallet Authentication" icon="wallet">
    One-click magic-link login: connect your Solana wallet in the browser and you're in. Tokens refresh silently.
  </Card>
</CardGroup>

## Installation

The skill lives at [`cesto-co/cesto-skills`](https://github.com/cesto-co/cesto-skills) on GitHub. Install it into any agent with a single command using the [Skills CLI](https://github.com/vercel-labs/skills) — there are no config files to edit by hand.

<Card title="Add to Claude Code" icon="terminal" horizontal>
  Paste this into your terminal and the Cesto Toolkit is ready:

  ```bash theme={null}
  npx skills add cesto-co/cesto-skills --skill cesto-toolkit
  ```
</Card>

The same one line works across Claude Code, Cursor, Codex, Windsurf, and 60+ other agents. A few common variants:

<CodeGroup>
  ```bash Current project theme={null}
  npx skills add cesto-co/cesto-skills --skill cesto-toolkit
  ```

  ```bash Every project (global) theme={null}
  npx skills add cesto-co/cesto-skills --skill cesto-toolkit --global
  ```

  ```bash A specific agent theme={null}
  npx skills add cesto-co/cesto-skills --skill cesto-toolkit --agent claude-code
  ```
</CodeGroup>

The skill activates automatically when you mention Cesto, baskets, portfolio simulation, or related terms in conversation.

## Authentication

The skill uses a magic-link flow: no manual token pasting required.

1. The skill detects that you're not logged in
2. Your browser opens to a wallet connection page
3. Connect your Solana wallet and sign a message
4. You're authenticated. Future sessions refresh silently

Credentials are stored securely at `~/.cesto/auth.json` with restricted file permissions. Tokens are never displayed in agent output.

<Note>
  Only basket creation and portfolio simulation require authentication. All browsing and analytics features work without logging in.
</Note>

## What you can do

### Browse all baskets

See every basket on Cesto with names, categories, risk levels, and performance stats.

```
Show me all baskets on Cesto
```

### View basket details

Dive into any basket: strategy, token breakdown, allocation percentages, and historical performance.

```
Tell me about the War Mode basket
```

### Analyze basket tokens

Get current market data for every token in a basket: prices, market caps, volume, and recent performance.

```
How are the tokens in War Mode performing?
```

### View performance history

See how a basket has performed against the S\&P 500 over time.

```
Show me the performance graph for War Mode
```

### Cross-basket analytics

Compare performance across all baskets to find top and bottom performers.

```
Compare all basket performance
```

### Create a basket on Cesto Labs

Design and publish your own basket with custom token allocations.

```
Create a basket with 40% SOL, 30% BONK, and 30% JUP
```

You'll preview the title, description, and allocation table before anything is published.

### Simulate a portfolio

Backtest a custom allocation against the S\&P 500 (both start at \$1,000).

```
Simulate a portfolio with 50% SOL and 50% USDC
```

Returns daily time series data with total return, comparison to benchmark, and key moments.

### Browse Cesto Labs

Explore community baskets, sort by new, trending, or top performers, and check the community leaderboard.

```
Show me the trending baskets on Cesto Labs
```

### Post and vote on Labs

Publish your own community basket, manage your posts, and back the ones you believe in.

```
Create a Labs post: 60% SOL, 40% JTO, titled "Solana Staking"
```