[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ED5XKQCE9JV259KDVZGSZQ":3,"skill-same:01M7ED5XKQCE9JV259KDVZGSZQ":49},{"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":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":27,"updatedAt":28,"install":29,"resources":42},"01M7ED5XKQCE9JV259KDVZGSZQ","design-debt-audit",null,"jonahthan433\u002FCortexOS","jonahthan433","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211465495?v=4","01M7ECH9HPHGA89DCXHHJBTS3C","jonah.ai","01M7ECH9JCEM45DZMWPT7148S1",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fdesign-debt-audit\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# design-debt-audit\n\n# Design Debt Audit\nYou are an expert in systematically identifying and triaging design debt before it becomes structural.\n## What You Do\nYou conduct design debt audits that surface inconsistencies, outdated patterns, accessibility gaps, and structural problems — and produce a prioritized remediation plan that teams can act on.\n## What Counts as Design Debt\nDesign debt is any gap between the current state of the product and the standard it should meet. Categories:\n### Visual Inconsistency Debt\n- Components that exist in the product but deviate from the design system (wrong color, spacing, type)\n- Multiple visual treatments for the same interaction (three different button styles doing the same thing)\n- Legacy UI that predates the current design system and hasn't been updated\n### Structural Debt\n- Patterns that were designed for an earlier version of the product and don't scale to current complexity\n- Navigation that has been patched with new items and no longer reflects the underlying IA\n- Features that were added without holistic design, creating isolated islands in the product\n### Accessibility Debt\n- Known WCAG violations that haven't been fixed\n- Components that work visually but fail with assistive technology\n- Missing keyboard navigation, focus management, or screen reader support\n### Documentation Debt\n- Components in use that aren't in the design system\n- Specs that don't match implementation\n- Design decisions that exist only in someone's head\n### Technical\u002FImplementation Debt (design-relevant)\n- Designs that were implemented with hardcoded values instead of tokens\n- Components that were built differently across platforms (iOS, Android, web) without a documented reason\n## Audit Process\n### 1. Scope and Inventory\n- Define audit scope: full product, one feature area, or one platform\n- Screenshot every screen\u002Fstate in scope\n- Catalog by screen type, component type, or user flow\n### 2. Classify Debt\nFor each screen or component, tag:\n- **Severity**: Critical (accessibility violation, major inconsistency) \u002F Moderate (visual inconsistency, outdated pattern) \u002F Minor (polish, edge case)\n- **Category**: Visual \u002F Structural \u002F Accessibility \u002F Documentation \u002F Implementation\n- **Frequency**: How many times does this issue appear?\n- **Effort to fix**: Low \u002F Medium \u002F High (rough engineering estimate)\n### 3. Quantify\n- Total instances per issue type\n- Estimated user reach (how many users encounter each debt item?)\n- Business risk (does this debt create compliance, legal, or trust risk?)\n### 4. Prioritize\nScore debt items using: Severity × Frequency \u002F Effort\nSurface a short list of high-priority items — the debt that's causing the most harm per unit of effort to fix.\n### 5. Remediation Plan\n- **Quick wins**: low-effort, high-frequency inconsistencies (token fixes, label updates)\n- **Structural projects**: require design and engineering investment; schedule into roadmap\n- **Accessibility fixes**: prioritize Critical violations; create a rolling fix backlog for Moderate\n- **Write-off items**: debt that exists in low-traffic areas and will be resolved by a planned redesign — document and defer\n## Debt Register\nMaintain a living document (not a one-time audit) tracking:\n- Issue description\n- Category and severity\n- Affected screens\u002Fcomponents\n- Status (open, in progress, resolved, deferred)\n- Owner\n- Target resolution (sprint or milestone)\nReview the register quarterly; update severity as the product changes.\n## Common Findings\n- Navigation items added without IA review → structural nav debt\n- Features shipped under deadline without design system components → visual inconsistency debt\n- Third-party integrations with their own UI → visual inconsistency + accessibility debt\n- Rapid growth in content types not anticipated in original layout → structural debt\n## Best Practices\n- Run a design debt audit before starting a major redesign — it defines the actual scope of work\n- Separate audit from remediation; auditing is research, not a fix sprint\n- Include engineering in severity and effort estimation — designers often underestimate implementation complexity\n- Track debt reduction as a metric; use it to advocate for dedicated cleanup capacity in roadmap planning\n- Prevent accumulation: include \"does this create design debt?\" as a question in design review checklists\n",{},"main","38b32c99e7ed0b8e215d638e92cfa452c1ec3079","skills\u002Fimported\u002Fproductivity\u002Fdesign-debt-audit","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS","https:\u002F\u002Fgithub.com\u002Fjonahthan433","AI Consultant","2026-10-24 05:13:39",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add jonahthan433\u002FCortexOS --skill design-debt-audit",{"tool":35,"command":36},"bunx","bunx skills add jonahthan433\u002FCortexOS --skill design-debt-audit",{"tool":38,"command":39},"pnpm","pnpm dlx skills add jonahthan433\u002FCortexOS --skill design-debt-audit","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fdesign-debt-audit\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"skill.json","REFERENCE","参考文档",409,"https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fdesign-debt-audit\u002Fskill.json",[50,56,62,68,74,80],{"skillNo":51,"name":52,"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":53,"categories":54,"keywords":55,"publishedAt":18},"01M7EDQZDQX3Q8Y7GCQX6KN9V7","opportunity-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fsales\u002Fopportunity-brief\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"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":59,"categories":60,"keywords":61,"publishedAt":18},"01M7EDQYA0V9Y99VKBREJJ3MRT","morning-intel","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fmorning-intel\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"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":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EDQVX1JVY0B6PDHKKGM19G","decision-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fdecision-brief\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"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":71,"categories":72,"keywords":73,"publishedAt":18},"01M7EDQV1GENZAC2SZSD8KZ3GM","weekly-review","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fweekly-review\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"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":77,"categories":78,"keywords":79,"publishedAt":18},"01M7EDQT2KETJ1Y3CGVN9EKW2J","system-health","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fsystem-health\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"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":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EDQQN2JK3XPWMS1M4T0F3K","backup-restore","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fbackup-restore\u002FSKILL.md",[],[]]