Skip to content

chore(skills): add components-build standard and wire into skill chain#17

Merged
jal-co merged 2 commits intomainfrom
chore/components-build-standard
Mar 29, 2026
Merged

chore(skills): add components-build standard and wire into skill chain#17
jal-co merged 2 commits intomainfrom
chore/components-build-standard

Conversation

@jal-co
Copy link
Copy Markdown
Owner

@jal-co jal-co commented Mar 29, 2026

Summary

Adds the components.build specification as a repo-local skill and wires it as the canonical engineering standard that all jalco ui skills build on.

What changed

New skill: .pi/skills/components-build/

The full components.build spec (by Hayden Bleasel and shadcn) distilled into a SKILL.md router + 9 reference files (1,113 lines):

Reference Pillar
composition.md Compound components, naming, Context sharing
accessibility.md Keyboard maps, ARIA, focus, contrast, mobile
types.md HTML extension, single-element wrapping, exported types
styling.md cn utility, CVA, class ordering, design tokens
state.md Controlled/uncontrolled, useControllableState
polymorphism.md as prop, type-safe generics
as-child.md Radix Slot, prop merging
data-attributes.md data-state, data-slot, has-[] patterns
taxonomy.md Artifact classification heuristics

Skill dependency chain

components-build              ← the standard (what a well-built component looks like)
  ↑
jalco-component-builder       ← the workflow (how jalco ui gets there)
  ↑
jalco-shadcn-registry         ← the registry (every item must meet the standard)
jalco-writing-component-docs  ← docs (independent, format-spec driven)

Updated files

  • AGENTS.md — references repo-local components-build as MUST for all component architecture decisions
  • jalco-component-builder — adds engineering foundation section, engineering standard checklist, taxonomy classification step
  • jalco-shadcn-registry — adds to required reading, requires conformance for all registry items
  • Removes all references to old component-engineering global skill

jal-co added 2 commits March 29, 2026 00:09
Move the components.build specification (by Hayden Bleasel and shadcn)
from global skills into the repo as the canonical engineering standard.

Covers: composition, accessibility, types, styling, state,
polymorphism, asChild, data attributes, and artifact taxonomy.

9 reference files, 1113 lines of spec-level guidance.
- AGENTS.md: reference repo-local path, MUST for all architecture decisions
- jalco-component-builder: add engineering foundation section, engineering
  standard checklist, taxonomy classification step in workflow
- jalco-shadcn-registry: add to required reading, require conformance
- Remove old component-engineering references
@jal-co jal-co merged commit 64424e4 into main Mar 29, 2026
2 checks passed
@jal-co jal-co deleted the chore/components-build-standard branch March 29, 2026 07:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant