setup

Bootstrap an acss-kit React project by generating configuration, theme files, and CSS/SCSS imports.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/shawn-sandy/agentic-acss-plugins --skill setup-shawn-sandy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/shawn-sandy/agentic-acss-plugins/tree/main/plugins/acss-kit/skills/setup
Command: npx skills add https://github.com/shawn-sandy/agentic-acss-plugins --skill setup-shawn-sandy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

Setting up an acss-kit-enabled React + TypeScript project is repetitive: you have to install Sass, create the component foundation file, generate starter themes, and wire the resulting CSS/SCSS imports into the project entry.

Core Features & Use Cases

  • Detects and validates project readiness: verifies a React + TypeScript project and determines the package manager and install command.
  • Idempotent one-time bootstrap: safely creates or reuses .acss-target.json, copies ui.tsx, seeds src/styles/theme/light.css and dark.css, and persists where the theme should be imported.
  • Theme wiring into your CSS/SCSS entry: detects the most appropriate CSS/SCSS entry file and inserts managed theme @import/@import url(...) lines in an idempotent way, plus stores the chosen entry path in .acss-target.json.
  • Use case: after installing the acss-kit plugin, you can run /setup to prepare everything so later commands like /kit-add and /theme-create become pure generation with minimal friction.

Quick Start

Run /setup in your project to bootstrap acss-kit, generate a starter theme, and wire theme imports into your main CSS/SCSS entry.

Frequently Asked Questions about setup

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

FAQPage Schema
How do I bootstrap an acss-kit React project with TypeScript and Sass?

To bootstrap an acss-kit React project with TypeScript and Sass, run the setup process which validates the React and TypeScript environment, creates the component foundation file, generates light and dark theme palettes, and wires theme imports into your CSS or SCSS entry.

What is idempotent setup for React theme generation and CSS imports?

Idempotent setup for React theme generation means safely creating or reusing configuration files like .acss-target.json and inserting managed CSS or SCSS theme imports without duplicating artifacts, ensuring repeated runs produce the same filesystem state without errors.

How do I wire light and dark theme CSS imports into my SCSS entry file?

To wire light and dark theme CSS imports into your SCSS entry file, the setup detects the most appropriate CSS or SCSS entry file in your project and inserts managed @import or @import url lines in an idempotent manner.

Does acss-kit setup work with any package manager for React and TypeScript projects?

The acss-kit setup works with React and TypeScript projects by automatically detecting the installed package manager and determining the correct install command, ensuring compatibility across different package management environments during the bootstrap process.

Can I rerun the acss-kit bootstrap if I already have theme files generated?

You can rerun the acss-kit bootstrap safely because it detects existing artifacts like .acss-target.json and theme files, reusing them rather than overwriting, which ensures idempotent filesystem changes across multiple setup executions.