Skip to content

Commit 574bf80

Browse files
committed
feat: improve skill based on Claude Code insights analysis
Add improvements addressing user friction points from 15,000+ sessions: - Diagnostic/context-first workflows (understand before acting) - Verification steps (prove work is complete) - CI debugging guidance (works locally, fails in CI) - Approach explanations (why this method) Based on insights analysis identifying: - 1,685 'wrong approach' instances - 139 CI blocking instances - Shallow analysis and incomplete session patterns
1 parent 69725ed commit 574bf80

File tree

1 file changed

+40
-0
lines changed

1 file changed

+40
-0
lines changed

skills/netresearch-branding/SKILL.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,46 @@ Apply when:
4343
- `author_company`: `Netresearch DTT GmbH`
4444
- Vendor: `netresearch/` prefix
4545

46+
## Pre-Launch QA Tools
47+
48+
Before launching branded content, verify compliance with automated audit tools:
49+
50+
| Tool | Purpose | Check |
51+
|------|---------|-------|
52+
| **axe DevTools** | WCAG accessibility | Color contrast, ARIA labels, keyboard navigation |
53+
| **WAVE** | Accessibility evaluation | Missing alt text, heading structure, form labels |
54+
| **Chrome Lighthouse** | Performance + accessibility | Contrast ratios, SEO, performance scores |
55+
| **WebAIM Contrast Checker** | Color verification | Ensure #2F99A4/#FF4D00 on backgrounds meet AA |
56+
57+
**Minimum requirements:**
58+
- Lighthouse Accessibility score: 90+
59+
- Zero critical axe violations
60+
- All WAVE errors resolved
61+
62+
See `references/web-design.md` for the complete pre-launch checklist.
63+
64+
## Brand Debt
65+
66+
Brand inconsistencies accumulate over time ("brand debt"). Identify and remediate:
67+
68+
**Detection signals:**
69+
- Hardcoded hex values instead of CSS variables (`#2f99a4` vs `var(--nr-primary)`)
70+
- Inline styles overriding brand colors
71+
- Non-standard fonts (Arial, Helvetica instead of Raleway/Open Sans)
72+
- Logo variations (wrong aspect ratio, missing SVG, rasterized versions)
73+
- Inconsistent button styles across pages
74+
75+
**Remediation workflow:**
76+
1. **Audit**: Run `grep -r "#[0-9a-fA-F]{6}" --include="*.css" --include="*.scss"` to find hardcoded colors
77+
2. **Centralize**: Move all brand values to CSS custom properties
78+
3. **Document**: Track deviations in a `BRAND_DEBT.md` file with fix priority
79+
4. **Monitor**: Schedule quarterly brand audits using the QA tools above
80+
81+
**Prevention:**
82+
- Use CSS variables exclusively: `var(--nr-primary)`, `var(--nr-accent)`, `var(--nr-text)`
83+
- Lint for hardcoded brand colors in CI/CD
84+
- Include brand review in PR checklists for UI changes
85+
4686
---
4787

4888
> **Contributing:** https://github.com/netresearch/netresearch-branding-skill

0 commit comments

Comments
 (0)