@birdapi/velinstyle 1.0.0 → 1.2.0

package/packages/velinstyle-skills/skills/velin-migration-prefix-classes/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-migration-prefix-classes
+description: Migrates class names to velin-* convention.
+---
+
+# Migration Prefix Classes
+
+## Goal
+Deliver migration prefix classes outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: migrate.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: prefix
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: html, css.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: diff, 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-migration-prefix-classes for this page."
+- CLI bridge example: `velinstyle prefix`
+
+## 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.

package/packages/velinstyle-skills/skills/velin-motion-reduced-safe/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-motion-reduced-safe
+description: Applies motion while honoring prefers-reduced-motion.
+---
+
+# Motion Reduced Safe
+
+## Goal
+Deliver motion reduced safe outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: motion, accessibility.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: html, css.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: html, 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-motion-reduced-safe 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-motion-reveal-feedback/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-motion-reveal-feedback
+description: Adds intentional reveal and feedback motion hierarchies.
+---
+
+# Motion Reveal Feedback
+
+## Goal
+Deliver motion reveal feedback outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: motion, build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review
+- Dependencies: velin-motion-reduced-safe
+
+## Workflow
+1. Validate inputs: html, css.
+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: 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-motion-reveal-feedback 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, checklist.

package/packages/velinstyle-skills/skills/velin-perf-audit-fix/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-perf-audit-fix
+description: Audits performance and applies safe optimization fixes.
+---
+
+# Perf Audit Fix
+
+## Goal
+Deliver perf audit fix outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: performance, review.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: perf
+- Dependencies: none
+
+## Workflow
+1. Validate inputs: html.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: report, diff.
+
+## Rules
+- Respect status: stable.
+- 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-perf-audit-fix for this page."
+- CLI bridge example: `velinstyle perf`
+
+## 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, diff.

package/packages/velinstyle-skills/skills/velin-perf-runtime-tree-shake/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-perf-runtime-tree-shake
+description: Reduces runtime payload using explicit component loading strategy.
+---
+
+# Perf Runtime Tree Shake
+
+## Goal
+Deliver perf runtime tree shake outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: performance, build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: build
+- Dependencies: velin-perf-audit-fix
+
+## Workflow
+1. Validate inputs: html, css.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: report, diff.
+
+## Rules
+- Respect status: beta.
+- 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-perf-runtime-tree-shake for this page."
+- CLI bridge example: `velinstyle build`
+
+## 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, diff.

package/packages/velinstyle-skills/skills/velin-release-changelog-sync/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-release-changelog-sync
+description: Keeps changelog and docs in sync before release.
+---
+
+# Release Changelog Sync
+
+## Goal
+Deliver release changelog sync outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: release, documentation.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: docs
+- Dependencies: velin-review-page-gate
+
+## 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, checklist.
+
+## Rules
+- Respect status: stable.
+- 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-release-changelog-sync 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, checklist.

package/packages/velinstyle-skills/skills/velin-release-meta-rebuild/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-release-meta-rebuild
+description: Rebuilds velin-agent.json and llms.txt before publishing.
+---
+
+# Release Meta Rebuild
+
+## Goal
+Deliver release meta rebuild outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: release, ai-orchestration.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: meta
+- 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: meta-json, 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-release-meta-rebuild for this page."
+- CLI bridge example: `velinstyle meta`
+
+## 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: meta-json, report.

package/packages/velinstyle-skills/skills/velin-review-conversion-hero/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-review-conversion-hero
+description: Reviews hero conversion quality and CTA hierarchy.
+---
+
+# Review Conversion Hero
+
+## Goal
+Deliver review conversion hero outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: review, seo.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review
+- Dependencies: velin-design-hero-compose
+
+## Workflow
+1. Validate inputs: html, prompt.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: 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-review-conversion-hero 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: report.

package/packages/velinstyle-skills/skills/velin-review-page-gate/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-review-page-gate
+description: Runs design/a11y/seo/perf/conversion gate and reports score.
+---
+
+# Review Page Gate
+
+## Goal
+Deliver review page gate outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: review.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review
+- Dependencies: velin-a11y-page-checklist
+
+## Workflow
+1. Validate inputs: html, prompt.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: review-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-review-page-gate 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: review-json.

package/packages/velinstyle-skills/skills/velin-review-seo-meta/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-review-seo-meta
+description: Checks SEO metadata and content semantics.
+---
+
+# Review SEO Meta
+
+## Goal
+Deliver review seo meta outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: review, seo.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review
+- Dependencies: none
+
+## 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: report.
+
+## Rules
+- Respect status: stable.
+- 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-review-seo-meta 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: report.

package/packages/velinstyle-skills/skills/velin-security-sanitize-html/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-security-sanitize-html
+description: Applies safe HTML sanitization guidance for dynamic content.
+---
+
+# Security Sanitize HTML
+
+## Goal
+Deliver security sanitize html outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: security, build.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: review
+- Dependencies: velin-security-scan-pii
+
+## Workflow
+1. Validate inputs: html.
+2. Apply rules from DESIGN_RULES and registry metadata.
+3. Execute required CLI steps when available.
+4. Emit outputs: diff, report.
+
+## Rules
+- Respect status: stable.
+- 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-security-sanitize-html 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.

package/packages/velinstyle-skills/skills/velin-security-scan-pii/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: velin-security-scan-pii
+description: Scans for PII exposure and common security mistakes.
+---
+
+# Security Scan PII
+
+## Goal
+Deliver security scan pii outcomes with VelinStyle constraints.
+
+## Description
+Use this skill when capability targets include: security, review.
+
+## Prerequisites
+- Framework compatibility: 1.2.0 to 2.x
+- CLI: scan
+- Dependencies: none
+
+## 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: 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-security-scan-pii 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.