@birdapi/velinstyle 1.1.0 → 1.2.0

package/packages/velinstyle-skills/graphs/component-ship.graph.yaml

@@ -0,0 +1,14 @@
+id: component-ship
+name: Component Ship Workflow
+entry: select
+nodes:
+  select: { skill: velin-components-select-compose }
+  contract: { skill: velin-components-api-contract }
+  a11y: { skill: velin-components-accessibility-map }
+  docs: { skill: velin-docs-component-guide }
+  review: { skill: velin-review-page-gate }
+edges:
+  - { from: select, to: contract }
+  - { from: contract, to: a11y }
+  - { from: a11y, to: docs }
+  - { from: docs, to: review }

package/packages/velinstyle-skills/graphs/landingpage.graph.yaml

@@ -0,0 +1,21 @@
+id: landingpage
+name: Landing Page Workflow
+entry: plan
+nodes:
+  plan: { skill: velin-dev-plan-first }
+  hero: { skill: velin-design-hero-compose }
+  sections: { skill: velin-design-section-rhythm }
+  components: { skill: velin-components-select-compose }
+  a11y: { skill: velin-a11y-page-checklist }
+  seo: { skill: velin-review-seo-meta }
+  review: { skill: velin-review-page-gate }
+  release: { skill: velin-release-meta-rebuild }
+edges:
+  - { from: plan, to: hero }
+  - { from: hero, to: sections }
+  - { from: sections, to: components }
+  - { from: components, to: a11y }
+  - { from: components, to: seo }
+  - { from: a11y, to: review }
+  - { from: seo, to: review }
+  - { from: review, to: release, when: review.passed }

package/packages/velinstyle-skills/graphs/release-gate.graph.yaml

@@ -0,0 +1,15 @@
+id: release-gate
+name: Release Gate Workflow
+entry: review
+nodes:
+  review: { skill: velin-review-page-gate }
+  perf: { skill: velin-perf-audit-fix }
+  security: { skill: velin-security-scan-pii }
+  changelog: { skill: velin-release-changelog-sync }
+  meta: { skill: velin-release-meta-rebuild }
+edges:
+  - { from: review, to: perf }
+  - { from: review, to: security }
+  - { from: perf, to: changelog }
+  - { from: security, to: changelog }
+  - { from: changelog, to: meta }

package/packages/velinstyle-skills/index.js

@@ -0,0 +1,22 @@
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { readFileSync, writeFileSync } from 'fs';
+import { buildCatalogProjection } from '../skill-engine/src/catalog.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export function getRegistryPath() {
+  return join(__dirname, 'registry.json');
+}
+
+export function loadVelinSkillsRegistry() {
+  return JSON.parse(readFileSync(getRegistryPath(), 'utf-8'));
+}
+
+export function writeCatalogFile() {
+  const registry = loadVelinSkillsRegistry();
+  const catalog = buildCatalogProjection(registry);
+  const outPath = join(__dirname, 'catalog.json');
+  writeFileSync(outPath, JSON.stringify(catalog, null, 2), 'utf-8');
+  return { outPath, count: catalog.totals.skills };
+}

package/packages/velinstyle-skills/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@birdapi/velinstyle-skills",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "main": "index.js"
+}

package/packages/velinstyle-skills/packs/accessibility.pack.yaml

@@ -0,0 +1,9 @@
+id: accessibility
+name: Accessibility Pack
+version: 1.0.0
+priority: core
+skills:
+  - velin-a11y-page-checklist
+  - velin-a11y-scan-fix
+  - velin-a11y-focus-keyboard
+  - velin-testing-a11y-suite

package/packages/velinstyle-skills/packs/design.pack.yaml

@@ -0,0 +1,10 @@
+id: design
+name: Design Pack
+version: 1.0.0
+priority: recommended
+skills:
+  - velin-design-hero-compose
+  - velin-design-section-rhythm
+  - velin-design-surface-roles
+  - velin-themes-apply-token
+  - velin-motion-reduced-safe

package/packages/velinstyle-skills/packs/documentation.pack.yaml

@@ -0,0 +1,8 @@
+id: documentation
+name: Documentation Pack
+version: 1.0.0
+priority: recommended
+skills:
+  - velin-docs-component-guide
+  - velin-docs-generate-api
+  - velin-release-changelog-sync

package/packages/velinstyle-skills/packs/enterprise.pack.yaml

@@ -0,0 +1,10 @@
+id: enterprise
+name: Enterprise Pack
+version: 1.0.0
+priority: advanced
+skills:
+  - velin-security-scan-pii
+  - velin-security-sanitize-html
+  - velin-perf-audit-fix
+  - velin-migration-prefix-classes
+  - velin-release-meta-rebuild

package/packages/velinstyle-skills/packs/frontend.pack.yaml

@@ -0,0 +1,10 @@
+id: frontend
+name: Frontend Pack
+version: 1.0.0
+priority: core
+skills:
+  - velin-dx-project-init
+  - velin-dev-plan-first
+  - velin-dev-page-scaffold
+  - velin-components-select-compose
+  - velin-utilities-layout-apply

package/packages/velinstyle-skills/packs/review.pack.yaml

@@ -0,0 +1,9 @@
+id: review
+name: Review Pack
+version: 1.0.0
+priority: core
+skills:
+  - velin-review-page-gate
+  - velin-review-conversion-hero
+  - velin-review-seo-meta
+  - velin-security-scan-pii

package/packages/velinstyle-skills/projects/admin-panel.project.yaml

@@ -0,0 +1,12 @@
+id: admin-panel
+name: Admin Panel
+priority: recommended
+workflowGraph: release-gate
+packs:
+  - enterprise
+  - review
+skills:
+  - velin-perf-audit-fix
+  - velin-security-scan-pii
+optimizedFor:
+  - cursor

package/packages/velinstyle-skills/projects/blog.project.yaml

@@ -0,0 +1,11 @@
+id: blog
+name: Blog
+priority: recommended
+workflowGraph: landingpage
+packs:
+  - frontend
+  - review
+skills:
+  - velin-review-seo-meta
+optimizedFor:
+  - cursor

package/packages/velinstyle-skills/projects/documentation-portal.project.yaml

@@ -0,0 +1,13 @@
+id: documentation-portal
+name: Documentation Portal
+priority: recommended
+workflowGraph: component-ship
+packs:
+  - documentation
+  - review
+skills:
+  - velin-docs-generate-api
+  - velin-ai-agent-briefing
+optimizedFor:
+  - cursor
+  - vscode

package/packages/velinstyle-skills/projects/ecommerce-shop.project.yaml

@@ -0,0 +1,12 @@
+id: ecommerce-shop
+name: E-Commerce Shop
+priority: advanced
+workflowGraph: landingpage
+packs:
+  - enterprise
+  - review
+skills:
+  - velin-security-sanitize-html
+  - velin-review-conversion-hero
+optimizedFor:
+  - cursor

package/packages/velinstyle-skills/projects/landing-page.project.yaml

@@ -0,0 +1,12 @@
+id: landing-page
+name: Landing Page
+priority: core
+workflowGraph: landingpage
+packs:
+  - frontend
+  - design
+skills:
+  - velin-review-conversion-hero
+optimizedFor:
+  - cursor
+  - windsurf

package/packages/velinstyle-skills/projects/laravel-dashboard.project.yaml

@@ -0,0 +1,12 @@
+id: laravel-dashboard
+name: Laravel Dashboard
+priority: advanced
+workflowGraph: release-gate
+packs:
+  - enterprise
+  - frontend
+skills:
+  - velin-dx-project-init
+optimizedFor:
+  - cursor
+  - claude-code

package/packages/velinstyle-skills/projects/marketing-website.project.yaml

@@ -0,0 +1,14 @@
+id: marketing-website
+name: Marketing Website
+priority: recommended
+workflowGraph: landingpage
+packs:
+  - frontend
+  - design
+  - review
+skills:
+  - velin-ai-plan-scaffold-review
+  - velin-review-conversion-hero
+optimizedFor:
+  - cursor
+  - claude-code

package/packages/velinstyle-skills/projects/portfolio.project.yaml

@@ -0,0 +1,12 @@
+id: portfolio
+name: Portfolio
+priority: recommended
+workflowGraph: landingpage
+packs:
+  - design
+  - frontend
+skills:
+  - velin-motion-reveal-feedback
+optimizedFor:
+  - cursor
+  - vscode

package/packages/velinstyle-skills/registry.json

@@ -0,0 +1,142 @@
+{
+  "version": "1.0.0",
+  "adapter": "velinstyle",
+  "skills": [
+    { "id": "velin-design-hero-compose", "name": "Hero Compose", "category": "design", "priority": "core", "status": "beta", "confidence": "high", "origin": "official", "capabilities": ["build", "review"], "estimatedComplexity": "medium", "estimatedTokens": 1200, "dependsOn": ["velin-dev-plan-first"], "requiresCli": ["plan", "scaffold", "review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode", "claude-code", "windsurf"], "inputs": ["prompt", "html", "screenshot"], "outputs": ["html", "review-json"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Composes first viewport hero following VelinStyle hierarchy and CTA constraints.", "prosePath": "skills/velin-design-hero-compose/SKILL.md" },
+    { "id": "velin-design-section-rhythm", "name": "Section Rhythm", "category": "design", "priority": "recommended", "status": "beta", "confidence": "high", "origin": "official", "capabilities": ["build"], "estimatedComplexity": "medium", "estimatedTokens": 900, "dependsOn": ["velin-design-hero-compose"], "requiresCli": ["scaffold"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["prompt", "html"], "outputs": ["html", "checklist"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Aligns spacing rhythm and section purpose to design rules.", "prosePath": "skills/velin-design-section-rhythm/SKILL.md" },
+    { "id": "velin-design-surface-roles", "name": "Surface Roles", "category": "design", "priority": "recommended", "status": "beta", "confidence": "medium", "origin": "official", "capabilities": ["build", "theme"], "estimatedComplexity": "low", "estimatedTokens": 700, "dependsOn": [], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html", "tokens"], "outputs": ["html", "report"], "onlyIf": ["project.hasTokens"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Maps sections to base/raised/overlay surface roles.", "prosePath": "skills/velin-design-surface-roles/SKILL.md" },
+    { "id": "velin-dev-plan-first", "name": "Plan First", "category": "development", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["ai-orchestration", "build"], "estimatedComplexity": "low", "estimatedTokens": 500, "dependsOn": [], "requiresCli": ["plan"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "claude-code"], "inputs": ["prompt"], "outputs": ["plan-json"], "onlyIf": [], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Creates a plan JSON before implementation to reduce hallucinations.", "prosePath": "skills/velin-dev-plan-first/SKILL.md" },
+    { "id": "velin-dev-page-scaffold", "name": "Page Scaffold", "category": "development", "priority": "core", "status": "beta", "confidence": "high", "origin": "official", "capabilities": ["build"], "estimatedComplexity": "medium", "estimatedTokens": 1000, "dependsOn": ["velin-dev-plan-first"], "requiresCli": ["scaffold", "review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["prompt", "plan-json"], "outputs": ["html", "review-json"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Renders plan-based HTML and runs review gates.", "prosePath": "skills/velin-dev-page-scaffold/SKILL.md" },
+    { "id": "velin-dev-component-wire", "name": "Component Wire", "category": "development", "priority": "recommended", "status": "beta", "confidence": "medium", "origin": "official", "capabilities": ["build"], "estimatedComplexity": "medium", "estimatedTokens": 800, "dependsOn": ["velin-components-select-compose"], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "claude-code"], "inputs": ["html", "docs"], "outputs": ["html", "diff"], "onlyIf": ["project.hasComponents"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": false, "deprecated": false, "replacement": null }, "description": "Wires selected components with predictable APIs and semantics.", "prosePath": "skills/velin-dev-component-wire/SKILL.md" },
+    { "id": "velin-components-select-compose", "name": "Select Components", "category": "components", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["build"], "estimatedComplexity": "low", "estimatedTokens": 650, "dependsOn": [], "requiresCli": ["blueprint"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "windsurf"], "inputs": ["prompt", "docs"], "outputs": ["html", "checklist"], "onlyIf": ["project.hasComponents"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Chooses component set that matches page intent and constraints.", "prosePath": "skills/velin-components-select-compose/SKILL.md" },
+    { "id": "velin-components-api-contract", "name": "API Contract", "category": "components", "priority": "recommended", "status": "beta", "confidence": "high", "origin": "official", "capabilities": ["documentation", "review"], "estimatedComplexity": "medium", "estimatedTokens": 900, "dependsOn": ["velin-components-select-compose"], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html", "docs"], "outputs": ["markdown", "report"], "onlyIf": ["project.hasComponents"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Validates component contracts and event/API usage.", "prosePath": "skills/velin-components-api-contract/SKILL.md" },
+    { "id": "velin-components-recipe", "name": "Component Recipe", "category": "components", "priority": "recommended", "status": "beta", "confidence": "medium", "origin": "official", "capabilities": ["build", "documentation"], "estimatedComplexity": "low", "estimatedTokens": 700, "dependsOn": ["velin-components-select-compose"], "requiresCli": ["scaffold"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor"], "inputs": ["prompt", "html"], "outputs": ["html", "markdown"], "onlyIf": ["project.hasComponents"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": false, "deprecated": false, "replacement": null }, "description": "Builds reusable component recipes for recurring UI blocks.", "prosePath": "skills/velin-components-recipe/SKILL.md" },
+    { "id": "velin-components-accessibility-map", "name": "Component Accessibility Map", "category": "components", "priority": "advanced", "status": "beta", "confidence": "medium", "origin": "official", "capabilities": ["accessibility", "documentation"], "estimatedComplexity": "medium", "estimatedTokens": 1100, "dependsOn": ["velin-components-api-contract"], "requiresCli": ["docs"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "claude-code"], "inputs": ["docs", "html"], "outputs": ["markdown", "report"], "onlyIf": ["project.hasComponents"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": false, "deprecated": false, "replacement": null }, "description": "Maps every chosen component to a11y expectations and test hooks.", "prosePath": "skills/velin-components-accessibility-map/SKILL.md" },
+    { "id": "velin-utilities-layout-apply", "name": "Utilities Layout Apply", "category": "utilities", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["build"], "estimatedComplexity": "low", "estimatedTokens": 600, "dependsOn": [], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "windsurf"], "inputs": ["html", "css"], "outputs": ["html", "diff"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Applies utility classes for layout and responsive structure.", "prosePath": "skills/velin-utilities-layout-apply/SKILL.md" },
+    { "id": "velin-utilities-prefix-fix", "name": "Utilities Prefix Fix", "category": "utilities", "priority": "recommended", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["migrate"], "estimatedComplexity": "low", "estimatedTokens": 500, "dependsOn": [], "requiresCli": ["prefix"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html", "css"], "outputs": ["diff", "report"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Normalizes classes to velin-* naming.", "prosePath": "skills/velin-utilities-prefix-fix/SKILL.md" },
+    { "id": "velin-utilities-token-map", "name": "Utilities Token Map", "category": "utilities", "priority": "advanced", "status": "beta", "confidence": "medium", "origin": "official", "capabilities": ["theme", "documentation"], "estimatedComplexity": "medium", "estimatedTokens": 950, "dependsOn": ["velin-utilities-layout-apply"], "requiresCli": ["tokens"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor"], "inputs": ["tokens", "css"], "outputs": ["markdown", "report"], "onlyIf": ["project.hasTokens"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": false, "deprecated": false, "replacement": null }, "description": "Documents how utility usage maps to token taxonomy.", "prosePath": "skills/velin-utilities-token-map/SKILL.md" },
+    { "id": "velin-themes-apply-token", "name": "Theme Apply Token", "category": "themes", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["theme", "build"], "estimatedComplexity": "low", "estimatedTokens": 600, "dependsOn": [], "requiresCli": ["themes", "tokens"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor"], "inputs": ["tokens", "html"], "outputs": ["css", "html"], "onlyIf": ["project.hasTokens"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Applies built-in themes through token-safe patterns.", "prosePath": "skills/velin-themes-apply-token/SKILL.md" },
+    { "id": "velin-themes-contrast-check", "name": "Theme Contrast Check", "category": "themes", "priority": "recommended", "status": "beta", "confidence": "high", "origin": "official", "capabilities": ["accessibility", "theme", "review"], "estimatedComplexity": "medium", "estimatedTokens": 1000, "dependsOn": ["velin-themes-apply-token"], "requiresCli": ["review", "scan"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html", "screenshot", "tokens"], "outputs": ["report", "review-json"], "onlyIf": ["project.hasTokens"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Checks token contrast and theme compatibility for WCAG goals.", "prosePath": "skills/velin-themes-contrast-check/SKILL.md" },
+    { "id": "velin-motion-reduced-safe", "name": "Motion Reduced Safe", "category": "motion", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["motion", "accessibility"], "estimatedComplexity": "low", "estimatedTokens": 550, "dependsOn": [], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "windsurf"], "inputs": ["html", "css"], "outputs": ["html", "report"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Applies motion while honoring prefers-reduced-motion.", "prosePath": "skills/velin-motion-reduced-safe/SKILL.md" },
+    { "id": "velin-motion-reveal-feedback", "name": "Motion Reveal Feedback", "category": "motion", "priority": "recommended", "status": "beta", "confidence": "medium", "origin": "official", "capabilities": ["motion", "build"], "estimatedComplexity": "medium", "estimatedTokens": 800, "dependsOn": ["velin-motion-reduced-safe"], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor"], "inputs": ["html", "css"], "outputs": ["html", "checklist"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": false, "deprecated": false, "replacement": null }, "description": "Adds intentional reveal and feedback motion hierarchies.", "prosePath": "skills/velin-motion-reveal-feedback/SKILL.md" },
+    { "id": "velin-a11y-page-checklist", "name": "A11y Page Checklist", "category": "accessibility", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["accessibility", "review"], "estimatedComplexity": "low", "estimatedTokens": 500, "dependsOn": [], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode", "claude-code"], "inputs": ["html", "docs"], "outputs": ["checklist", "report"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Runs page-level accessibility checklist before release.", "prosePath": "skills/velin-a11y-page-checklist/SKILL.md" },
+    { "id": "velin-a11y-scan-fix", "name": "A11y Scan Fix", "category": "accessibility", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["accessibility", "review"], "estimatedComplexity": "medium", "estimatedTokens": 900, "dependsOn": ["velin-a11y-page-checklist"], "requiresCli": ["scan"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html"], "outputs": ["report", "diff"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Uses scanner output to fix high-confidence accessibility issues.", "prosePath": "skills/velin-a11y-scan-fix/SKILL.md" },
+    { "id": "velin-a11y-focus-keyboard", "name": "Focus Keyboard", "category": "accessibility", "priority": "recommended", "status": "beta", "confidence": "high", "origin": "official", "capabilities": ["accessibility", "test"], "estimatedComplexity": "medium", "estimatedTokens": 850, "dependsOn": ["velin-a11y-page-checklist"], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor"], "inputs": ["html", "screenshot"], "outputs": ["report", "checklist"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Validates keyboard navigation and visible focus behavior.", "prosePath": "skills/velin-a11y-focus-keyboard/SKILL.md" },
+    { "id": "velin-testing-a11y-suite", "name": "Testing A11y Suite", "category": "testing", "priority": "recommended", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["test", "accessibility"], "estimatedComplexity": "medium", "estimatedTokens": 900, "dependsOn": ["velin-a11y-scan-fix"], "requiresCli": ["test:a11y"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html"], "outputs": ["report"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Runs accessibility test suite and triages regressions.", "prosePath": "skills/velin-testing-a11y-suite/SKILL.md" },
+    { "id": "velin-testing-visual-smoke", "name": "Testing Visual Smoke", "category": "testing", "priority": "advanced", "status": "beta", "confidence": "medium", "origin": "official", "capabilities": ["test", "review"], "estimatedComplexity": "medium", "estimatedTokens": 900, "dependsOn": ["velin-dev-page-scaffold"], "requiresCli": ["test:e2e"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "windsurf"], "inputs": ["html", "screenshot"], "outputs": ["report"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": false, "deprecated": false, "replacement": null }, "description": "Runs visual smoke checks across key breakpoints.", "prosePath": "skills/velin-testing-visual-smoke/SKILL.md" },
+    { "id": "velin-review-page-gate", "name": "Review Page Gate", "category": "review", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["review"], "estimatedComplexity": "low", "estimatedTokens": 550, "dependsOn": ["velin-a11y-page-checklist"], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "claude-code"], "inputs": ["html", "prompt"], "outputs": ["review-json"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Runs design/a11y/seo/perf/conversion gate and reports score.", "prosePath": "skills/velin-review-page-gate/SKILL.md" },
+    { "id": "velin-review-conversion-hero", "name": "Review Conversion Hero", "category": "review", "priority": "recommended", "status": "beta", "confidence": "medium", "origin": "official", "capabilities": ["review", "seo"], "estimatedComplexity": "medium", "estimatedTokens": 850, "dependsOn": ["velin-design-hero-compose"], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html", "prompt"], "outputs": ["report"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Reviews hero conversion quality and CTA hierarchy.", "prosePath": "skills/velin-review-conversion-hero/SKILL.md" },
+    { "id": "velin-review-seo-meta", "name": "Review SEO Meta", "category": "review", "priority": "recommended", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["review", "seo"], "estimatedComplexity": "low", "estimatedTokens": 700, "dependsOn": [], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html", "docs"], "outputs": ["report"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Checks SEO metadata and content semantics.", "prosePath": "skills/velin-review-seo-meta/SKILL.md" },
+    { "id": "velin-docs-component-guide", "name": "Docs Component Guide", "category": "documentation", "priority": "recommended", "status": "beta", "confidence": "high", "origin": "official", "capabilities": ["documentation"], "estimatedComplexity": "medium", "estimatedTokens": 1000, "dependsOn": ["velin-components-api-contract"], "requiresCli": ["docs"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["markdown", "docs"], "outputs": ["markdown"], "onlyIf": ["project.hasDocumentation"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Writes component-focused documentation with quality checklists.", "prosePath": "skills/velin-docs-component-guide/SKILL.md" },
+    { "id": "velin-docs-generate-api", "name": "Docs Generate API", "category": "documentation", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["documentation"], "estimatedComplexity": "low", "estimatedTokens": 550, "dependsOn": [], "requiresCli": ["docs"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "claude-code"], "inputs": ["docs"], "outputs": ["markdown", "report"], "onlyIf": ["project.hasDocumentation"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Generates API Markdown and verifies documentation footprint.", "prosePath": "skills/velin-docs-generate-api/SKILL.md" },
+    { "id": "velin-migration-prefix-classes", "name": "Migration Prefix Classes", "category": "migration", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["migrate"], "estimatedComplexity": "low", "estimatedTokens": 500, "dependsOn": [], "requiresCli": ["prefix"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html", "css"], "outputs": ["diff", "report"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Migrates class names to velin-* convention.", "prosePath": "skills/velin-migration-prefix-classes/SKILL.md" },
+    { "id": "velin-migration-legacy-wc", "name": "Migration Legacy WC", "category": "migration", "priority": "recommended", "status": "beta", "confidence": "high", "origin": "official", "capabilities": ["migrate", "review"], "estimatedComplexity": "medium", "estimatedTokens": 800, "dependsOn": ["velin-migration-prefix-classes"], "requiresCli": ["review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor"], "inputs": ["html", "docs"], "outputs": ["diff", "report"], "onlyIf": ["project.hasComponents"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Replaces legacy *-wc tags with canonical components.", "prosePath": "skills/velin-migration-legacy-wc/SKILL.md" },
+    { "id": "velin-release-changelog-sync", "name": "Release Changelog Sync", "category": "release", "priority": "recommended", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["release", "documentation"], "estimatedComplexity": "low", "estimatedTokens": 650, "dependsOn": ["velin-review-page-gate"], "requiresCli": ["docs"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["markdown", "docs"], "outputs": ["markdown", "checklist"], "onlyIf": ["project.hasDocumentation"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Keeps changelog and docs in sync before release.", "prosePath": "skills/velin-release-changelog-sync/SKILL.md" },
+    { "id": "velin-release-meta-rebuild", "name": "Release Meta Rebuild", "category": "release", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["release", "ai-orchestration"], "estimatedComplexity": "low", "estimatedTokens": 450, "dependsOn": [], "requiresCli": ["meta"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "claude-code"], "inputs": ["docs"], "outputs": ["meta-json", "report"], "onlyIf": [], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Rebuilds velin-agent.json and llms.txt before publishing.", "prosePath": "skills/velin-release-meta-rebuild/SKILL.md" },
+    { "id": "velin-dx-project-init", "name": "DX Project Init", "category": "developer-experience", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["dx", "build"], "estimatedComplexity": "low", "estimatedTokens": 450, "dependsOn": [], "requiresCli": ["init"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["docs"], "outputs": ["checklist"], "onlyIf": [], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Bootstraps VelinStyle projects with sane defaults.", "prosePath": "skills/velin-dx-project-init/SKILL.md" },
+    { "id": "velin-dx-doctor-setup", "name": "DX Doctor Setup", "category": "developer-experience", "priority": "advanced", "status": "experimental", "confidence": "medium", "origin": "official", "capabilities": ["dx", "review"], "estimatedComplexity": "medium", "estimatedTokens": 850, "dependsOn": ["velin-dx-project-init"], "requiresCli": ["scan"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor"], "inputs": ["docs", "html"], "outputs": ["report"], "onlyIf": [], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": false, "deprecated": false, "replacement": null }, "description": "Runs setup diagnostics and proposes fixes for dev experience gaps.", "prosePath": "skills/velin-dx-doctor-setup/SKILL.md" },
+    { "id": "velin-perf-audit-fix", "name": "Perf Audit Fix", "category": "performance", "priority": "recommended", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["performance", "review"], "estimatedComplexity": "medium", "estimatedTokens": 800, "dependsOn": [], "requiresCli": ["perf"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html"], "outputs": ["report", "diff"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Audits performance and applies safe optimization fixes.", "prosePath": "skills/velin-perf-audit-fix/SKILL.md" },
+    { "id": "velin-perf-runtime-tree-shake", "name": "Perf Runtime Tree Shake", "category": "performance", "priority": "advanced", "status": "beta", "confidence": "medium", "origin": "official", "capabilities": ["performance", "build"], "estimatedComplexity": "high", "estimatedTokens": 1300, "dependsOn": ["velin-perf-audit-fix"], "requiresCli": ["build"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor"], "inputs": ["html", "css"], "outputs": ["report", "diff"], "onlyIf": ["project.hasComponents"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": false, "deprecated": false, "replacement": null }, "description": "Reduces runtime payload using explicit component loading strategy.", "prosePath": "skills/velin-perf-runtime-tree-shake/SKILL.md" },
+    { "id": "velin-security-scan-pii", "name": "Security Scan PII", "category": "security", "priority": "core", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["security", "review"], "estimatedComplexity": "low", "estimatedTokens": 500, "dependsOn": [], "requiresCli": ["scan"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode", "claude-code"], "inputs": ["html", "docs"], "outputs": ["report"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Scans for PII exposure and common security mistakes.", "prosePath": "skills/velin-security-scan-pii/SKILL.md" },
+    { "id": "velin-security-sanitize-html", "name": "Security Sanitize HTML", "category": "security", "priority": "recommended", "status": "stable", "confidence": "high", "origin": "official", "capabilities": ["security", "build"], "estimatedComplexity": "medium", "estimatedTokens": 800, "dependsOn": ["velin-security-scan-pii"], "requiresCli": ["review"], "requiresMeta": false, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "vscode"], "inputs": ["html"], "outputs": ["diff", "report"], "onlyIf": ["project.hasHtml"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Applies safe HTML sanitization guidance for dynamic content.", "prosePath": "skills/velin-security-sanitize-html/SKILL.md" },
+    { "id": "velin-ai-agent-briefing", "name": "AI Agent Briefing", "category": "ai-workflows", "priority": "core", "status": "beta", "confidence": "high", "origin": "official", "capabilities": ["ai-orchestration", "documentation"], "estimatedComplexity": "low", "estimatedTokens": 550, "dependsOn": [], "requiresCli": ["meta"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "claude-code", "windsurf"], "inputs": ["docs", "meta-json"], "outputs": ["markdown", "checklist"], "onlyIf": [], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Prepares agent context and guardrails from velin metadata.", "prosePath": "skills/velin-ai-agent-briefing/SKILL.md" },
+    { "id": "velin-ai-plan-scaffold-review", "name": "AI Plan Scaffold Review", "category": "ai-workflows", "priority": "core", "status": "beta", "confidence": "high", "origin": "official", "capabilities": ["ai-orchestration", "build", "review"], "estimatedComplexity": "medium", "estimatedTokens": 1100, "dependsOn": ["velin-dev-plan-first", "velin-dev-page-scaffold", "velin-review-page-gate"], "requiresCli": ["plan", "scaffold", "review"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor", "claude-code"], "inputs": ["prompt"], "outputs": ["html", "review-json"], "onlyIf": [], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": true, "deprecated": false, "replacement": null }, "description": "Runs the canonical AI workflow from prompt to reviewed HTML.", "prosePath": "skills/velin-ai-plan-scaffold-review/SKILL.md" },
+    { "id": "velin-ai-skill-authoring", "name": "AI Skill Authoring", "category": "ai-workflows", "priority": "advanced", "status": "beta", "confidence": "medium", "origin": "official", "capabilities": ["ai-orchestration", "documentation"], "estimatedComplexity": "high", "estimatedTokens": 1400, "dependsOn": ["velin-ai-agent-briefing"], "requiresCli": ["docs", "meta"], "requiresMeta": true, "compatibility": { "framework": { "min": "1.2.0", "max": "2.x" }, "cli": { "min": "1.2.0" }, "agent": { "min": "1.0.0" }, "skillEngine": { "min": "1.0.0" } }, "optimizedFor": ["cursor"], "inputs": ["markdown", "docs", "meta-json"], "outputs": ["markdown", "registry-json"], "onlyIf": ["project.hasDocumentation"], "hooks": { "beforeRun": null, "afterRun": null, "onSuccess": null, "onFailure": null }, "telemetry": { "recommended": false, "deprecated": false, "replacement": null }, "description": "Authors new skills with registry-first metadata quality gates.", "prosePath": "skills/velin-ai-skill-authoring/SKILL.md" }
+  ],
+  "packs": [
+    { "id": "frontend", "name": "Frontend Pack", "version": "1.0.0", "priority": "core", "skills": ["velin-dx-project-init", "velin-dev-plan-first", "velin-dev-page-scaffold", "velin-components-select-compose", "velin-utilities-layout-apply"] },
+    { "id": "design", "name": "Design Pack", "version": "1.0.0", "priority": "recommended", "skills": ["velin-design-hero-compose", "velin-design-section-rhythm", "velin-design-surface-roles", "velin-themes-apply-token", "velin-motion-reduced-safe"] },
+    { "id": "accessibility", "name": "Accessibility Pack", "version": "1.0.0", "priority": "core", "skills": ["velin-a11y-page-checklist", "velin-a11y-scan-fix", "velin-a11y-focus-keyboard", "velin-testing-a11y-suite"] },
+    { "id": "documentation", "name": "Documentation Pack", "version": "1.0.0", "priority": "recommended", "skills": ["velin-docs-component-guide", "velin-docs-generate-api", "velin-release-changelog-sync"] },
+    { "id": "review", "name": "Review Pack", "version": "1.0.0", "priority": "core", "skills": ["velin-review-page-gate", "velin-review-conversion-hero", "velin-review-seo-meta", "velin-security-scan-pii"] },
+    { "id": "enterprise", "name": "Enterprise Pack", "version": "1.0.0", "priority": "advanced", "skills": ["velin-security-scan-pii", "velin-security-sanitize-html", "velin-perf-audit-fix", "velin-migration-prefix-classes", "velin-release-meta-rebuild"] }
+  ],
+  "workflowGraphs": [
+    {
+      "id": "landingpage",
+      "name": "Landing Page Workflow",
+      "entry": "plan",
+      "nodes": {
+        "plan": { "skill": "velin-dev-plan-first" },
+        "hero": { "skill": "velin-design-hero-compose" },
+        "sections": { "skill": "velin-design-section-rhythm" },
+        "components": { "skill": "velin-components-select-compose" },
+        "a11y": { "skill": "velin-a11y-page-checklist" },
+        "seo": { "skill": "velin-review-seo-meta" },
+        "review": { "skill": "velin-review-page-gate" },
+        "release": { "skill": "velin-release-meta-rebuild" }
+      },
+      "edges": [
+        { "from": "plan", "to": "hero" },
+        { "from": "hero", "to": "sections" },
+        { "from": "sections", "to": "components" },
+        { "from": "components", "to": "a11y" },
+        { "from": "components", "to": "seo" },
+        { "from": "a11y", "to": "review" },
+        { "from": "seo", "to": "review" },
+        { "from": "review", "to": "release", "when": "review.passed" }
+      ]
+    },
+    {
+      "id": "component-ship",
+      "name": "Component Ship Workflow",
+      "entry": "select",
+      "nodes": {
+        "select": { "skill": "velin-components-select-compose" },
+        "contract": { "skill": "velin-components-api-contract" },
+        "a11y": { "skill": "velin-components-accessibility-map" },
+        "docs": { "skill": "velin-docs-component-guide" },
+        "review": { "skill": "velin-review-page-gate" }
+      },
+      "edges": [
+        { "from": "select", "to": "contract" },
+        { "from": "contract", "to": "a11y" },
+        { "from": "a11y", "to": "docs" },
+        { "from": "docs", "to": "review" }
+      ]
+    },
+    {
+      "id": "release-gate",
+      "name": "Release Gate Workflow",
+      "entry": "review",
+      "nodes": {
+        "review": { "skill": "velin-review-page-gate" },
+        "perf": { "skill": "velin-perf-audit-fix" },
+        "security": { "skill": "velin-security-scan-pii" },
+        "changelog": { "skill": "velin-release-changelog-sync" },
+        "meta": { "skill": "velin-release-meta-rebuild" }
+      },
+      "edges": [
+        { "from": "review", "to": "perf" },
+        { "from": "review", "to": "security" },
+        { "from": "perf", "to": "changelog" },
+        { "from": "security", "to": "changelog" },
+        { "from": "changelog", "to": "meta" }
+      ]
+    }
+  ],
+  "bundles": [
+    { "id": "landing-starter", "origin": "official", "packs": ["frontend", "design", "review"], "graphs": ["landingpage"], "templates": ["landing-page"], "docs": ["docs/guides/ai-skills.html"] },
+    { "id": "review-suite", "origin": "official", "packs": ["accessibility", "review"], "graphs": ["release-gate"], "templates": [], "docs": ["docs/guides/ai-skills.html"] }
+  ],
+  "templates": [
+    { "id": "landing-page", "workflowGraph": "landingpage", "packs": ["frontend", "design"], "theme": "default", "demo": "samples/landing.html", "docs": ["docs/guides/prompt-scaffolding.html", "docs/guides/landing-15-min.html"], "starterFiles": ["templates/vite-velinstyle/index.html"], "defaults": { "pageIntent": "marketing-landing", "sections": ["hero", "features", "faq", "contact"] } },
+    { "id": "marketing-website", "workflowGraph": "landingpage", "packs": ["frontend", "design", "review"], "theme": "default", "demo": "samples/landing.html", "docs": ["docs/guides/prompt-scaffolding.html", "docs/guides/landing-15-min.html"], "starterFiles": ["templates/vite-velinstyle/index.html"], "defaults": { "pageIntent": "marketing-site", "sections": ["hero", "benefits", "proof", "faq", "contact"] } },
+    { "id": "documentation-portal", "workflowGraph": "component-ship", "packs": ["documentation", "review"], "theme": "default", "demo": "docs/index.html", "docs": ["docs/guides/ai-skills.html", "docs/guides/prompt-scaffolding.html"], "starterFiles": ["templates/vite-velinstyle/index.html"], "defaults": { "pageIntent": "docs-portal", "sections": ["hero", "toc", "examples", "faq"] } },
+    { "id": "admin-panel", "workflowGraph": "release-gate", "packs": ["enterprise", "review"], "theme": "midnight", "demo": "samples/dashboard.html", "docs": ["docs/guides/ai-skills.html", "docs/guides/prompt-scaffolding.html"], "starterFiles": ["templates/vite-velinstyle/index.html"], "defaults": { "pageIntent": "admin-panel", "sections": ["kpis", "table", "forms"] } },
+    { "id": "blog", "workflowGraph": "landingpage", "packs": ["frontend", "review"], "theme": "default", "demo": "samples/blog.html", "docs": ["docs/guides/ai-skills.html", "docs/guides/prompt-scaffolding.html"], "starterFiles": ["templates/vite-velinstyle/index.html"], "defaults": { "pageIntent": "blog", "sections": ["hero", "posts", "faq", "contact"] } },
+    { "id": "ecommerce-shop", "workflowGraph": "landingpage", "packs": ["frontend", "review", "enterprise"], "theme": "default", "demo": "samples/ecommerce.html", "docs": ["docs/guides/ecommerce.html", "docs/guides/prompt-scaffolding.html"], "starterFiles": ["templates/vite-velinstyle/index.html"], "defaults": { "pageIntent": "shop", "sections": ["hero", "products", "proof", "faq"] } },
+    { "id": "portfolio", "workflowGraph": "landingpage", "packs": ["design", "frontend"], "theme": "soft", "demo": "samples/portfolio.html", "docs": ["docs/guides/ai-skills.html", "docs/guides/prompt-scaffolding.html"], "starterFiles": ["templates/vite-velinstyle/index.html"], "defaults": { "pageIntent": "portfolio", "sections": ["hero", "projects", "about", "contact"] } },
+    { "id": "laravel-dashboard", "workflowGraph": "release-gate", "packs": ["enterprise", "frontend"], "theme": "midnight", "demo": "samples/dashboard.html", "docs": ["docs/guides/laravel.html"], "starterFiles": ["templates/vite-velinstyle/index.html"], "defaults": { "pageIntent": "dashboard", "sections": ["kpis", "table", "forms"] } }
+  ],
+  "projects": [
+    { "id": "marketing-website", "name": "Marketing Website", "priority": "recommended", "workflowGraph": "landingpage", "packs": ["frontend", "design", "review"], "skills": ["velin-ai-plan-scaffold-review", "velin-review-conversion-hero"], "optimizedFor": ["cursor", "claude-code"] },
+    { "id": "documentation-portal", "name": "Documentation Portal", "priority": "recommended", "workflowGraph": "component-ship", "packs": ["documentation", "review"], "skills": ["velin-docs-generate-api", "velin-ai-agent-briefing"], "optimizedFor": ["cursor", "vscode"] },
+    { "id": "admin-panel", "name": "Admin Panel", "priority": "recommended", "workflowGraph": "release-gate", "packs": ["enterprise", "review"], "skills": ["velin-perf-audit-fix", "velin-security-scan-pii"], "optimizedFor": ["cursor"] },
+    { "id": "landing-page", "name": "Landing Page", "priority": "core", "workflowGraph": "landingpage", "packs": ["frontend", "design"], "skills": ["velin-review-conversion-hero"], "optimizedFor": ["cursor", "windsurf"] },
+    { "id": "blog", "name": "Blog", "priority": "recommended", "workflowGraph": "landingpage", "packs": ["frontend", "review"], "skills": ["velin-review-seo-meta"], "optimizedFor": ["cursor"] },
+    { "id": "ecommerce-shop", "name": "E-Commerce Shop", "priority": "advanced", "workflowGraph": "landingpage", "packs": ["enterprise", "review"], "skills": ["velin-security-sanitize-html", "velin-review-conversion-hero"], "optimizedFor": ["cursor"] },
+    { "id": "portfolio", "name": "Portfolio", "priority": "recommended", "workflowGraph": "landingpage", "packs": ["design", "frontend"], "skills": ["velin-motion-reveal-feedback"], "optimizedFor": ["cursor", "vscode"] },
+    { "id": "laravel-dashboard", "name": "Laravel Dashboard", "priority": "advanced", "workflowGraph": "release-gate", "packs": ["enterprise", "frontend"], "skills": ["velin-dx-project-init"], "optimizedFor": ["cursor", "claude-code"] }
+  ]
+}