Skip to main content
skill CX Codex

vtex-io-session-apps — Claude Code skill: what it does, how to install

vtex-io-session-apps — a skill for building and debugging VTEX IO session transform apps that compute state for storefront, pricing, and checkout from session inputs.

no license 1,200 installs ★ 47 updated 2026-10-14

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add vtex/skills --skill vtex-io-session-apps -a claude-code
Open on GitHub

What vtex-io-session-apps does

The skill applies when integrating with the VTEX session system (vtex.session): explains how an app declares input and output fields in configuration.json, how VTEX builds a dependency graph (DAG) between transforms, and when one transform reruns because another changed. Covers the split between public.* (input surface for shopper intent) and private namespaces (profile, storefront-permissions, checkout) as the read model for frontend.

The skill forbids duplicating another app's output fields: if storefront-permissions owns costcenter, your transform must read that field as input, not write its own copy. Without account and workspace in LRU cache keys, a transform will return data from the wrong workspace. To propagate values into native transforms, update their input fields (public.postalCode) instead of overwriting checkout.postalCode directly.

The skill targets VTEX IO and B2B scenarios where storefront-permissions, custom transforms, and checkout interact through session.

What it helps with

  • declare input and output fields of a session transform in configuration.json
  • read storefront-permissions.costcenter and compute myapp.priceTable
  • update public.postalCode to rerun the checkout transform
  • cache an external backend request via VBase stale-while-revalidate
  • request specific session fields on the frontend via items=rona.storeNumber

Example prompts for the agent

  • Write a VTEX IO session transform that reads storefront-permissions.organization and outputs myapp.storeNumber
  • Explain why my transform runs twice when public.country changes
  • Show configuration.json for a transform that depends on profile and storefront-permissions

How to install vtex-io-session-apps

1Skills CLI (Vercel)

npx skills add vtex/skills --skill vtex-io-session-apps -a claude-code

2Manually: put the files in place

~/.claude/skills/vtex-io-session-apps/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/vtex-io-session-apps/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about vtex-io-session-apps

How to install vtex-io-session-apps in Claude Code?

Run npx skills add vtex/skills --skill vtex-io-session-apps -a claude-code, then open ~/.claude/skills/vtex-io-session-apps/SKILL.md.

What does vtex-io-session-apps do?

The skill helps build VTEX IO session transform apps: explains the dependency graph (DAG), input/output split, namespace ownership, and caching rules inside transforms.

Why can't I duplicate another app's fields in my namespace?

Copying fields like costcenter from storefront-permissions into your namespace creates two sources of truth. On partial session updates, consumers read inconsistent values and race conditions appear.

Similar skills

All skills for Backend and APIs →

From the same set46

The whole set →
faststore-storefront Guides AI coding agents through VTEX FastStore storefront development: React 18 components, section overrides, SCSS styling constraints, and CMS schema sync. CX Codex +1 1,200installs vtex-io-service-paths-and-cdn vtex-io-service-paths-and-cdn picks the right path prefix in service.json and matches Cache-Control to the data, so edge caching does not serve one shopper's payload to another. CX Codex +1 1,200installs vtex-io-messages-and-i18n vtex-io-messages-and-i18n keeps user-facing copy in the VTEX IO messages infrastructure instead of hardcoded strings in JSX and resolvers. CX Codex +1 1,200installs vtex-io-security-boundaries vtex-io-security-boundaries guides coding assistants when auditing route exposure and data boundaries in VTEX IO apps. Prevents tenant leaks and enforces payload validation. CX Codex +1 1,200installs vtex-io-events-and-workers vtex-io-events-and-workers guides the agent in writing VTEX IO event handlers and workers that survive duplicate delivery. Useful when slow work should leave your HTTP routes. CX Codex +1 1,200installs vtex-io-service-configuration-apps vtex-io-service-configuration-apps guides the agent through building VTEX IO configuration apps using the configuration builder. Helps inject decoupled workspace settings into service runtimes. CX Codex +1 1,200installs vtex-io-app-contract Checks the VTEX IO app contract in manifest.json, including builders and dependency links. Use it when creating, splitting, or publishing apps. CX Codex +1 1,200installs vtex-io-service-runtime vtex-io-service-runtime guides the runtime layout of a VTEX IO backend app: the Service entrypoint, typed context, and service.json execution settings. CX Codex +1 1,200installs

Project sponsors

Companies that keep this analytics open