claude-toolkit 0.1.9

package/stacks/vanilla-extract/skills/vanilla-extract-patterns/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: ct-vanilla-extract-patterns
+description: Type-safe CSS with vanilla-extract, sprinkles, and recipes
+---
+
+# Vanilla Extract Patterns
+
+All styles in `*.css.ts` files only. Build-time extraction, zero runtime.
+
+## Core APIs
+
+```ts
+// style() -- scoped class
+export const button = style({ padding: '8px 16px', ':hover': { opacity: 0.9 } });
+
+// Compose via array
+export const primary = style([button, { background: 'blue', color: 'white' }]);
+
+// styleVariants() -- variant map
+export const color = styleVariants({
+  primary: { background: 'blue', color: 'white' },
+  danger: { background: 'red', color: 'white' },
+});
+```
+
+## recipe() -- Multi-Variant Components
+
+```ts
+export const btn = recipe({
+  base: { padding: '8px 16px', border: 'none' },
+  variants: {
+    color: { primary: { background: 'blue' }, secondary: { background: 'gray' } },
+    size: { sm: { fontSize: '12px' }, md: { fontSize: '14px' }, lg: { fontSize: '16px' } },
+  },
+  compoundVariants: [{ variants: { color: 'primary', size: 'lg' }, style: { fontWeight: 'bold' } }],
+  defaultVariants: { color: 'primary', size: 'md' },
+});
+// Usage: btn({ color: 'secondary', size: 'lg' })
+```
+
+## Theming
+
+Contract-first approach -- define shape, then fill per theme:
+
+```ts
+export const vars = createThemeContract({
+  color: { brand: null, text: null, bg: null },
+  space: { sm: null, md: null, lg: null },
+});
+export const light = createTheme(vars, {
+  color: { brand: '#0066ff', text: '#1a1a1a', bg: '#fff' },
+  space: { sm: '4px', md: '8px', lg: '16px' },
+});
+// Use in styles: style({ color: vars.color.brand })
+```
+
+## Sprinkles
+
+Constrained atomic utility classes with responsive conditions:
+
+```ts
+const props = defineProperties({
+  conditions: { mobile: {}, tablet: { '@media': '(min-width: 768px)' } },
+  defaultCondition: 'mobile',
+  properties: { display: ['none', 'flex', 'block'], padding: vars.space },
+});
+export const sprinkles = createSprinkles(props);
+```
+
+## Anti-Patterns
+
+1. **Inline styles** -- Use `style()` or `sprinkles()`.
+2. **Runtime CSS** -- No `document.createElement('style')` or CSS-in-JS libs alongside.
+3. **Overusing globalStyle** -- Prefer scoped `style()`. Reserve global for resets only.
+4. **Non-`.css.ts` files** -- Build plugin only processes `*.css.ts`.
+5. **Raw CSS variable strings** -- Use the `vars` object for type-safe references.

package/stacks/vanilla-extract/stack.json

@@ -0,0 +1,40 @@
+{
+	"name": "ct-vanilla-extract-patterns",
+	"description": "Type-safe CSS with vanilla-extract, sprinkles, and recipes",
+	"defaultMappings": {
+		"src/styles": "ct-vanilla-extract-patterns",
+		"src/theme": "ct-vanilla-extract-patterns"
+	},
+	"fileExtensions": ["css.ts"],
+	"skillRules": {
+		"ct-vanilla-extract-patterns": {
+			"description": "Type-safe CSS with vanilla-extract styling patterns",
+			"priority": 7,
+			"triggers": {
+				"keywords": [
+					"vanilla-extract",
+					"style",
+					"sprinkles",
+					"recipe",
+					"theme",
+					"css.ts",
+					"styleVariants"
+				],
+				"keywordPatterns": ["\\bstyle\\(", "\\brecipe\\(", "\\bsprinkles\\(", "\\.css\\.ts\\b"],
+				"pathPatterns": ["**/*.css.ts", "**/styles/**", "**/theme/**"],
+				"intentPatterns": [
+					"(?:style|design|theme|css).*(?:component|page|layout)",
+					"(?:create|add).*(?:style|variant|theme)"
+				],
+				"contentPatterns": [
+					"style\\(",
+					"styleVariants\\(",
+					"recipe\\(",
+					"globalStyle\\(",
+					"createTheme\\("
+				]
+			},
+			"relatedSkills": ["ct-solidjs-patterns"]
+		}
+	}
+}

package/templates/claude-toolkit.config.ts

@@ -0,0 +1,34 @@
+import { defineConfig } from "claude-toolkit";
+
+export default defineConfig({
+	// Stack packs to activate — each adds skills, directory mappings, and hook rules
+	stacks: [],
+
+	// Package manager used for install/run commands
+	packageManager: "bun",
+
+	// Hook automation — commands run automatically on file changes
+	hooks: {
+		formatter: "bun run prettier --write",
+		testRunner: "bun run vitest run",
+		typeCheck: "bun run tsc --noEmit",
+		// extraChecks: ['cargo check --target wasm32-unknown-unknown'],
+	},
+
+	// Directory → skill mappings (merged with stack defaults)
+	directoryMappings: {
+		// 'src/components': 'my-skill',
+	},
+
+	// Git workflow configuration
+	git: {
+		branchPrefix: "dev",
+		protectedBranches: ["main"],
+	},
+
+	// Project metadata for CLAUDE.md generation
+	project: {
+		name: "my-project",
+		description: "Project description",
+	},
+});

package/templates/configs/biome.base.json

@@ -0,0 +1,35 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.4.10/schema.json",
+	"vcs": {
+		"enabled": true,
+		"clientKind": "git",
+		"useIgnoreFile": true
+	},
+	"files": {
+		"ignoreUnknown": false
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab",
+		"lineWidth": 100
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "double"
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "on"
+			}
+		}
+	}
+}

package/templates/configs/tsconfig.base.json

@@ -0,0 +1,16 @@
+{
+	"compilerOptions": {
+		"target": "ESNext",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"strict": true,
+		"noUncheckedIndexedAccess": true,
+		"exactOptionalPropertyTypes": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true,
+		"forceConsistentCasingInFileNames": true,
+		"declaration": true,
+		"declarationMap": true,
+		"sourceMap": true
+	}
+}

package/templates/skill-rules.base.json

@@ -0,0 +1,98 @@
+{
+	"skills": {
+		"ct-systematic-debugging": {
+			"description": "Four-phase debugging with root cause analysis",
+			"priority": 9,
+			"triggers": {
+				"keywords": ["bug", "debug", "fix", "error", "issue", "broken", "crash", "failing"],
+				"keywordPatterns": [
+					"\\bbug\\b",
+					"\\bfix\\b",
+					"\\berror\\b",
+					"\\bissue\\b",
+					"doesn't work",
+					"not working"
+				],
+				"intentPatterns": [
+					"(?:fix|debug|resolve|investigate).*(?:bug|error|issue|problem)",
+					"(?:why).*(?:not working|broken|failing|crash)",
+					"(?:something).*(?:wrong|broken)"
+				]
+			},
+			"excludePatterns": ["fix typo", "fix formatting", "fix lint"]
+		},
+		"ct-testing-patterns": {
+			"description": "Test-driven development workflow and patterns",
+			"priority": 9,
+			"triggers": {
+				"keywords": ["test", "spec", "tdd", "mock", "factory", "vitest", "jest"],
+				"keywordPatterns": ["\\btest(?:s|ing)?\\b", "\\bspec\\b", "unit test"],
+				"pathPatterns": [
+					"**/*.test.ts",
+					"**/*.test.tsx",
+					"**/*.spec.ts",
+					"**/test-utils/**",
+					"**/__mocks__/**"
+				],
+				"intentPatterns": [
+					"(?:write|add|create|fix).*(?:test|spec)",
+					"(?:test|spec).*(?:for|of|the)",
+					"(?:red.green.refactor|tdd)"
+				],
+				"contentPatterns": ["describe\\(", "it\\(", "expect\\(", "vi\\.mock", "jest\\.mock"]
+			},
+			"excludePatterns": ["e2e", "end-to-end"]
+		},
+		"ct-typescript-conventions": {
+			"description": "TypeScript strict mode and conventions",
+			"priority": 5,
+			"triggers": {
+				"keywords": ["typescript", "type", "interface", "generic", "strict mode"],
+				"keywordPatterns": ["\\btype\\b", "\\binterface\\b", "\\bgeneric\\b"],
+				"pathPatterns": ["**/*.d.ts", "**/types/**", "**/types.ts"],
+				"intentPatterns": ["(?:define|create).*(?:type|interface)", "(?:type).*(?:error|issue)"],
+				"contentPatterns": ["interface ", "type ", ": unknown", "as const"]
+			},
+			"excludePatterns": ["issue type", "type of bug"]
+		},
+		"ct-verification-before-completion": {
+			"description": "Evidence-based completion claims protocol",
+			"priority": 8,
+			"triggers": {
+				"keywords": ["verify", "check", "confirm", "done", "complete", "finished"],
+				"intentPatterns": [
+					"(?:is it|are we).*(?:done|complete|finished)",
+					"(?:verify|check|confirm).*(?:works|passes)"
+				],
+				"contextPatterns": ["before claiming", "make sure", "double check"]
+			}
+		},
+		"ct-github-actions": {
+			"description": "GitHub Actions CI/CD workflow patterns",
+			"priority": 6,
+			"triggers": {
+				"keywords": ["github action", "github workflow", "workflow", "ci/cd", "cicd", "pipeline"],
+				"keywordPatterns": ["github.action", "ci/?cd", "\\bworkflow\\b"],
+				"pathPatterns": [".github/workflows/**", ".github/**/*.yml"],
+				"intentPatterns": [
+					"(?:create|add|update).*(?:workflow|action|pipeline)",
+					"(?:ci|cd).*(?:pipeline|workflow)"
+				],
+				"contentPatterns": ["runs-on:", "uses:", "steps:"]
+			}
+		},
+		"ct-code-review": {
+			"description": "Handle code review feedback",
+			"priority": 4,
+			"triggers": {
+				"keywords": ["code review", "pr feedback", "review comment"],
+				"keywordPatterns": ["code.review", "pr.feedback", "review.comment"],
+				"intentPatterns": [
+					"(?:respond|address|handle).*(?:review|feedback|comment)",
+					"(?:reviewer).*(?:said|suggested|asked)"
+				],
+				"contextPatterns": ["from the reviewer", "in the pr", "review feedback"]
+			}
+		}
+	}
+}