web_development

Edit TypeScript, React, HTML, and CSS files with JSDoc comments and validation.

Updated Oct 18, 2025
One-click install
npx skills add https://github.com/Kiikurage/Claude-Code-Sample --skill web-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web_development
Source: https://github.com/Kiikurage/Claude-Code-Sample/tree/main/.claude/skills/web_development
Command: npx skills add https://github.com/Kiikurage/Claude-Code-Sample --skill web-development

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bun, react, typescript, vite, biome, zod, bun-test, react-testing-library, happy-dom, and includes references (resource) components.

What problem does it solve?

Ensures all web frontend development adheres to strict coding standards, best practices, and verification methods, reducing errors and improving code quality. It acts as a comprehensive knowledge base and checklist for frontend tasks, letting you focus on features, not flaws.

Core Features & Use Cases

  • Coding Guidelines: Provides detailed rules for TypeScript, React, HTML, and CSS, including JSDoc comments, URL design, and recommended libraries.
  • Design Patterns & Idioms: Guides on React component structure, state management (Context), accessibility, and nullish value handling.
  • Mandatory Verification Workflow: Outlines a strict pre-commit checklist including linting, type checking, testing, and building, ensuring high-quality deliverables.
  • Use Case: When developing a new React component, this skill provides the necessary guidelines for implementation, testing, and ensures all quality checks are passed before committing, guaranteeing robust and maintainable code.

Quick Start

To ensure all web development tasks follow best practices:

Always refer to the knowledge base before coding:

.claude/skills/web_development/web_development.md

After any code change, run these commands IN ORDER before committing:

bun run lint bun run check cd packages/web && bun test bun run build

Frequently Asked Questions about web_development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a React project with TypeScript and enforce coding standards?

Set up React with TypeScript using Vite, Biome for linting, and Zod for validation. This Skill provides the complete coding standards framework—JSDoc requirements, URL patterns, routing with TanStack Router, and per-file type definitions—ensuring consistent, high-quality code from project start.

What's the best way to structure React components with TypeScript best practices?

React components should follow strict guidelines: JSDoc comments on all functions and classes, per-file type definitions, Context for state management, and accessibility-first markup. This Skill delivers detailed patterns for component structure, nullish value handling, and validation ensuring maintainable, robust code.

How do I validate API requests and responses in a React TypeScript project?

Use Zod schemas for runtime validation of API data in REST endpoints following the /api/{version}/{resource} pattern. This Skill enforces validation methods, type safety, and error handling patterns that prevent runtime failures and maintain data integrity across your frontend.

Can I use React Query with TypeScript and REST APIs in this workflow?

Yes. This Skill integrates React Query with Zod-validated REST APIs, TanStack Router for code-based routing, and Express conventions. The mandatory verification workflow—linting, type checking, testing with bun-test and react-testing-library, and building—ensures all integrations work correctly before commit.

What pre-commit checks should I run before deploying React code?

Run four checks in order: bun run lint, bun run check, bun test, and bun run build. This Skill mandates this verification workflow to catch linting errors, type issues, test failures, and build problems before commit, guaranteeing production-ready code quality.

Does this approach work for testing React components with TypeScript?

Yes. This Skill uses react-testing-library and bun-test for comprehensive component testing, integrated into the pre-commit checklist. Test requirements ensure all UI logic, accessibility, and state management are verified, delivering reliable, maintainable React code.