[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78F7NG34ATKEQ69DM0MZHA3":3,"skill-same:01M78F7NG34ATKEQ69DM0MZHA3":69},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":28,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M78F7NG34ATKEQ69DM0MZHA3","component-specification",null,"poppyTM\u002Foride","poppyTM","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F339400917?v=4","01M78F6YNKFR5S5JQR27X9F09Z","Poppy Team","01M78F6YP8ZZTRES9X8Q2ZAD21",1,"MIT","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcomponent-specification\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# Component Specification\n\n## Purpose\nWrite implementation-ready component specifications: typed props API, variant and size matrices, controlled\u002Funcontrolled state contracts, slot\u002Fevent surfaces, and keyboard\u002FARIA behavior — so engineers build exactly what design intended with zero ambiguity.\n\n## Use when\n- Specifying a new or changed UI component (props, variants, states, events).\n- Defining keyboard interaction, focus management, and ARIA contracts for a component.\n- Enumerating the state matrix (default, loading, empty, error, disabled) and responsive breakpoints.\n- Freezing a component API before implementation or design-system release.\n\n## Do not use when\n- Exploring open-ended UX directions (use `design-research`).\n- Auditing whole screens for WCAG conformance (use `accessibility`).\n- Theming tokens or global styles rather than per-component contracts (use `wireframe-styleguide`).\n\n## Required context\n- Component inventory: names, usage contexts, and design-token dependencies.\n- Prop\u002Fstate matrix requirements: variants, sizes, controlled vs uncontrolled states.\n- Keyboard and screen-reader interaction contracts per component.\n\n## Procedure\n1. **Fix Identity & Scope**: Name the component, its single responsibility, and explicit non-goals. Example: `DataTable` owns tabular display, sorting, and row selection; it does not own pagination controls (separate `Paginator`).\n2. **Type the Props API**: List every prop with name, type, required\u002Foptional, default, and constraints (e.g., `density: 'compact' | 'comfortable' = 'comfortable'`). Mark which props are controlled (parent-owned) vs uncontrolled (internal state with `default*` initializer).\n3. **Enumerate Variants & States**: Build the variant × state matrix: variants (primary\u002Fsecondary\u002Fdanger), sizes (sm\u002Fmd\u002Flg), states (default, hover, focus, active, loading, empty, error, disabled). Every cell must have a defined visual and behavior; `N\u002FA` cells need a reason.\n4. **Contract Keyboard & ARIA**: Specify the full keyboard map (e.g., `ArrowUp\u002FDown` move, `Home\u002FEnd` jump, `Type-ahead` filters), focus trap\u002Freturn rules for overlays, roving-tabindex vs aria-activedescendant choice, and required roles\u002Fattributes (`role=\"dialog\"`, `aria-modal=\"true\"`, labelledby\u002Fdescribedby wiring).\n5. **Define Slots & Events**: List named slots (header, footer, empty-state) and emitted events with payloads (e.g., `onSortChange({ columnId, direction })`). Events carry data, never DOM nodes.\n6. **Verify**: Run `scripts\u002Fverify.sh`. Confirm every prop is typed with defaults, every matrix cell resolved, keyboard map complete, and ARIA wiring explicit.\n\n## Decision rules\n- **No Untyped Props**: `any`-typed or undocumented props are forbidden; every prop has type, default, and constraint.\n- **Controlled Clarity**: Each piece of state is declared controlled or uncontrolled — never both, never ambiguous.\n- **Keyboard Completeness**: If a mouse user can do it, the spec defines the keyboard equivalent or explicitly justifies the exception.\n- **Matrix Closure**: No `TBD` cells in the variant × state matrix at sign-off; unknowns become tracked follow-ups with owners.\n\n## Evidence required\n- Component spec sheet with typed props, variants, and state contracts.\n- Keyboard\u002FARIA contract with focus-management rules.\n- State-matrix fixtures covering default\u002Floading\u002Fempty\u002Ferror\u002Fdisabled.\n- Passing execution log from `scripts\u002Fverify.sh`.\n\n## Output contract\n- Component specification sheets with typed props, variants, and state contracts.\n- Keyboard\u002FARIA contract per component with focus-management rules.\n- State-matrix test fixtures covering default\u002Floading\u002Fempty\u002Ferror\u002Fdisabled.\n\n## Stop conditions\n- All components specified with props, variants, and keyboard contracts plus state fixtures.\n- Matrix fully closed; exceptions justified in writing.\n- Token budget exhausted.\n\n## Escalation rules\n- Escalate to design-system lead if a component's scope overlaps another component's contract (ownership decision).\n- Escalate immediately if accessibility requirements conflict with the requested visual design (needs product-level tradeoff).\n",{},"main","1cd515630b8ceb57777d466bee4970fe7c2e30e0",".agents\u002Fskills\u002Fcomponent-specification",0,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride","https:\u002F\u002Fgithub.com\u002FpoppyTM","https:\u002F\u002Fpoppy.lat","Construímos linguagens de programação e ferramentas para quem lê código com o mesmo cuidado com que escreve.","2026-09-30 10:15:52",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add poppyTM\u002Foride --skill component-specification",{"tool":37,"command":38},"bunx","bunx skills add poppyTM\u002Foride --skill component-specification",{"tool":40,"command":41},"pnpm","pnpm dlx skills add poppyTM\u002Foride --skill component-specification","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcomponent-specification\u002FSKILL.md",true,[45,51,55,59,65],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"checks\u002Fcomponent-specification-checklist.md","REFERENCE","参考文档",1413,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcomponent-specification\u002Fchecks\u002Fcomponent-specification-checklist.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"manifest.json",1732,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcomponent-specification\u002Fmanifest.json",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fcomponent-specification-guide.md",2167,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcomponent-specification\u002Freferences\u002Fcomponent-specification-guide.md",{"path":60,"resourceType":61,"resourceTypeDesc":62,"sizeBytes":63,"sourceHtmlUrl":64},"scripts\u002Fverify.sh","SCRIPT","脚本",3788,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcomponent-specification\u002Fscripts\u002Fverify.sh",{"path":66,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":67,"sourceHtmlUrl":68},"templates\u002Fwireframe-spec.md",1835,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fcomponent-specification\u002Ftemplates\u002Fwireframe-spec.md",[70,76,82,89,96,103],{"skillNo":71,"name":72,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M78FHQN254KEH0DETXT5JM29","zoom-reflow","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fzoom-reflow\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M78FHP1880S695V8GQEE0RXK","wireframe-styleguide","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fwireframe-styleguide\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M78FHHYM6AN2H819FABW01DZ","visual-regression","Pixel-by-pixel snapshot testing, Playwright integration, dynamic content masking, deterministic font rendering, and cross-browser CI gates","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fvisual-regression\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":18},"01M78FHE53D8DD0QVRY5C37DA4","ui-implementation","Component-driven UI implementation, multi-state matrix (default, hover, focus-visible, active, disabled, loading, empty, error), DTCG design tokens, responsive layout contracts, and accessibility tree mapping.","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fui-implementation\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":18},"01M78FHBJ1KXFF734GFE509TBJ","tui-editor-engine","Text buffer and editing semantics for a terminal code editor — index conversion, transaction-first editing, multi-cursor invariants, undo grouping, and large-file behaviour.","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Ftui-editor-engine\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":18},"01M78FH9X6CPJX1H61ZDWTTVW8","tree-sitter-context-indexing","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Ftree-sitter-context-indexing\u002FSKILL.md",[],[]]