@birdapi/velinstyle 1.0.0 → 1.2.0

package/packages/velinstyle-skills/skills/velin-components-select-compose/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-components-select-compose
+description: Chooses component set that matches page intent and constraints.
+---
+
+# Select Components
+
+## Goal
+Deliver select components outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: blueprint
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: prompt, docs.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: html, checklist.
+
+## Rules
+- Respect status: stable.
+- Respect priority: core.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-components-select-compose for this page."
+- CLI bridge example: `velinstyle blueprint`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: html, checklist.

package/packages/velinstyle-skills/skills/velin-design-hero-compose/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-design-hero-compose
+description: Composes first viewport hero following VelinStyle hierarchy and CTA constraints.
+---
+
+# Hero Compose
+
+## Goal
+Deliver hero compose outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: build, review.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: plan, scaffold, review
+- Dependencies: velin-dev-plan-first
+
+## Workflow
+1. Validate inputs: prompt, html, screenshot.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: html, review-json.
+
+## Rules
+- Respect status: beta.
+- Respect priority: core.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-design-hero-compose for this page."
+- CLI bridge example: `velinstyle plan`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: html, review-json.

package/packages/velinstyle-skills/skills/velin-design-section-rhythm/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-design-section-rhythm
+description: Aligns spacing rhythm and section purpose to design rules.
+---
+
+# Section Rhythm
+
+## Goal
+Deliver section rhythm outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: scaffold
+- Dependencies: velin-design-hero-compose
+
+## Workflow
+1. Validate inputs: prompt, html.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: html, checklist.
+
+## Rules
+- Respect status: beta.
+- Respect priority: recommended.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-design-section-rhythm for this page."
+- CLI bridge example: `velinstyle scaffold`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: html, checklist.

package/packages/velinstyle-skills/skills/velin-design-surface-roles/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-design-surface-roles
+description: Maps sections to base/raised/overlay surface roles.
+---
+
+# Surface Roles
+
+## Goal
+Deliver surface roles outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: build, theme.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: html, tokens.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: html, report.
+
+## Rules
+- Respect status: beta.
+- Respect priority: recommended.
+- Respect confidence: medium.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-design-surface-roles for this page."
+- CLI bridge example: `velinstyle review`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: html, report.

package/packages/velinstyle-skills/skills/velin-dev-component-wire/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-dev-component-wire
+description: Wires selected components with predictable APIs and semantics.
+---
+
+# Component Wire
+
+## Goal
+Deliver component wire outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review
+- Dependencies: velin-components-select-compose
+
+## Workflow
+1. Validate inputs: html, docs.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: html, diff.
+
+## Rules
+- Respect status: beta.
+- Respect priority: recommended.
+- Respect confidence: medium.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-dev-component-wire for this page."
+- CLI bridge example: `velinstyle review`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: html, diff.

package/packages/velinstyle-skills/skills/velin-dev-page-scaffold/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-dev-page-scaffold
+description: Renders plan-based HTML and runs review gates.
+---
+
+# Page Scaffold
+
+## Goal
+Deliver page scaffold outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: scaffold, review
+- Dependencies: velin-dev-plan-first
+
+## Workflow
+1. Validate inputs: prompt, plan-json.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: html, review-json.
+
+## Rules
+- Respect status: beta.
+- Respect priority: core.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-dev-page-scaffold for this page."
+- CLI bridge example: `velinstyle scaffold`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: html, review-json.

package/packages/velinstyle-skills/skills/velin-dev-plan-first/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-dev-plan-first
+description: Creates a plan JSON before implementation to reduce hallucinations.
+---
+
+# Plan First
+
+## Goal
+Deliver plan first outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: ai-orchestration, build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: plan
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: prompt.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: plan-json.
+
+## Rules
+- Respect status: stable.
+- Respect priority: core.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-dev-plan-first for this page."
+- CLI bridge example: `velinstyle plan`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: plan-json.

package/packages/velinstyle-skills/skills/velin-docs-component-guide/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-docs-component-guide
+description: Writes component-focused documentation with quality checklists.
+---
+
+# Docs Component Guide
+
+## Goal
+Deliver docs component guide outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: documentation.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: docs
+- Dependencies: velin-components-api-contract
+
+## Workflow
+1. Validate inputs: markdown, docs.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: markdown.
+
+## Rules
+- Respect status: beta.
+- Respect priority: recommended.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-docs-component-guide for this page."
+- CLI bridge example: `velinstyle docs`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: markdown.

package/packages/velinstyle-skills/skills/velin-docs-generate-api/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-docs-generate-api
+description: Generates API Markdown and verifies documentation footprint.
+---
+
+# Docs Generate API
+
+## Goal
+Deliver docs generate api outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: documentation.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: docs
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: docs.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: markdown, report.
+
+## Rules
+- Respect status: stable.
+- Respect priority: core.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-docs-generate-api for this page."
+- CLI bridge example: `velinstyle docs`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: markdown, report.

package/packages/velinstyle-skills/skills/velin-dx-doctor-setup/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-dx-doctor-setup
+description: Runs setup diagnostics and proposes fixes for dev experience gaps.
+---
+
+# DX Doctor Setup
+
+## Goal
+Deliver dx doctor setup outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: dx, review.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: scan
+- Dependencies: velin-dx-project-init
+
+## Workflow
+1. Validate inputs: docs, html.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: report.
+
+## Rules
+- Respect status: experimental.
+- Respect priority: advanced.
+- Respect confidence: medium.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-dx-doctor-setup for this page."
+- CLI bridge example: `velinstyle scan`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: report.

package/packages/velinstyle-skills/skills/velin-dx-project-init/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-dx-project-init
+description: Bootstraps VelinStyle projects with sane defaults.
+---
+
+# DX Project Init
+
+## Goal
+Deliver dx project init outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: dx, build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: init
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: docs.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: checklist.
+
+## Rules
+- Respect status: stable.
+- Respect priority: core.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-dx-project-init for this page."
+- CLI bridge example: `velinstyle init`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: checklist.

package/packages/velinstyle-skills/skills/velin-migration-legacy-wc/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-migration-legacy-wc
+description: Replaces legacy *-wc tags with canonical components.
+---
+
+# Migration Legacy WC
+
+## Goal
+Deliver migration legacy wc outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: migrate, review.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review
+- Dependencies: velin-migration-prefix-classes
+
+## Workflow
+1. Validate inputs: html, docs.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: diff, report.
+
+## Rules
+- Respect status: beta.
+- Respect priority: recommended.
+- Respect confidence: high.
+- Do not contradict DESIGN_RULES or DESIGN_INTELLIGENCE.
+
+## Best Practices
+- Keep changes scoped to one goal per section.
+- Prefer deterministic CLI output over ad-hoc edits.
+- Validate before release with review/security/perf gates.
+
+## Examples
+- Prompt example: "Run velin-migration-legacy-wc for this page."
+- CLI bridge example: `velinstyle review`
+
+## Anti-Patterns
+- Skipping dependency skills listed in `dependsOn`.
+- Running deprecated/legacy skills by default.
+- Ignoring `onlyIf` predicates.
+
+## Checklist
+- [ ] Inputs are present and typed.
+- [ ] Dependencies resolved.
+- [ ] Quality gate passed.
+- [ ] Output matches declared format.
+
+## Quality Rules
+- Must satisfy a11y basics (labels, focus, contrast).
+- Must keep velin-* naming conventions.
+- Must avoid one-off undocumented tokens/classes.
+
+## Output Format
+- Primary outputs: diff, report.