web-artifacts-builder skill
scriptsCreates complex, multi-component React artifacts for Claude.ai using Tailwind CSS and shadcn/ui, bundled into a single self-contained HTML file.
- GitHub stars
- 7
- Files
- 5
- Last commit
- May 12, 2026
- License
- MIT
- Allowed tools
- —
What does the web-artifacts-builder skill do?
web-artifacts-builder creates complex, multi-component React artifacts for Claude.ai using Tailwind CSS and shadcn/ui, bundled into a single self-contained HTML file.
Summary generated from the skill's SKILL.md.
About the web-artifacts-builder skill
Building complex, multi-component React applications for Claude.ai is the primary function of this toolset. Developers use it when they need to move beyond simple single-file JSX and instead create sophisticated frontend artifacts that require state management, routing, or advanced UI elements. The process begins by running the init-artifact.sh script to set up a React 18 and TypeScript environment via Vite, which includes Tailwind CSS and over 40 pre-installed shadcn/ui components.
Once the code is developed, the bundle-artifact.sh script uses Parcel and html-inline to consolidate all JavaScript, CSS, and dependencies into a single, self-contained bundle.html file. This resulting file is designed to be shared directly in Claude conversations as a functional artifact. The workflow relies on Node 18 or higher and specific bundling dependencies like parcel-resolver-tspaths to ensure path aliases work correctly within the final output.
What an agent can do with it
- 1Bundle code into one fileConvert a full React application into a single HTML file for sharing in a chat.
- 2Create advanced UI componentsBuild artifacts that utilize complex components and Radix UI dependencies.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the web-artifacts-builder skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the web-artifacts-builder skill in Plugin
/plugin marketplace add AvinashP/AgentsAtlas /plugin install agents-atlas@agents-atlas
Install the web-artifacts-builder skill in Claude Code
~/.claude/skills/web-artifacts-builder/SKILL.md
$ npx degit AvinashP/AgentsAtlas/skills/web-artifacts-builder ~/.claude/skills/web-artifacts-builderInstall the web-artifacts-builder skill in Claude Code (project)
.claude/skills/web-artifacts-builder/SKILL.md
$ npx degit AvinashP/AgentsAtlas/skills/web-artifacts-builder .claude/skills/web-artifacts-builderInstall the web-artifacts-builder skill in Codex
~/.agents/skills/web-artifacts-builder/SKILL.md
$ npx degit AvinashP/AgentsAtlas/skills/web-artifacts-builder ~/.agents/skills/web-artifacts-builderInstall the web-artifacts-builder skill in Gemini CLI
~/.gemini/skills/web-artifacts-builder/SKILL.md
$ npx degit AvinashP/AgentsAtlas/skills/web-artifacts-builder ~/.gemini/skills/web-artifacts-builderInstall the web-artifacts-builder skill in Claude.ai
npx degit AvinashP/AgentsAtlas/skills/web-artifacts-builder web-artifacts-builder && zip -r web-artifacts-builder.zip web-artifacts-builder # claude.ai → Customize → Skills → + → Create skill → Upload a skill → web-artifacts-builder.zip
SKILL.md
View on GitHubWeb Artifacts Builder
To build powerful frontend claude.ai artifacts, follow these steps:
- Initialize the frontend repo using
scripts/init-artifact.sh - Develop your artifact by editing the generated code
- Bundle all code into a single HTML file using
scripts/bundle-artifact.sh - Display artifact to user
- (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
.parcelrcconfig 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
- shadcn/ui components: https://ui.shadcn.com/docs/components
Files in this skill
5web-artifacts-builder skill questions
How do I install the web-artifacts-builder skill in Claude Code?
Run npx degit AvinashP/AgentsAtlas/skills/web-artifacts-builder ~/.claude/skills/web-artifacts-builder. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the web-artifacts-builder skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
What technologies are included in the project initialization?
The initialization script sets up a project with React 18, TypeScript, Vite, Tailwind CSS 3.4.1, shadcn/ui, and Radix UI dependencies.
Should I test the artifact before showing it to the user?
Testing is optional and should generally be avoided upfront to reduce latency; it is better to test after presenting the artifact if requested.