solid-component-builder
Trigger
Use this skill for new or modified SolidJS components where component contract, reactivity, async behavior, accessibility, and SSR/hydration safety must be explicit.
Required Inputs
- Component goal and user-facing behavior.
- Prop interface and expected defaults.
- Data dependencies and async boundaries.
- Rendering context (client-only, SSR, or mixed).
- Acceptance constraints (performance, accessibility, test expectations).
Workflow
- Define component contract before implementation: props, emitted callbacks, ownership of state, and external dependencies.
- Choose primitives by rule: pure derivations use
createMemo; side effects usecreateEffect; async data usescreateResource; grouped updates usebatch. - Select control-flow primitives explicitly (
<Show>,<For>,<Switch>/<Match>) and document why each is used. - Declare loading, empty, error, and success rendering states when async data is present.
- Add SSR/hydration checks for browser-only behavior and deterministic initial render.
- Produce validation checklist and commands before returning final output.
Failure Modes
- Missing prop or data contracts: stop and request exact missing input keys.
- Ambiguous state ownership: default to local ownership and document escalation path.
- Missing async states: fail output and add explicit loading/error/empty branches.
- Hydration mismatch risk: require server/client render parity note before completion.
Output Contract
Return output matching ComponentBuildOutput schema at ../../skills/contracts/component-build-output.schema.json with:
summary,implementation_plan, andcomponent_contract.reactivity_decisions,acceptance_checklist, andvalidation_commands.citations: each item must includedoc_idandclaimsourced from normalized references.
Validation
node tools/scripts/validate-skills.mjs --skill solid-component-buildernode tools/scripts/validate-output-contracts.mjs
References
../../references/solidjs-normalized/manifest.jsonl../../references/solidjs-normalized/taxonomy.json../../references/solidjs/reactivity-core.md../../references/solidjs/component-patterns.md../../references/solidjs/performance-ssr.md
Converted and distributed by TomeVault — claim your Tome and manage your conversions.