Back to Skills

preview-dev

---

11stars4forksUpdated 5/6/2026

Security Assessment

Safe(100/100)
Security Score100/100

About preview-dev

The preview-dev skill is designed to streamline frontend and fullstack web development by providing live preview capabilities directly within a development workflow. It addresses the common challenge of validating and iterating on web projects quickly by allowing developers to see real-time updates in a browser as they write code. By integrating preview management, health checks, and error diagnostics, it ensures that developers can catch and resolve issues without leaving their coding environment, reducing friction and improving productivity.

This skill offers a comprehensive set of features for web developers. It supports multiple frameworks and project types, including React, Vue, Vite, Express, FastAPI, and static HTML. Developers can serve previews, monitor the health of running previews, and automatically diagnose common errors such as blank pages, directory listings, script escape errors, or connection failures. The workflow emphasizes fixing issues in-place using file edits rather than creating new files, ensuring project continuity. Additionally, it provides tools to manage preview IDs safely, stop and restart previews, and verify that the service is running correctly before notifying the user that the preview is ready.

Use cases for preview-dev include building web pages, frontend applications, fullstack projects, or any web UI that needs live browser interaction. It is ideal for developers who need to quickly prototype, test, or deploy web interfaces, and for teams that require reliable error recovery and preview management during development. Target users include frontend engineers, fullstack developers, and anyone creating interactive web content who wants a seamless, integrated environment for coding, previewing, and publishing web projects.

FAQ

How do I start a live preview of my project?

Use the preview_serve command with the project directory, title, command, and port. Wait until the health_check.ok field returns true before notifying the user that the preview is ready.

Which frameworks and project types are supported?

This skill supports React, Vue, Vite, Express, FastAPI, and static HTML projects, as well as any framework producing a browser-viewable result.

What should I do if the preview shows a blank page?

Check for JavaScript errors, missing CDN links, or script escape issues by reading the HTML/code file and using preview_check diagnostics. Fix the problem in-place using edit_file and restart the preview.

Can I create a new preview without stopping an existing one?

No. Always stop the old preview first or let the auto-cleanup handle same-directory previews to avoid conflicts.

How do I find the preview ID for a running preview?

Read the /data/previews.json registry or use the preview_id returned from preview_serve. Never guess the ID manually.

Install preview-dev

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill