From d6453c96802c8096ed4cf13967097152ef1537f4 Mon Sep 17 00:00:00 2001 From: kaankacar Date: Mon, 2 Feb 2026 21:37:54 +0300 Subject: [PATCH 1/7] Add Stellar Development Skill to Building with AI page Restructure the page to focus on the most effective AI integration methods: - Add Stellar Development Skill as the primary solution with installation instructions for multiple platforms and methods - Add supported platforms table (OpenCode, OpenAI Codex, Pi, and others) - Add OpenSkills as alternative for Cursor, Windsurf, and Aider users - Remove generic AI tool UI tutorials that were not Stellar-specific and prone to becoming outdated - Remove Custom AI applications code example - Keep llms.txt, Stella, and Additional resources sections - Add note about more AI tool integrations coming soon - Add Building with AI page to llms.txt --- .../developer-tools/building-with-ai.mdx | 115 ++++++++---------- static/llms.txt | 1 + 2 files changed, 49 insertions(+), 67 deletions(-) diff --git a/docs/tools/developer-tools/building-with-ai.mdx b/docs/tools/developer-tools/building-with-ai.mdx index 3792fd897a..2a6540721c 100644 --- a/docs/tools/developer-tools/building-with-ai.mdx +++ b/docs/tools/developer-tools/building-with-ai.mdx @@ -9,97 +9,71 @@ 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/skill/` | +| [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. +```bash +npx skills add https://github.com/stellar/stellar-dev-skill +``` -- **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. +**Manual installation:** -#### Gemini +Clone the repository and copy the `skill/` directory to your agent's skills location (see table above). -Google's Gemini offers context customization through: +```bash +git clone https://github.com/stellar/stellar-dev-skill +cp -r stellar-dev-skill/skill ~/.claude/skills/stellar-dev +``` -- **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 use [OpenSkills](https://github.com/numman-ali/openskills)—a universal CLI that brings the Agent Skills system to any AI coding agent. -### 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: @@ -110,7 +84,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 diff --git a/static/llms.txt b/static/llms.txt index ec5488d9a1..5aa11bd52d 100644 --- a/static/llms.txt +++ b/static/llms.txt @@ -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 From 7476fb58e4feffd1770a5c1efdb779155dedb978 Mon Sep 17 00:00:00 2001 From: Kaan Kacar Date: Mon, 2 Feb 2026 21:46:09 +0300 Subject: [PATCH 2/7] Update docs/tools/developer-tools/building-with-ai.mdx Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/tools/developer-tools/building-with-ai.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/developer-tools/building-with-ai.mdx b/docs/tools/developer-tools/building-with-ai.mdx index 2a6540721c..8728ac8d0d 100644 --- a/docs/tools/developer-tools/building-with-ai.mdx +++ b/docs/tools/developer-tools/building-with-ai.mdx @@ -59,7 +59,7 @@ cp -r stellar-dev-skill/skill ~/.claude/skills/stellar-dev Once installed, your AI coding assistant will automatically have access to up-to-date Stellar development knowledge when you work on Stellar projects. -For other AI coding tools like Cursor, Windsurf, or Aider, you can use [OpenSkills](https://github.com/numman-ali/openskills)—a universal CLI that brings the Agent Skills system to any AI coding agent. +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. ## Using llms.txt From 12aacb609a0a4a8089f28b358c66b57f540a0d0a Mon Sep 17 00:00:00 2001 From: kaankacar Date: Mon, 2 Feb 2026 21:50:23 +0300 Subject: [PATCH 3/7] Format building-with-ai.mdx with prettier --- docs/tools/developer-tools/building-with-ai.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/developer-tools/building-with-ai.mdx b/docs/tools/developer-tools/building-with-ai.mdx index 8728ac8d0d..9a98aecf9b 100644 --- a/docs/tools/developer-tools/building-with-ai.mdx +++ b/docs/tools/developer-tools/building-with-ai.mdx @@ -28,7 +28,7 @@ The skill provides expertise in: The skill can be installed on any AI coding tool that supports the [Agent Skills](https://github.com/anthropics/agent-skills) standard: | Platform | Skills directory | -|----------|------------------| +| --- | --- | | [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `~/.claude/skills/` | | [OpenCode](https://opencode.ai) | `~/.config/opencode/skill/` | | [OpenAI Codex](https://openai.com/index/openai-codex/) | `~/.codex/skills/` | From 390b586ea8ebe1208b735da3fde45e63d57ba119 Mon Sep 17 00:00:00 2001 From: kaankacar Date: Tue, 3 Feb 2026 12:57:43 +0300 Subject: [PATCH 4/7] Update wording: security patterns -> security best practices --- docs/tools/developer-tools/building-with-ai.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/developer-tools/building-with-ai.mdx b/docs/tools/developer-tools/building-with-ai.mdx index 9a98aecf9b..72bedbac05 100644 --- a/docs/tools/developer-tools/building-with-ai.mdx +++ b/docs/tools/developer-tools/building-with-ai.mdx @@ -21,7 +21,7 @@ The skill provides expertise in: - Stellar Assets and Soroban tokens (SAC bridge) - Wallet integration (Freighter, Stellar Wallets Kit) - Smart accounts with passkeys -- Testing strategies and security patterns +- Testing strategies and security best practices ### Supported platforms From 95adc3cc37620dea7e75605d6d1b6ee615be081c Mon Sep 17 00:00:00 2001 From: kaankacar Date: Mon, 9 Feb 2026 17:14:02 +0300 Subject: [PATCH 5/7] Trigger preview build --- docs/tools/developer-tools/building-with-ai.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/developer-tools/building-with-ai.mdx b/docs/tools/developer-tools/building-with-ai.mdx index 72bedbac05..9a98aecf9b 100644 --- a/docs/tools/developer-tools/building-with-ai.mdx +++ b/docs/tools/developer-tools/building-with-ai.mdx @@ -21,7 +21,7 @@ The skill provides expertise in: - Stellar Assets and Soroban tokens (SAC bridge) - Wallet integration (Freighter, Stellar Wallets Kit) - Smart accounts with passkeys -- Testing strategies and security best practices +- Testing strategies and security patterns ### Supported platforms From 2d2ab75dd7ec646c13305f5cb91d9be2427f97b6 Mon Sep 17 00:00:00 2001 From: kaankacar Date: Mon, 9 Feb 2026 17:48:09 +0300 Subject: [PATCH 6/7] Simplify manual installation instructions --- docs/tools/developer-tools/building-with-ai.mdx | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/docs/tools/developer-tools/building-with-ai.mdx b/docs/tools/developer-tools/building-with-ai.mdx index 9a98aecf9b..37dfcaf408 100644 --- a/docs/tools/developer-tools/building-with-ai.mdx +++ b/docs/tools/developer-tools/building-with-ai.mdx @@ -50,12 +50,7 @@ npx skills add https://github.com/stellar/stellar-dev-skill **Manual installation:** -Clone the repository and copy the `skill/` directory to your agent's skills location (see table above). - -```bash -git clone https://github.com/stellar/stellar-dev-skill -cp -r stellar-dev-skill/skill ~/.claude/skills/stellar-dev -``` +[Clone the repository](https://github.com/stellar/stellar-dev-skill) and copy the `skill/` directory to your agent's skills location (see table above). Once installed, your AI coding assistant will automatically have access to up-to-date Stellar development knowledge when you work on Stellar projects. From 2693d91aa1ba61917a6e3e9a1f63e49771a2ffcc Mon Sep 17 00:00:00 2001 From: Kaan Kacar Date: Mon, 9 Feb 2026 17:50:11 +0300 Subject: [PATCH 7/7] Update docs/tools/developer-tools/building-with-ai.mdx Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/tools/developer-tools/building-with-ai.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/developer-tools/building-with-ai.mdx b/docs/tools/developer-tools/building-with-ai.mdx index 37dfcaf408..9cd7275e2f 100644 --- a/docs/tools/developer-tools/building-with-ai.mdx +++ b/docs/tools/developer-tools/building-with-ai.mdx @@ -30,7 +30,7 @@ The skill can be installed on any AI coding tool that supports the [Agent Skills | Platform | Skills directory | | --- | --- | | [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `~/.claude/skills/` | -| [OpenCode](https://opencode.ai) | `~/.config/opencode/skill/` | +| [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/` |