Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
112 changes: 44 additions & 68 deletions docs/tools/developer-tools/building-with-ai.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,97 +9,66 @@ sidebar_position: 118

Stellar provides resources to help AI assistants and Large Language Models (LLMs) understand our documentation, making it easier for you to get accurate answers about Stellar development.

## Using llms.txt

[`llms.txt`](https://developers.stellar.org/llms.txt) is a standardized way to provide documentation context to AI systems. This file contains a structured overview of Stellar's developer documentation optimized for LLM consumption.

When you ask an AI assistant about Stellar, it can reference this file to:

- Understand the structure of our documentation
- Find relevant pages for your questions
- Provide more accurate, up-to-date answers
## Stellar Development Skill

## Using with AI assistants
The [Stellar Development Skill](https://github.com/stellar/stellar-dev-skill) is a comprehensive AI skill that gives coding assistants deep knowledge of the Stellar ecosystem. It follows the open [Agent Skills](https://github.com/anthropics/agent-skills) standard, making it compatible with multiple AI coding tools.

### ChatGPT, Claude, and other LLMs
The skill provides expertise in:

You can paste the contents of `llms.txt` into your conversation to give the AI context about Stellar:
- Soroban smart contracts (Rust SDK)
- JavaScript, Python, and Go SDKs for client applications
- Stellar RPC and Horizon APIs
- Stellar Assets and Soroban tokens (SAC bridge)
- Wallet integration (Freighter, Stellar Wallets Kit)
- Smart accounts with passkeys
- Testing strategies and security patterns

```
Please read this documentation overview and help me with Stellar development:
[paste contents of https://developers.stellar.org/llms.txt]
```

### AI-powered coding assistants

Tools like GitHub Copilot, Cursor, Claude or Gemini can benefit from having `llms.txt` in your project context when working on Stellar-related code.

#### Cursor
### Supported platforms

You can provide Cursor with Stellar development context in two ways:
The skill can be installed on any AI coding tool that supports the [Agent Skills](https://github.com/anthropics/agent-skills) standard:

**Option 1: Using Cursor Settings**
| Platform | Skills directory |
| --- | --- |
| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `~/.claude/skills/` |
| [OpenCode](https://opencode.ai) | `~/.config/opencode/skills/` |
| [OpenAI Codex](https://openai.com/index/openai-codex/) | `~/.codex/skills/` |
| [Pi](https://github.com/badlogic/pi-mono) | `~/.pi/agent/skills/` |

1. Open **Cursor Settings** (the gear icon in the sidebar)
2. Navigate to **Rules** (under the **Features** section)
3. Click **Add Rule**
4. Add your Stellar development guidelines and save
### Installation

**Option 2: Using a `.cursorrules` file**
**Claude Code:**

Create a `.cursorrules` file in your project root:

```text title=".cursorrules"
When developing on Stellar, refer to the official documentation at https://developers.stellar.org

For comprehensive documentation context, fetch and reference: https://developers.stellar.org/llms.txt

Key resources:
- Smart Contracts: https://developers.stellar.org/docs/build/smart-contracts
- Stellar CLI: https://developers.stellar.org/docs/tools/cli
- SDKs: https://developers.stellar.org/docs/tools/sdks
```bash
/plugin marketplace add stellar/stellar-dev-skill
```

The Settings approach applies rules globally across all projects, while `.cursorrules` files are project-specific.

#### ChatGPT
**Using npx (works with any compatible tool):**

ChatGPT offers two ways to provide persistent context:

- **Custom Instructions**: Go to Settings → Personalization → Custom Instructions to add information about yourself and how you'd like ChatGPT to respond. You can include that you're a Stellar developer and prefer references to official documentation.

- **Custom GPTs**: Create a custom GPT with Stellar documentation context built in. You can configure it to reference `llms.txt` and provide specialized Stellar development assistance.

#### Claude

Claude provides context customization through:

- **Projects**: Create a project and add custom instructions along with knowledge files. You can upload relevant documentation or add instructions to always reference the Stellar docs.

- **Memory**: Claude can remember details from past conversations. You can ask Claude to remember that you're working on Stellar development, and it will retain this context across sessions.
```bash
npx skills add https://github.com/stellar/stellar-dev-skill
```

#### Gemini
**Manual installation:**

Google's Gemini offers context customization through:
[Clone the repository](https://github.com/stellar/stellar-dev-skill) and copy the `skill/` directory to your agent's skills location (see table above).

- **Gems**: Create custom Gems (specialized AI assistants) with specific instructions for Stellar development. Go to the Gems section in Gemini and create a new Gem with your Stellar context and guidelines.
Once installed, your AI coding assistant will automatically have access to up-to-date Stellar development knowledge when you work on Stellar projects.

- **Saved Info**: In Gemini settings, you can add saved information about yourself, including that you're a Stellar developer, which Gemini will reference in future conversations.
For other AI coding tools like Cursor, Windsurf, or Aider, you can consider the community-maintained [OpenSkills](https://github.com/numman-ali/openskills) CLI, which aims to bring the Agent Skills system to a wide range of AI coding agents. OpenSkills is a third-party project and not an official Stellar offering, so be sure to review the repository and its documentation to verify that it meets your security and maintenance requirements before using it.

### Custom AI applications
## Using llms.txt

If you're building an AI application that answers questions about Stellar, you can fetch and include `llms.txt` in your prompt context:
[`llms.txt`](https://developers.stellar.org/llms.txt) is a standardized way to provide documentation context to AI systems. This file contains a structured overview of Stellar's developer documentation optimized for LLM consumption.

```javascript
const response = await fetch("https://developers.stellar.org/llms.txt");
const stellarContext = await response.text();
When you ask an AI assistant about Stellar, it can reference this file to:

// Include stellarContext in your LLM prompt
```
- Understand the structure of our documentation
- Find relevant pages for your questions
- Provide more accurate, up-to-date answers

## Stella: Your Stellar AI Assistant

In addition to `llms.txt`, Stellar provides [Stella](https://developers.stellar.org/docs/tools/developer-tools/ai-bot), an AI assistant specifically trained on Stellar documentation, code examples, and community knowledge.
[Stella](https://developers.stellar.org/docs/tools/developer-tools/ai-bot) is an AI assistant specifically trained on Stellar documentation, code examples, and community knowledge.

Stella can help you with:

Expand All @@ -110,7 +79,14 @@ Stella can help you with:

You can chat with Stella right here by clicking the yellow icon at the bottom of this page, or join the `#stella-help` channel in the [Stellar Developer Discord](https://discord.gg/stellardev).

## Other AI tools

Any AI assistant with custom context features can benefit from Stellar's resources. You can add `llms.txt` to your tool's context settings, or paste its contents directly into conversations to give the AI knowledge about Stellar development.

Popular tools like ChatGPT, Claude, Gemini, and Cursor all support adding custom context through their settings. We're actively working on dedicated integrations for more AI tools—check back for updates or follow the [Stellar Development Skill repository](https://github.com/stellar/stellar-dev-skill) for the latest supported platforms.

## Additional resources

- [Stellar Development Skill](https://github.com/stellar/stellar-dev-skill) - Comprehensive AI skill for coding assistants
- [Stella AI Bot](https://developers.stellar.org/docs/tools/developer-tools/ai-bot) - Stellar's built-in AI assistant
- [Stellar Developer Discord](https://discord.gg/stellardev) - Ask questions in #stella-help
1 change: 1 addition & 0 deletions static/llms.txt
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,7 @@ Developer Tools
- [OpenZeppelin Relayer](https://developers.stellar.org/docs/tools/openzeppelin-relayer)
- [OpenZeppelin Contracts](https://developers.stellar.org/docs/tools/openzeppelin-contracts)
- [Scaffold Stellar](https://developers.stellar.org/docs/tools/scaffold-stellar)
- [Building with AI](https://developers.stellar.org/docs/tools/developer-tools/building-with-ai)
- [More Developer Tools](https://developers.stellar.org/docs/tools/developer-tools)

Ramps
Expand Down