@turquoisehealth/pit-viper 2.182.1-dev.5 → 2.183.1-dev.0

package/claude-plugin/skills/pit-viper/SKILL.md

@@ -6,7 +6,11 @@ allowed-tools: Read Glob Grep Write Edit WebFetch
 
 # Pit Viper Design System
 
-Use Pit Viper for all frontend work. This skill grounds you in what actually exists in the design system — no hallucinating components or inventing variants.
+Fetch the endpoint index and orientation before starting:
+
+```
+WebFetch https://pitviper.turquoise.health/llms.txt
+```
 
 ## Workflow
 
@@ -67,34 +71,22 @@ WebFetch https://pitviper.turquoise.health/llm/tokens?category=color
 WebFetch https://pitviper.turquoise.health/llm/tokens?category=spacing
 ```
 
-### LLM Endpoints Reference
-
-Base URL: `https://pitviper.turquoise.health`
-
-| Endpoint | Purpose |
-|----------|---------|
-| `GET /llm` | API index |
-| `GET /llm/search?q={query}` | Search Vue + CSS components |
-| `GET /llm/component` | List all Vue components |
-| `GET /llm/component/{name}` | Get component details (props, stories, source) |
-| `GET /llm/css` | List all CSS components |
-| `GET /llm/css/{component}` | Get CSS component docs |
-| `GET /llm/css/themes` | Get theme CDN URLs |
-| `GET /llm/tokens` | List design tokens |
-| `GET /llm/tokens?category={cat}` | Filter tokens (color, spacing, typography, border, shadow) |
+### Step 4: Generate Output
 
-Add `?web_component=true` to component endpoints for web component variants.
+For all modes, first fetch the composition model:
 
-### Step 4: Generate Output
+```
+WebFetch https://pitviper.turquoise.health/llm/composition
+```
 
-Based on detected mode, read the appropriate reference and generate:
+Then based on detected mode, read the appropriate reference and generate:
 
-- **Vue Mode**: Read `references/vue-guidelines.md`, produce Vue 3 SFC
-- **HTML Mode**: Read `references/html-patterns.md`, produce HTML with pv-* classes. Starter template: `assets/pv-html-starter.html`. Full example: `examples/pv-html-example.html`
-- **Design Review**: Read `references/design-language.md`, explain component selection
+- **Vue Mode**: WebFetch https://pitviper.turquoise.health/llm/guides/vue, produce Vue 3 SFC
+- **HTML Mode**: WebFetch https://pitviper.turquoise.health/llm/guides/html, produce HTML with pv-* classes. Starter template: `assets/pv-html-starter.html`. Full example: `examples/pv-html-example.html`
+- **Design Review**: WebFetch https://pitviper.turquoise.health/llm/guides/design-language, explain component selection
 
-For page-level layouts, also read `references/layout-patterns.md`.
-For theme decisions, also read `references/theme-guide.md`.
+For page-level layouts, also WebFetch https://pitviper.turquoise.health/llm/guides/layouts.
+For theme decisions, also WebFetch https://pitviper.turquoise.health/llm/guides/themes.
 
 ## Anti-Patterns
 
@@ -120,22 +112,27 @@ If `/llm/search` returns no match for a legitimate UI need:
 
 ## References
 
+### All modes — fetch first:
+- `WebFetch https://pitviper.turquoise.health/llm/composition` — composition mental model, custom property API, flow vs. stack, failure modes
+
 ### Vue Mode — load these:
-1. `references/design-rules.md` — spacing, typography, colors
-2. `references/patterns-core.md` — utility class patterns
-3. `references/vue-guidelines.md` — Vue setup and patterns
+1. WebFetch https://pitviper.turquoise.health/llm/guides/rules — spacing, typography, colors
+2. WebFetch https://pitviper.turquoise.health/llm/guides/patterns — utility class patterns
+3. WebFetch https://pitviper.turquoise.health/llm/guides/vue — Vue setup and patterns
 
 ### HTML Mode — load these:
-1. `references/html-patterns.md` — CDN setup, web components, vanilla JS patterns
+1. WebFetch https://pitviper.turquoise.health/llm/guides/html — CDN setup, web components, vanilla JS patterns
 2. Starter template: `assets/pv-html-starter.html`
 3. Full example: `examples/pv-html-example.html` — complete layout with nav, filters, table, sidebar
 
 ### Design Review — load these:
-1. `references/design-language.md` — token validation, rationale
+1. WebFetch https://pitviper.turquoise.health/llm/guides/design-language — token validation, rationale
+2. WebFetch https://pitviper.turquoise.health/llm/guides/philosophy — full composition model, reasoning, and failure modes
 
 ### Optional (any mode):
-- `references/layout-patterns.md` — full page or multi-component layouts
-- `references/theme-guide.md` — Platform vs Consumer theme selection
+- WebFetch https://pitviper.turquoise.health/llm/guides/layouts — full page or multi-component layouts
+- WebFetch https://pitviper.turquoise.health/llm/guides/philosophy — full philosophy doc when the user asks for design rationale or reasoning (not just code generation)
+- WebFetch https://pitviper.turquoise.health/llm/guides/themes — Platform vs Consumer theme selection
 
 ## Quick Component Map
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@turquoisehealth/pit-viper",
-  "version": "2.182.1-dev.5",
+  "version": "2.183.1-dev.0",
   "description": "Turquoise Health's design system.",
   "main": "README.md",
   "publishConfig": {