Agent skill

Building Storefronts

by medusajs in medusajs/medusa-agent-skills

Load automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns, data fetching).

No licenceAuto-check passedBackend & APIs

Install Building Storefronts

skills CLI
$ npx skills add medusajs/medusa-agent-skills --skill building-storefronts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install medusajs/medusa-agent-skills building-storefronts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/medusajs/medusa-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/medusa-dev/skills/building-storefronts .claude/skills/building-storefronts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
building-storefronts
GitHub stars
228
Used in
1 other repo
Token cost
~1.8k tokens
SKILL.md length
747 words
Files
2 (incl. references)
Skills in repo
16
Repo updated
First seen
Licence
None found

At a glance

Load automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns, data fetching).

  • Works in 4 steps: SDK Usage (CRITICAL) → React Query Patterns (HIGH) → Data Display (HIGH) → …
  • Tasks that involve Third-party API integration
  • SKILL.md covers When to Apply, CRITICAL: Load Reference Files…, Rule Categories by Priority and Quick Reference, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Building Storefronts is an agent skill from medusajs/medusa-agent-skills. Load automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns, data fetching). REQUIRED for all storefront development in ALL modes (planning, implementation, exploration). Contains SDK usage patterns, frontend integration, and critical rules for calling Medusa APIs.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/frontend-integration.md`).

It sits in Backend & APIs, covering Third-party API integration. It works with TanStack. The repository describes itself as: Agent skills and commands for Medusa best practices and conventions.

When your agent uses it

  • Tasks that involve Third-party API integration

Example prompts

  • “/building-storefronts”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. SDK Usage (CRITICAL)
  2. React Query Patterns (HIGH)
  3. Data Display (HIGH)
  4. Error Handling (MEDIUM)

What it can do on your machine

Read from SKILL.md and the folder at commit 066132d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Building Storefronts loads about 1.8k tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 96 tokens; SKILL.md has 747 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 747 words (~1,798 tokens).

“Frontend integration guide for building storefronts with Medusa. Covers SDK usage, React Query patterns, and calling custom API routes.”

— opening of SKILL.md by medusajs
name
building-storefronts

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in plugins/medusa-dev/skills/building-storefronts of medusajs/medusa-agent-skills.

  • SKILL.md
  • references/frontend-integration.md

Open the folder on GitHubat commit 066132d

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in medusajs/medusa-agent-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Building Storefronts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Building Storefronts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Building Storefronts this skillmedusajs/medusa-agent-skills2281 repos~1.8kAutomated safety check: PassNone
holaOS App Builder SDKholaboss-ai/holaOS11k—~11kAutomated safety check: PassCustom licence
Tanstack Query Best PracticesDeckardGer/tanstack-agent-skills2221 repos~1.2kAutomated safety check: PassMIT
AI ClientOpentrons/opentrons523—~1.6kAutomated safety check: PassApache-2.0
ActionsBuilderIO/agent-native7.1k—~4.4kAutomated safety check: PassNone
NEAR Intents Swap Integrationinternet-court/internet-court-skill6.5k1 repos~939Automated safety check: PassCustom licence

Similar skills

  • holaOS App Builder SDK

    holaboss-ai/holaOS

    Builds new holaOS apps with @holaboss/app-builder-sdk, either as integration-only MCP modules or as dashboard apps with a shadcn UI under src/client/.

    11k GitHub stars~11k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Tanstack Query Best Practices

    DeckardGer/tanstack-agent-skills

    TanStack Query (React Query) best practices for data fetching, caching, mutations, and server state management.

    222 GitHub starsUsed in 1 repo~1.2k tokens
    Backend & APIsAuto-check passed
  • AI Client

    Opentrons/opentrons

    Conventions for the opentrons-ai-client React/TypeScript frontend — project structure, API integration, state management (Jotai), feature flags, types, and testing.

    523 GitHub stars~1.6k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Actions

    BuilderIO/agent-native

    How to create and run agent actions. An agent skill from BuilderIO/agent-native.

    7.1k GitHub stars~4.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • NEAR Intents Swap Integration

    internet-court/internet-court-skill

    Builds cross-chain token swaps and bridge flows with the NEAR Intents 1Click API: quotes, deposit addresses, per-chain deposits and status polling.

    6.5k GitHub starsUsed in 1 repo~939 tokens
    Backend & APIsAuto-check passed
  • Shopify Expert

    Jeffallan/claude-skills

    Builds Shopify themes in Liquid, custom apps, Storefront API storefronts and checkout extensions, using the Shopify CLI to lint, run locally and deploy.

    12k GitHub stars~1.8k tokensUpdated 6 days ago
    Backend & APIsAuto-check passed

More from medusajs/medusa-agent-skills

All 16 skills in this repo
  • Medusa Internal Admin Agents

    medusajs/medusa-agent-skills

    Walks through adding an AI agent for store operators to a Medusa project: data models, module service, agent runtime, streaming API route and admin chat UI.

    228 GitHub stars~1.9k tokensUpdated 4 days ago
    Auto-check passed
  • Learning Medusa

    medusajs/medusa-agent-skills

    Interactive tutorial where the agent teaches Medusa development by guiding you through building a brands feature, with lessons and verification checkpoints.

    228 GitHub stars~4.1k tokensUpdated 4 days ago
    Auto-check passed
  • Medusa Cloud CLI Authentication

    medusajs/medusa-agent-skills

    Runs the mcloud commands for logging in, checking who is authenticated, and choosing the active organization, project and environment.

    228 GitHub stars~1.1k tokensUpdated 4 days ago
    Auto-check passed
  • Medusa Cloud Deployments CLI

    medusajs/medusa-agent-skills

    Lists Medusa Cloud deployments, fetches one deployment's details and reads backend or storefront build logs through the mcloud CLI to debug failed builds.

    228 GitHub stars~883 tokensUpdated 4 days ago
    Auto-check passed
  • mcloud Environments

    medusajs/medusa-agent-skills

    Runs mcloud environments commands to list, inspect, create, delete, redeploy or rebuild environments in Medusa Cloud projects.

    228 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed
  • Medusa Cloud Local Build

    medusajs/medusa-agent-skills

    Reproduces a Medusa Cloud build on your machine with mcloud local build, to debug build-failed deployments without pushing or waiting on Cloud.

    228 GitHub stars~1k tokensUpdated 4 days ago
    Auto-check: notes

Works with

Questions about Building Storefronts

What does Building Storefronts do?

Load automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns, data fetching). Building Storefronts is an agent skill from medusajs/medusa-agent-skills. Load automatically when planning, researching, or implementing Medusa storefront features (calling custom API routes, SDK integration, React Query patterns, data fetching).

When should I use Building Storefronts?

Building Storefronts fits situations like: tasks that involve Third-party API integration.

How do I install Building Storefronts in Claude Code?

Run `npx skills add medusajs/medusa-agent-skills --skill building-storefronts -a claude-code`. Or copy the skill folder (plugins/medusa-dev/skills/building-storefronts in medusajs/medusa-agent-skills) into .claude/skills/building-storefronts in your project. Claude Code loads it when a task matches its description.

How do I install Building Storefronts in Codex?

Run `npx skills add medusajs/medusa-agent-skills --skill building-storefronts -a codex`. Or copy the skill folder (plugins/medusa-dev/skills/building-storefronts in medusajs/medusa-agent-skills) into .agents/skills/building-storefronts in your project. Codex loads it when a task matches its description.

Can I use Building Storefronts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add medusajs/medusa-agent-skills --skill building-storefronts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/building-storefronts, .gemini/skills/building-storefronts, .github/skills/building-storefronts and .opencode/skills/building-storefronts in your project.

What does Building Storefronts need to run?

SKILL.md names no scripts, command-line tools or credentials: Building Storefronts is instructions for the agent only.

Does Building Storefronts access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Building Storefronts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Building Storefronts use?

No licence was found for Building Storefronts or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Building Storefronts use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Building Storefronts?

Skills that share tags, products or a category with Building Storefronts: holaOS App Builder SDK (holaboss-ai/holaOS, 11k stars), Tanstack Query Best Practices (DeckardGer/tanstack-agent-skills, 222 stars), AI Client (Opentrons/opentrons, 523 stars) and Actions (BuilderIO/agent-native, 7.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Building Storefronts?

medusajs (a GitHub organization) maintains it in medusajs/medusa-agent-skills, which has 228 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 5, 2026.

Source: medusajs/medusa-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.