К основному содержанию
скилл CX Codex

walrus-sites — скилл для Claude Code: что делает и как установить

Скилл walrus-sites для Claude Code помогает публиковать и обновлять статические сайты на Walrus с привязкой к объектам Sui. Разворачивает локальный портал для тестнета и настраивает маршруты в ws-resources.json.

Apache-2.0 467 установок ★ 25 обновлён 2026-11-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add MystenLabs/skills --skill walrus-sites -a claude-code
Открыть на GitHub

Что делает walrus-sites

Разворачивает статический фронтенд в хранилище Walrus и регистрирует ресурсы через ончейн-объект Sui site::Site. Скилл содержит инструкции по работе с утилитой site-builder: публикация собранной папки с флагом --epochs, обновление сайта, проверка структуры через site-builder sitemap и удаление объекта командой site-builder destroy.

Помогает запустить локальный портал через Bun для тестирования сайтов в тестнете, так как публичный сервис wal.app обслуживает только мейннет. В файле portal-config.yaml параметр original_package_id должен указывать на системный пакет фреймворка Walrus Sites, а не на Move-пакет вашего смарт-контракта, иначе портал завершится с ошибкой.

Для одностраничных приложений скилл настраивает маршрутизацию в файле ws-resources.json, чтобы прямые переходы по путям не возвращали 404. Значение --epochs рекомендуется ставить от 30 и выше, потому что при меньшем сроке блобы быстро истекают и сайт перестаёт открываться. При наличии в окружении инструмента MCP скилл может запрашивать документацию через сервер https://sui.mcp.kapa.ai.

Какие задачи решает

  • опубликовать статический фронтенд в децентрализованное хранилище Walrus
  • настроить маршрутизацию для SPA в файле ws-resources.json
  • запустить локальный портал на Bun для просмотра сайта в тестнете
  • проверить срок хранения блобов и структуру сайта через site-builder sitemap

Примеры запросов агенту

  • Опубликуй папку dist на Walrus Sites со сроком хранения не менее 30 эпох
  • Настрой ws-resources.json, чтобы работал роутинг в SPA на клиенте
  • Помоги поднять локальный портал Walrus для тестнета через Bun

Как установить walrus-sites

1Через Skills CLI (Vercel)

npx skills add MystenLabs/skills --skill walrus-sites -a claude-code

2Вручную: положить файлы

~/.claude/skills/walrus-sites/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/walrus-sites/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о walrus-sites

Как установить walrus-sites в Claude Code?

Выполните команду npx skills add MystenLabs/skills --skill walrus-sites -a claude-code.

Что делает walrus-sites?

Скилл предоставляет инструкции для публикации сайтов на Walrus через site-builder, конфигурации ws-resources.json, управления сроком хранения блобов и запуска портала.

Почему сайт на тестнете Walrus выдаёт ошибку 404 на wal.app?

Публичный шлюз wal.app работает только с мейннетом. Для просмотра сайтов в тестнете необходимо развернуть собственный локальный портал на Bun.

Исходный текст

SKILL.md · Apache-2.0
---
name: walrus-sites
description: >
  Publishing, updating, and serving decentralized websites on Walrus Sites.
  Use when the user needs to deploy a frontend to Walrus Sites, run a local
  portal for testnet, debug site-builder errors, configure ws-resources.json,
  or manage site object lifecycle (update, destroy, extend blobs). Also use
  when the user asks about site-builder, walrus-sites, portal setup, or
  hosting a dApp on Walrus. For blob storage without the Sites framework
  (raw upload/download), see the `accessing-data` skill's walrus.md.
---

# Walrus Sites — Decentralized Website Hosting

> **MCP tool:** When available in your environment, also query the Sui documentation MCP server (`https://sui.mcp.kapa.ai`) for up-to-date answers. Use it for verification and for details not covered by these reference files.

Walrus Sites lets you deploy a static website (HTML/CSS/JS) to Walrus, with an on-chain Sui object tracking the site's resources. A portal server resolves site subdomains, fetches resources from Walrus, and serves them over HTTP. The result is a fully decentralized frontend — no centralized server, CDN, or DNS required.

> **Source constraint:** All information in this skill is sourced from the [MystenLabs/walrus-sites](https://github.com/MystenLabs/walrus-sites) repository and the [Walrus Sites documentation](https://docs.wal.app/docs/sites). When extending or updating this skill, only pull from these sources. Do not use third-party blogs or unofficial tutorials.

Common failures:

1. **Blobs expire.** Sites published with too few epochs silently break — the portal returns 404 once the blobs expire. Always use a generous `--epochs` value (30+).
2. **Portal misconfiguration.** The portal's `original_package_id` must match the Walrus Sites framework package (`site::Site`), not your app's Move package. The testnet example config ships with the correct value — don't change it.
3. **Testnet sites can't use `wal.app`.** The public `wal.app` portal only serves mainnet sites. Testnet requires a self-hosted local portal.
4. **SPA routing.** Single-page apps need `ws-resources.json` routes config to handle client-side routing. Without it, direct navigation to `/my-route` returns 404.

---

## Sub-skills

### publishing — Building and deploying sites
**Path:** `publishing/SKILL.md`
**Load when:** deploying a new site, updating an existing site, choosing epoch duration, configuring `ws-resources.json`, or troubleshooting `site-builder` errors.
**Covers:** `site-builder publish`, `site-builder update`, `--epochs` flag, blob expiration, `ws-resources.json` configuration, SPA routing, site naming, `site-builder sitemap` for debugging, `site-builder destroy`.

### portal — Running a local portal for testnet
**Path:** `portal/SKILL.md`
**Load when:** the user needs to view a testnet site, set up the local portal, fix portal 404s, or understand how portal resolution works.
**Covers:** cloning the portal, installing dependencies (Bun), `portal-config.yaml`, the `original_package_id` gotcha, starting the server, URL format, port conflicts, mainnet vs testnet differences.

---

## Routing guide

| Task | Load |
|------|------|
| Deploy a frontend to Walrus Sites | `publishing/` |
| Update an existing deployed site | `publishing/` |
| Fix 404 or expired site | `publishing/` + `portal/` |
| View a testnet site locally | `portal/` |
| Set up the local portal | `portal/` |
| Portal shows "Page not found" | `portal/` + `publishing/` (check blob expiry) |
| Configure SPA routing | `publishing/` |
| Check what resources a site has | `publishing/` (`site-builder sitemap`) |
| Delete a deployed site | `publishing/` |
| Choose between Walrus Sites and traditional hosting | Skill Content below |

---

## Skill Content

### Key concepts

- **Site object.** A Sui object of type `site::Site` (from the Walrus Sites framework package). It holds metadata (name, description) and dynamic fields mapping resource paths to Walrus blob references. Created by `site-builder publish`, owned by the publisher's address.

- **Resources.** Each file in the deployed directory becomes a resource stored on Walrus. Small files may be batched into a single "quilt" blob. Each resource has a path (e.g., `/index.html`, `/assets/main.js`) and optional HTTP headers.

- **Portal.** A server that maps `<base36-site-id>.localhost:3000` URLs to on-chain site objects. It reads the site's dynamic fields to find the requested resource path, fetches the blob from a Walrus aggregator, and returns it as an HTTP response. The portal is framework-level infrastructure, not part of your app.

- **`ws-resources.json`.** A configuration file in the site's root directory that controls resource headers, routing, and site metadata. Auto-generated on first publish with the site object ID. On subsequent runs, the site-builder reads it to determine whether to create a new site or update the existing one.

- **Blob expiration.** Walrus blobs have a finite storage duration measured in epochs. When blobs expire, the portal can no longer fetch them and returns 404. Use `site-builder sitemap <object-id>` to check expiration dates. Re-publish with a higher `--epochs` value to fix.

### Rules

1. **Always use `--epochs 30` or higher for testnet deploys.** Low values (like 5) cause blobs to expire within days. For production mainnet, use even higher values or `--permanent`.
2. **Build before publishing.** Run `npm run build` (or equivalent) to produce a static `dist/` directory. The site-builder publishes whatever directory you point it at.
3. **Don't change `original_package_id` in the portal config** unless you know the Walrus Sites framework package has been upgraded. The testnet example value is correct.
4. **`wal.app` is mainnet only.** For testnet, self-host the portal from the `MystenLabs/walrus-sites` repo.
5. **Check `ws-resources.json` after first publish.** It records the site object ID. Keep it in version control so future publishes update the existing site rather than creating a new one.

### Common mistakes

- **Publishing with `--epochs 5` and wondering why the site is gone a week later.** Blobs expired. Re-publish with `--epochs 30+`.
- **Changing the portal's `original_package_id` to your app's package ID.** The portal needs the Walrus Sites framework package ID (`site::Site`), not your Move contract's package ID. These are completely different things.
- **Trying to visit a testnet site on `wal.app`.** It only serves mainnet. You need a local portal for testnet.
- **Forgetting to build the frontend before publishing.** `site-builder publish dist/` publishes the `dist/` directory contents. If you didn't `npm run build` first, you're publishing source files or stale output.
- **Deploying an SPA without fallback routing.** React/Vue/Svelte SPAs use client-side routing. Direct navigation to `/borrows` hits the portal, which looks for `/borrows` as a resource — and it doesn't exist. Configure a fallback in `ws-resources.json`.
- **Not killing port 3000 before starting the portal.** Vite dev server, Next.js, or other tools often use port 3000. The portal silently fails to bind if the port is taken.

© MystenLabs · Apache-2.0 · MystenLabs/skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
render-static-sites Render Скилл render-static-sites помогает агенту развернуть статический сайт или SPA на CDN Render: команды сборки, путь публикации, роутинг, заголовки и превью из пул-реквестов. CX Codex +1 434установок design-loop jezweb Скилл design-loop ведёт цикл: читает задачу из файла-эстафеты, генерирует страницу в HTML/Tailwind, встраивает её в сайт и пишет следующую задачу. CX Codex +1 1 000установок bunshin AThevon Скилл bunshin для Claude Code собирает целый сайт или веб-приложение с нуля либо при полном редизайне. Субагенты исследуют, создают страницы и исправляют найденные проблемы. CX Codex +1 518установок build-awwwards-quality-sites MengTo Скилл build-awwwards-quality-sites задаёт правила арт-дирекшна и вёрстки интерактивных сайтов уровня Awwwards. Помогает внедрить анимации на GSAP, плавный скролл и WebGL-шейдеры без шаблонов. CX Codex +1 4 600установок build-daily-inspiration-sites MengTo Скилл build-daily-inspiration-sites для Claude Code превращает готовый UI-инспирационный захват из пяти элементов в пять отдельных Codex-задач по созданию оригинальных HTML-лендингов через Sites. CX Codex +1 1 600установок site-studio официальный Ayan Gupta Плагин site-studio помогает пошагово спланировать, наполнить и проверить секции личного сайта вместе с GitHub Copilot на общем рабочем холсте. ★ 41 430звёзд репо

Из того же набора30

Весь набор →
accessing-data Скилл accessing-data для Claude Code подсказывает архитектуру чтения данных из блокчейна Sui: gRPC, GraphQL RPC, Archival Store, Walrus или sui-indexer-alt. Включается при запросах балансов, объектов и миграции. CX Codex +1 491установок ptbs Скилл ptbs для Claude Code помогает писать, проверять и отлаживать Programmable Transaction Blocks в Sui. Подключается к задачам с TypeScript SDK, CLI, газом или спонсируемыми транзакциями. CX Codex +1 491установок sui-sdks Скилл sui-sdks для Claude Code помогает выбрать библиотеку для блокчейна Sui, сопоставить вызовы между языками и настроить проект. Агент подключает его при старте нового приложения или миграции кода. CX Codex +1 487установок frontend-apps Скилл frontend-apps для Claude Code помогает разрабатывать браузерные приложения для Sui. Подключает подсказки по кошелькам, чтению данных из блокчейна и отправке транзакций. CX Codex +1 479установок sui-client Скилл sui-client для Claude Code и Codex настраивает CLI Sui, переключает сети и помогает получать тестовые токены. Включается при работе с адресами, слиянии монет или ошибках с газом. CX Codex +1 403установок sui-overview Скилл sui-overview для Claude Code объясняет устройство блокчейна Sui и его экосистемы. Агент подключает его для сравнения Sui с Ethereum или Solana и при планировании приложения на Sui. CX Codex +1 400установок sui-publish Скилл sui-publish для Claude Code помогает собирать, публиковать и обновлять пакеты смарт-контрактов Sui Move. Включается при деплое в сети Sui, настройке UpgradeCap и разборе ошибок dry run. CX Codex +1 399установок generate-sui-agent-config Скилл generate-sui-agent-config для Claude Code и Codex создаёт файлы инструкций CLAUDE.md или AGENT.md в проектах на блокчейне Sui. Настраивает контекст агента при инициализации репозитория. CX Codex +1 391установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой