datapages-architecture

datapages-architecture is a skill for Claude Code, Codex from romshark/datapages. It costs 59 tokens per session (2,267 once invoked), scanned A, original, MIT.

A planning guide for Datapages, a framework for building web applications. It helps decide where application data lives, how browser updates happen, where request handlers go, and how many server processes are needed.

In plain words
What is it for?
Use it before other Datapages skills when starting an app or feature, especially to choose state storage, authentication handling, event use, and server structure.
Why use it?
It reduces architectural guesswork before implementation and helps keep server data, user commands, and live updates organised.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

Good fit Use it before other Datapages skills when starting an app or feature, especially to choose state storage, authentication handling, event use, and server structure.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/romshark/datapages/datapages-architecture
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add romshark/datapages --skill datapages-architecture
Clone the repo
git clone --depth 1 https://github.com/romshark/datapages

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for datapages-architecture

README.md
[![agentmods](https://agentmods.dev/badge/skills/romshark/datapages/datapages-architecture/github.svg)](https://agentmods.dev/skills/romshark/datapages/datapages-architecture)
Your own site
<a href="https://agentmods.dev/skills/romshark/datapages/datapages-architecture"><img src="https://agentmods.dev/badge/skills/romshark/datapages/datapages-architecture/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for datapages-architecture

Your own site · 80×15
<a href="https://agentmods.dev/skills/romshark/datapages/datapages-architecture"><img src="https://agentmods.dev/badge/skills/romshark/datapages/datapages-architecture.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 59 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,267 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00059 $0.02267
Opus 5.5 $0.00024 $0.00907
Sonnet 5 $0.00012 $0.00453
Haiku 4.5 $0.00006 $0.00227

Measured yesterday against content hash d1762c756b9a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-23, from the pricing page.

Security

Grade A, and why

datapages-architecture scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

example/calculator/.agents/skills/datapages-architecture/SKILL.md · 201 lines

How it starts

The opening of the file, as written. The whole thing — 201 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Architecture

Read datapages first for the build loop, hard rules and naming conventions.

Use this skill to choose the Datapages constructs a feature needs. Ask the operator when a missing requirement would change that choice. Then read the referenced skill before implementing the selected construct.

Keep authoritative state on the server, separate reads from commands and send complete page updates instead of small DOM patches.

New app

datapages init  # go.mod, app/app.go, cmd/server/main.go, compose.yaml, Makefile, CI
make up         # start the broker
make dev        # datapages watch

init creates PageIndex, PageError404, PageError500, Head and RecoverError. It writes only missing files and deletes nothing. You can run it again without overwriting existing files.

Before the first page, decide:

question decides
Are users authenticated? Session data type and the Session alias shared by all handlers. See datapages-sessions.
What does a handler need besides the request? App fields. A page has no named dependency fields, only App *App.
Can data change without the reader acting? Whether events are needed. See datapages-events.
Will one or multiple server processes run? Broker, session store and data placement. See Server topology.

Add sessions, state and events when a feature needs them, not upfront.

Before implementation

Do not guess requirements that change the application model. Ask the operator when they are unclear.

unknown determines
Authentication or per-user data Whether data belongs in a session. See datapages-sessions.
Persistence What must survive a process restart and where it is stored.
External changes Whether data can change without the current tab acting and needs events. See datapages-events.
Per-tab server state Whether a handler without a request needs tab-local values.
URL state Whether a value must be shareable or survive reload.
Server topology Whether one or multiple server processes will run. See Server topology.
Shared routes Whether a handler belongs to a page, *App or an embedded shared type.

Read the full file on GitHub · 201 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday Changed d1762c756b9a
  2. 2d ago First seen · 201 lines · 59 tokens per session scan A 33e50e5109ca

Subscribe to this mod's changes

datapages-architecture is a skill published in the GitHub repository romshark/datapages (91 stars, last pushed today), licensed MIT. It adds 59 tokens to every session and 2,267 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-21.

Related

Other skills, from other repositories

om-system-extension

Extend installed Open Mercato modules through UMES enrichers, interceptors, mutation guards, widgets, menus, entity extensions, events, component/page replacements, and overrides. Use for "extend core", "add field/column/action", "hide page", "intercept API", "UMES", or "rozszerz moduł".

open-mercato/open-mercato · 73 tokens

frontmcp-development

Use when building any FrontMCP server component other than a tool (for tools, use create-tool). Covers @Resource static resources and parameterized URI templates; @Prompt reusable prompts (RAG, multi-turn); @Provider singleton dependency-injection providers (database pools, API clients); @Agent autonomous LLM agents…

agentfront/frontmcp · 196 tokens

webmcp

Build agent-friendly web apps with the W3C Web Model Context API (WebMCP). Use when exposing frontend features as structured tools for in-browser AI agents, adding document.modelContext tools to React/Next.js apps, designing tool schemas for dashboards or admin UIs, or making existing UI automatable without DOM…

clubpay/ronykit · 69 tokens

composition-patterns

Design reusable React component APIs that scale — compound components, lifted state, generic context, explicit variants. Use when a component is growing boolean props (isThread, isEditing…), when building a component library, or when reviewing component architecture. Includes React 19 API changes.

clubpay/ronykit · 58 tokens

csharp-skills

Use when developing with .NET/C# for Web APIs, ORM data access, Excel/Word file I/O, spreadsheet controls, error tracking, or .NET code protection. Index of 9 skills: Furion, Admin.NET Backend, Admin.NET Frontend, SqlSugar, NPOI, SOD, ReoGrid, DotNet Reactor, Sentry.

znlgis/opengis-skills · 79 tokens

structpages

Guide for building Go web applications with the structpages framework (struct-based routing + templ + HTMX). Use when writing routes, pages, page groups, Props methods, handler methods (ServeHTTP), page components, partials, HTMX partial rendering and nested swap levels, URL generation (URLFor/ID/IDTarget)…

jackielii/structpages · 103 tokens