New to Claude Skills? Learn how to install them →

composiohq on GitHub

Artifacts Builder

Free

Create complex HTML artifacts for claude.ai effortlessly.

Get this skill

Free · Opens the source repo

What Artifacts Builder does

Artifacts Builder is a suite of tools designed for developers looking to create sophisticated HTML artifacts for claude.ai using modern frontend technologies. It leverages a robust stack that includes React 18, TypeScript, Vite, and Tailwind CSS, along with shadcn/ui components. This skill is particularly useful for projects that require state management, routing, or the integration of multiple components, making it ideal for developers who need to build intricate user interfaces beyond simple HTML/JSX files.

The workflow begins with initializing a new project using the provided script, which sets up a fully configured React application complete with Tailwind CSS and shadcn/ui components. Developers can then customize their artifacts by editing the generated code to fit their specific needs. Once the development is complete, the bundling script consolidates all code, JavaScript, and CSS into a single HTML file, ready for sharing. This process ensures that the resulting artifact is self-contained and can be easily distributed in conversations with users.

The skill also emphasizes design best practices, advising against common pitfalls that can lead to unappealing layouts, such as excessive centered designs and uniform styling. By following the provided guidelines, developers can create visually appealing and functional artifacts that enhance user experience. Additionally, while testing the artifact is optional, it is recommended to do so after sharing to avoid unnecessary delays in presenting the final product.

Overall, Artifacts Builder is tailored for frontend developers and designers who want to streamline the process of creating and sharing complex HTML artifacts within the claude.ai environment. Its comprehensive setup and bundling capabilities make it a valuable addition for those aiming to leverage modern web technologies in their projects.

When to use it

Use this skill when you need to build multi-component artifacts that require advanced features like state management and routing.

When not to use it

This skill is not suitable for simple, single-file HTML/JSX projects that do not require the full capabilities of a modern frontend stack.

What you can build with it

Creating a Multi-Component Artifact

Use Artifacts Builder to set up a project with multiple shadcn/ui components for a rich user experience.

Bundling for Easy Sharing

After developing your artifact, bundle it into a single HTML file for seamless sharing in claude.ai conversations.

Following Design Guidelines

Utilize the design guidelines provided to avoid common pitfalls and create visually appealing artifacts.

How to install Artifacts Builder

View source

1. Install with the skills CLI

npx skills add composiohq/awesome-claude-skills/artifacts-builder --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by composiohq

Artifacts Builder

To build powerful frontend claude.ai artifacts, follow these steps:

  1. Initialize the frontend repo using scripts/init-artifact.sh
  2. Develop your artifact by editing the generated code
  3. Bundle all code into a single HTML file using scripts/bundle-artifact.sh
  4. Display artifact to user
  5. (Optional) Test the artifact

Stack: React 18 + TypeScript + Vite + Parcel (bundling) + Tailwind CSS + shadcn/ui

Design & Style Guidelines

VERY IMPORTANT: To avoid what is often referred to as "AI slop", avoid using excessive centered layouts, purple gradients, uniform rounded corners, and Inter font.

Quick Start

Step 1: Initialize Project

Run the initialization script to create a new React project:

bash scripts/init-artifact.sh <project-name>
cd <project-name>

This creates a fully configured project with:

  • ✅ React + TypeScript (via Vite)
  • ✅ Tailwind CSS 3.4.1 with shadcn/ui theming system
  • ✅ Path aliases (@/) configured
  • ✅ 40+ shadcn/ui components pre-installed
  • ✅ All Radix UI dependencies included
  • ✅ Parcel configured for bundling (via .parcelrc)
  • ✅ Node 18+ compatibility (auto-detects and pins Vite version)

Step 2: Develop Your Artifact

To build the artifact, edit the generated files. See Common Development Tasks below for guidance.

Step 3: Bundle to Single HTML File

To bundle the React app into a single HTML artifact:

bash scripts/bundle-artifact.sh

This creates bundle.html - a self-contained artifact with all JavaScript, CSS, and dependencies inlined. This file can be directly shared in Claude conversations as an artifact.

Requirements: Your project must have an index.html in the root directory.

What the script does:

  • Installs bundling dependencies (parcel, @parcel/config-default, parcel-resolver-tspaths, html-inline)
  • Creates .parcelrc config with path alias support
  • Builds with Parcel (no source maps)
  • Inlines all assets into single HTML using html-inline

Step 4: Share Artifact with User

Finally, share the bundled HTML file in conversation with the user so they can view it as an artifact.

Step 5: Testing/Visualizing the Artifact (Optional)

Note: This is a completely optional step. Only perform if necessary or requested.

To test/visualize the artifact, use available tools (including other Skills or built-in tools like Playwright or Puppeteer). In general, avoid testing the artifact upfront as it adds latency between the request and when the finished artifact can be seen. Test later, after presenting the artifact, if requested or if issues arise.

Reference

Frequently asked questions about Artifacts Builder

Similar skills