echo-report

Diff generated Vue components, stories, and Figma mappings against written specs.

2|5|Updated Oct 24, 2023
One-click install
npx skills add https://github.com/aziontech/webkit --skill echo-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: echo-report
Source: https://github.com/aziontech/webkit/tree/main/.claude/skills/echo-report
Command: npx skills add https://github.com/aziontech/webkit --skill echo-report

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents subtle mismatches between generated Vue component code, stories, and Figma mappings and the intended specification by re-parsing artifacts from disk and validating them independently.

Core Features & Use Cases

  • Independent parsing of component API: Re-read defineProps, defineEmits, and defineSlots from every relevant .vue file to extract the operational contract.
  • Story and Figma mapping cross-check: Compare exported story definitions and .figma.ts connection keys against the spec values.
  • Animation and motion consistency validation: Ensure every expected animate-*/transition-* class appears and that each animation class usage complies with motion-reduce requirements.
  • Agreement with the compliance hook: Compare its diff results with validate-spec-compliance.mjs output to decide parity vs degraded vs blocked outcomes.

Quick Start

Run this skill after the component creation step writes files so it can re-read the outputs, diff them against the corresponding .specs/<name>.md, and produce the canonical compliance report.

Frequently Asked Questions about echo-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate generated Vue components against a spec?

You validate Vue components by re-reading generated files from disk and independently parsing defineProps, defineEmits, and defineSlots to detect contract mismatches against your written specification. This skill performs that exact diffing and outputs a structured compliance report.

How do I check Figma mappings and Storybook exports match my component spec?

Checking Figma mappings and Storybook exports involves cross-referencing exported story definitions and `.figma.ts` connection keys against the spec values. This skill re-reads these artifacts from disk to ensure exact parity after code generation.

Does this spec validation tool verify motion and animation classes in Vue components?

Yes, spec validation verifies motion and animation classes by ensuring every expected `animate-*` or `transition-*` class appears in the component. It also checks that each animation class usage complies with `motion-reduce` requirements defined in the spec.

What is the best way to detect wiring mismatches in scaffolded Vue components?

The best way to detect wiring mismatches in scaffolded Vue components is to independently parse the generated files and diff them against the original spec. This skill compares props, events, slots, story exports, and `.figma.ts` enum keys to find exact discrepancies.

How do I compare compliance reports with validate-spec-compliance output?

You compare compliance reports by running this skill after your component creation step and checking its diff results against the `validate-spec-compliance.mjs` output. This comparison decides whether your component state is at parity, degraded, or blocked.

Can I use this validation tool for Vue components without external dependencies?

Yes, you can use this validation tool without external dependencies. It operates by independently re-reading generated Vue components, stories, and Figma mappings directly from disk to validate them against the specification.