rikka-site

Build resource-oriented server applications with automatic content negotiation and hydration.

6|1|Updated May 31, 2026
One-click install
npx skills add https://github.com/yw662/rikka --skill rikka-site
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rikka-site
Source: https://github.com/yw662/rikka/tree/main/skills/rikka-site
Command: npx skills add https://github.com/yw662/rikka --skill rikka-site

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rikka-site removes the complexity of hand-wiring server routes, serializers, and hydration logic by treating every URL as a resource with predictable HTTP behavior.

Core Features & Use Cases

  • Resource kinds: Model collections, items, singletons, read-only pages, actions, proxies, and static files as explicit resource classes.
  • Content negotiation: Serve HTML, JSON, JSON-LD, CSV, CBOR, or protobuf from the same endpoint without duplicating handlers.
  • Full-stack hydration: Pair SSR output with client components, SDK helpers, and router integration for interactive applications.
  • Use Case: Build an authenticated blog, dashboard, or API-driven product where the server, client elements, and edge deployment all share one resource tree.

Quick Start

Ask the AI to create a rikka-site app by defining your site tree, handlers, transformers, and hydration components in a single resource-oriented implementation.

Frequently Asked Questions about rikka-site

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a resource-oriented server with automatic content negotiation?

To build a resource-oriented server with content negotiation, model URLs as explicit resource classes like collections and items, then register transformers to automatically serve formats such as HTML, JSON, and CSV from a single endpoint.

How does server-side rendering hydration work with custom elements?

Server-side rendering hydration with custom elements works by pairing SSR output with client components and SDK helpers, requiring explicit Repr-based handlers and router integration to serialize and hydrate interactive applications.

Can I deploy a resource-oriented server app across Node and edge runtimes?

Yes, you can deploy a resource-oriented server app across Node and edge runtimes by defining a single resource tree that supports server-side rendering serialization and client-side routing for both environments.

What is the best way to serve multiple data formats like JSON-LD and protobuf from one endpoint?

The best way to serve multiple formats like JSON-LD and protobuf from one endpoint is using a resource-oriented server that applies automatic content negotiation, preventing the need to duplicate handlers for each specific format.

Do I need explicit Repr-based handlers to serve static assets and proxies?

Yes, you need explicit Repr-based handlers and kind-based resource classes to serve static assets and proxies, ensuring predictable HTTP behavior across collections, items, actions, and auth-gated routes.

What are the limitations of using a resource-oriented server for full-stack web apps?

A limitation of using this resource-oriented server is the prerequisite to define explicit transformers and kind-based resource classes, which requires upfront structural planning before serving any data formats or hydrating client components.