ValentinNikolaev/agent-skills / agent-plugins/skills/github-pages-audit
github-pages-audit
VerifiedAudit a rendered GitHub Pages site or production-equivalent build and report UX and accessibility findings without edits. Use for Pages verification, not source-only review or implementation.
| File | Kind | Size |
|---|---|---|
| LICENSE.designer-skills | other | 1.0 KB |
| SKILL.md | skill md | 3.6 KB |
| agents/openai.yaml | config | 247 B |
| references/rendered-pages-audit.md | markdown | 4.4 KB |
references/rendered-pages-audit.md
View on GitHub# Rendered GitHub Pages audit
## Preconditions and evidence
Serve the production output under the expected project or custom-domain base path. Record unavailable tools and inaccessible routes. Use repository files as the authority for branding, supported content, and intended behavior; do not invent a design specification.
Check only applicable features and supported themes. Record absent features `not applicable` with a reason and missing evidence `not verified`. Identify the build's source snapshot and do not claim a stale build represents current edits. Source facts, rendered observations, tested interactions, assumptions, and design judgments are different evidence types.
## Reader journey and information architecture
- The site's purpose and primary next action are apparent on entry.
- Installation or first-success instructions include prerequisites, commands, expected result, and recovery.
- Global and local navigation use consistent labels and expose the current location.
- Important destinations are reachable without relying on search.
- Links, breadcrumbs, previous/next controls, and source/edit links go where their labels predict.
- Legacy deep links, anchors, assets, and not-found behavior work under the production base path.
## Content and density
- Each page has one clear primary task and removes unrelated filler.
- Headings, summaries, lists, and callouts support scanning.
- Primary information is not buried in tooltips, collapsed regions, or low-contrast metadata.
- Commands, names, versions, and claims agree with repository evidence.
- Empty, missing, and zero-results states explain what happened and offer a useful next action.
## Visual hierarchy and brand
- The page title or primary proposition is the first meaningful visual entry point.
- Heading levels, body text, metadata, links, and primary actions have distinct roles.
- Spacing groups related content and separates sections consistently.
- Colors, type, radii, icons, logos, and imagery follow repository tokens or documented branding when available.
- Hard-coded exceptions are justified rather than accidental drift.
## Responsive layout
At representative desktop and narrow mobile widths verify:
- navigation remains available and does not obscure content;
- reading order survives column reflow;
- tables, code, long URLs, headings, media, and controls do not clip;
- page-level horizontal scrolling is absent;
- touch targets and spacing remain usable;
- zoom and increased text size do not hide information or actions;
- hover is not the only way to discover or operate a control.
## Accessibility and interaction
- Keyboard order is logical and focus is visible in every theme.
- Skip links, landmarks, headings, link names, button names, and form labels are meaningful.
- Informative images have useful alternatives; decorative images are ignored appropriately.
- Text and component contrast are checked for the actual rendered pairings.
- Status, warnings, links, and callouts do not rely on color alone.
- Mobile menus, search, tabs, copy buttons, and theme controls expose state and work without a pointer.
- Motion respects reduced-motion preferences and does not block reading or navigation.
- Focus is not trapped or lost when menus, dialogs, or route transitions occur.
## Search and technical content
When present:
- search is labelled, keyboard reachable, and returns representative repository terms;
- results show enough matching context to choose a destination;
- zero results provide correction or browse alternatives;
- code languages are identified when known;
- copy controls announce success and remain keyboard operable;
- code and tables scroll locally without forcing the entire page to overflow.
## Severity
- **Critical:** blocks access to the site or a primary task for an affected audience.
- **Major:** causes substantial difficulty, broken navigation, or loss of important content.
- **Minor:** creates friction or inconsistency with a practical workaround.
- **Enhancement:** improves quality without repairing a demonstrated failure.
Automated findings require manual confirmation. Missing tooling belongs in audit limitations, not silently in a passing verdict.
Assign severity by reader impact, not by recognizability as “AI design.” A chosen palette, Inter/system font, gradient, or card is not a defect by itself. Report useful improvements separately from confirmed defects, and allow a healthy result without changes.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |