Agent Skills
PikaCSS ships with an agent skill that provides AI-assisted guidance for both consuming and extending PikaCSS. Install it as a Claude Code plugin, or with the skills CLI for any other supported coding agent.
Install
Claude Code Plugin
In Claude Code, add this repository as a plugin marketplace, then install the plugin:
/plugin marketplace add pikacss/pikacss
/plugin install pikacss@pikacssClaude loads the skill on its own when your work matches its description; see How to Trigger to invoke it explicitly. /plugin marketplace update refreshes the marketplace to the skill content on the repository's default branch, which can be ahead of the latest npm release.
Skills CLI
For any supported agent, including Claude Code, install the skill directly with the skills CLI:
npx skills add pikacss/pikacss --skill pikacss-useBoth paths install the same skills/pikacss-use content.
pikacss-use
When to Use
Use this skill when you are working with PikaCSS in any capacity:
- Setting up PikaCSS in a new project
- Configuring engine options or build integrations
- Using
pika()and its variants - Consuming official plugins (reset, icons, fonts, typography, and design tokens)
- Troubleshooting transforms, generated files, TypeScript declarations, or configuration reloads
- Choosing neutral or Node.js runtime adapters for plugins that load local resources
- Creating a new engine plugin from scratch
- Implementing plugin hooks, structured diagnostics, and lifecycle behavior
- Extending
EngineConfigwith module augmentation - Registering external configuration dependencies for file watching
- Writing plugin tests
How to Trigger
The skill is automatically activated when your question relates to PikaCSS usage or plugin development. You can also explicitly mention "using PikaCSS", "PikaCSS setup", or "PikaCSS plugin development" in your prompt.
Installed as a Claude Code plugin, the skill is namespaced: invoke it with /pikacss:pikacss-use. Installed with the skills CLI, it is not namespaced and appears under its own name, /pikacss-use.
Coverage
- Installation and build tool integration (Vite, Webpack, Rollup, esbuild, Rspack, Rolldown, and Nuxt)
- Node.js, Vite, source-file, and static-analysis compatibility constraints
- Engine configuration and customization
- Generated CSS and TypeScript declaration files
- The
pika(),pika.str(),pika.arr(), andpikap()functions - Official plugin consumption and configuration
- Neutral and Node.js plugin entry points
- ESLint integration
- TypeScript autocomplete support
- Plugin structure and
defineEnginePlugin - Lifecycle hooks, hook context, diagnostics, and execution order
- Config augmentation via TypeScript module augmentation
- Layer management and preflight injection
- Selector, shortcut, variable, keyframe, and design-token registration
- External config dependency watching
- Plugin testing patterns using
createEngine
Next
- Setup — install PikaCSS in your project.
- Plugin Development — create your own plugins.