Skip to content

OpenAEC-Foundation/SolidJS-Claude-Skill-Package

Repository files navigation

SolidJS Claude Skill Package

16 Deterministic Skills for SolidJS

Deterministic Claude AI skills for SolidJS reactive framework development.

Built on the Agent Skills open standard.

Why This Exists

SolidJS looks like React but works fundamentally differently. Claude systematically generates React patterns that silently fail in SolidJS:

// WRONG - React pattern, breaks SolidJS reactivity
const [count, setCount] = useState(0);

// CORRECT - SolidJS signal
const [count, setCount] = createSignal(0);
// WRONG - Destructuring props breaks reactivity tracking
function Counter({ count, onClick }) {

// CORRECT - Access props directly to preserve reactivity
function Counter(props) {
  return <button onClick={props.onClick}>{props.count()}</button>
}
// WRONG - Array.map loses reactivity, no keyed diffing
{items.map(item => <Item item={item} />)}

// CORRECT - <For> component with fine-grained updates
<For each={items()}>{(item) => <Item item={item} />}</For>

AI failure rate without skills: STRUCTURAL — React contamination is systematic, not occasional.

Installation

Add to your project's .claude/settings.json:

{
  "permissions": {
    "allow": ["skills"]
  },
  "skills": [
    "https://github.com/OpenAEC-Foundation/SolidJS-Claude-Skill-Package"
  ]
}

Or clone locally:

git clone https://github.com/OpenAEC-Foundation/SolidJS-Claude-Skill-Package.git

Package Contents

Category Directory Purpose Skills
Syntax solid-syntax/ Signals, stores, reactivity primitives, JSX compilation 5
Implementation solid-impl/ Component patterns, routing, SolidStart workflows 4
Errors solid-errors/ React contamination detection, reactivity debugging 3
Core solid-core/ Architecture, fine-grained reactivity model, version matrix 2
Agents solid-agents/ Validation, React-pattern detection, scaffolding 2
Total 16

All Skills

Skill Description
solid-syntax-signals Creating, reading, and updating signals — the core reactive primitive
solid-syntax-stores Nested reactive state with createStore, produce, and reconcile
solid-syntax-jsx JSX compilation model — how SolidJS compiles templates, not VDOM
solid-syntax-components Component authoring — props handling, children, splitting props
solid-syntax-context Context API for dependency injection without prop drilling
solid-impl-solidstart SolidStart meta-framework — SSR, file routing, API routes
solid-impl-routing Client-side routing with @solidjs/router
solid-impl-state-patterns State management patterns — global stores, resource caching
solid-impl-testing Testing SolidJS components with Vitest and solid-testing-library
solid-errors-react-contamination Detecting and fixing React patterns that silently break SolidJS
solid-errors-reactivity-debugging Debugging lost reactivity, stale closures, and tracking issues
solid-errors-error-handling Error boundaries, ErrorBoundary component, fallback patterns
solid-core-reactivity-model Fine-grained reactivity model — how tracking and subscriptions work
solid-core-overview SolidJS API surface overview and version matrix
solid-agents-review Code review agent — detects React anti-patterns in SolidJS code
solid-agents-project-scaffolder Project scaffolding agent — generates SolidJS project structure

Technology Coverage

Technology Versions Languages
SolidJS 1.x, 2.x TypeScript, TSX
SolidStart 0.x, 1.x TypeScript, TSX

Current Progress

v1.0.0 — 16 skills across 5 categories, production-ready.

See ROADMAP.md for detailed progress.

Documentation

File Purpose
CLAUDE.md Protocols and session instructions
ROADMAP.md Project status and next steps
REQUIREMENTS.md Quality guarantees
DECISIONS.md Architectural decisions
SOURCES.md Official reference URLs
WAY_OF_WORK.md 7-phase methodology
LESSONS.md Lessons learned
CHANGELOG.md Version history
INDEX.md Complete skill catalog

Used In

Related Skill Packages

License

MIT — see LICENSE


Part of the OpenAEC Foundation ecosystem.

About

16 deterministic Claude AI skills for SolidJS reactive framework development

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors