Merge pull request #822 from ethersphere/feat/add-ai-skills-ref

feat: reference Swarm Quickstart Skills repo in docs

Author: yjkellyjoo

docs/develop/introduction.md

@@ -35,6 +35,15 @@ This is the go-to starting point for web3 developers who want to build with Swar
           <span class="hub-card__cta">Connect dApp</span>
         </a>
       </li>
+      <li class="hub-card">
+        <a class="hub-card__link" href="/docs/develop/tools-and-features/ai-agent-skills">
+          <h3 class="hub-card__title">Onboard with AI Skills</h3>
+          <p class="hub-card__desc">
+            Use the Swarm Quickstart Skills in Claude Code — type <code>/swarm</code> for guided, prerequisite-checking steps to set up a node and start building.
+          </p>
+          <span class="hub-card__cta">Start with AI</span>
+        </a>
+      </li>
     </ul>
   </div>
 

docs/develop/resources-md.md

@@ -88,7 +88,7 @@ description: A curated list of Swarm developer resources — docs, SDKs, example
 - [swarm-cli](/docs/bee/working-with-bee/swarm-cli/) — Command-line interface for uploads, feeds, and more
 - [swarm-mcp ↗](https://github.com/ethersphere/swarm-mcp) — MCP server for AI agents to read and write Swarm
 - [Swarm Actions ↗](https://github.com/ethersphere/swarm-actions) — Deploy to Swarm from GitHub CI/CD workflows
-- [Swarm Skills ↗](https://github.com/GasperX93/swarm-skills) — Claude Code integration for Swarm
+- [Swarm Quickstart Skills ↗](https://github.com/ethersphere/swarm-quickstart-skills) — Interactive Claude Code skills for guided Swarm onboarding
 
 ### Libraries & Primitives
 

docs/develop/tools-and-features/ai-agent-skills.md

@@ -0,0 +1,46 @@
+---
+title: AI Agent Skills
+id: ai-agent-skills
+description: Interactive Claude Code skills that guide you through setting up Bee and building on Swarm.
+---
+
+[Swarm Quickstart Skills](https://github.com/ethersphere/swarm-quickstart-skills)
+is a set of interactive guides ("skills") that run inside
+[Claude Code](https://claude.com/claude-code). Instead of copying commands from
+the docs by hand, the skills check your prerequisites first, run real commands
+against your Bee node, and explain what is happening at each step. Type `/swarm`
+and you are routed to the right next step for your current setup — installing a
+node, buying a postage stamp, uploading files, or scaffolding a dApp.
+
+## Requirements
+
+- [Claude Code](https://claude.com/claude-code)
+- Node.js 18+
+- A running Bee light node at `http://localhost:1633` (for most skills)
+  - The
+  easiest way to install is to run `/swarm` in Claude Code, which installs and starts a
+  light node for you. 
+  - Alternatively, check out the
+  [quick start](./../../bee/installation/quick-start.md)
+
+## Install
+
+Clone the repo and copy the `.claude/` folder into your project:
+
+```bash
+git clone https://github.com/ethersphere/swarm-quickstart-skills.git
+cp -r swarm-quickstart-skills/.claude/ /path/to/your-project/
+```
+
+Then open Claude Code in your project and start with the entry point:
+
+```bash
+cd your-project && claude
+```
+
+Type `/swarm` to begin. See the
+[swarm-quickstart-skills repository](https://github.com/ethersphere/swarm-quickstart-skills)
+for the full list of available skills.
+
+For a programmatic alternative aimed at agents, see the
+[swarm-mcp](https://github.com/ethersphere/swarm-mcp) MCP server.

docs/develop/tools-and-features/introduction.md

@@ -16,6 +16,10 @@ won't break the bank and can live forever!
 
 Swarm is designed with decentralised applications in mind, and much time has been devoted to designing tools and features to support their prototyping and development. 
 
+### AI Agent Skills
+
+In a hurry? The [Swarm Quickstart Skills](./ai-agent-skills.md) run inside Claude Code and walk you through setting up a Bee node and building on Swarm — just type `/swarm` and follow the guided steps.
+
 ### Bee JS
 
 Our maverick JavaScript team, the Bee-Gees (🕺), have been working hard in the last few months to build some impressive tools for all you budding dapp developer Bees to get stuck into! Find out how to use the [bee-js](./bee-js.md) JavaScript library to start creating your own that live and work on Swarm!