Communitygithub.com

husheng-web/personal-website-skills

Hinzufügen oder Überprüfen eines barrierefreien Portfolio-Projektvorschau-Readers für geordnete lange Bilder, Dokumentseiten oder gestaffelte visuelle Module.

Was ist personal-website-skills?

Diese Skill-Anleitung beschreibt, wie ein barrierefreier Lese-Modus für Portfolio-Projektvorschauen in eine bestehende Webanwendung integriert wird, ohne den normalen Browser-Fluss zu stören. Sie richtet sich an Entwickler, die eine konsistente, eingebettete Vorschau für lange Bildserien, Dokumentseiten oder modulare visuelle Projekte benötigen. Die Implementierung setzt voraus, dass der vorhandene Zustand von Archiv-/Dialog-Modellen, Dokument-Reader-Pfaden, dem Projekt-Registry-System und mobilen Styles geprüft wird, um sicherzustellen, dass nur tatsächlich wiederverwendbare Abstraktionen verallgemeinert werden. Zu den Kernanforderungen gehören die Wahrung der Quellreihenfolge mit barrierefreien Labels, ein vertikaler Lesebereich ohne horizontale Überläufe, die Beibehaltung bestehender Dialog-Interaktionen (Schließen, Escape-Taste, Fokus-Wiederherstellung) und die Vermeidung defekter Detailseiten. Die Validierung umfasst Asset-Ladechecks, Label-Präsenz, Vorschau-Öffnen/Schließen-Funktion und horizontale Überlaufkontrolle auf Desktop und Mobilgeräten sowie TypeScript-, Lint- und Produktionsbuild-Prüfungen nach Codeänderungen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/husheng-web/personal-website-skills/tree/HEAD/skills/portfolio-project-preview-reader

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Portfolio-Projektvorschau-Reader

Präsentieren Sie genehmigte langformatige Projektvisualisierungen innerhalb einer bestehenden Archiv-Vorschau, ohne den umgebenden Browser-Fluss zu unterbrechen.

Vor der Implementierung

Überprüfen Sie das Archiv-/Dialog-Zustandsmodell, vorhandene Dokument-Reader-Pfade, das Projekt-Registry-System, die Quell-Asset-Reihenfolge und die mobilen Styles. Verallgemeinern Sie nur ein tatsächlich wiederholtes Verhalten; behalten Sie einmalige Projektregeln lokal, wenn keine wiederverwendbare Abstraktion gerechtfertigt ist.

Anforderungen

  • Bewahren Sie die deklarierte Quellreihenfolge und geben Sie jeder Seite oder jedem Modul ein barrierefreies, lokalisiertes Label.
  • Verwenden Sie eine enthaltene vertikale Leseoberfläche; erweitern Sie die Seite nicht unerwartet und führen Sie keinen horizontalen Überlauf ein.
  • Bewahren Sie die bereits vom Vorschau-Dialog bereitgestellten Funktionen: Schließen, Escape-Taste, Fokus-Wiederherstellung, Scroll-Sperre und Tastaturverhalten.
  • Leiten Sie nur dann zu einer Detailseite weiter, wenn diese veröffentlichungsfähig ist; setzen Sie keine defekte oder semantisch doppelte Zielseite aus.

Validierung

Prüfen Sie, ob alle Assets geladen werden, geordnete Labels vorhanden sind, die Vorschau geöffnet/geschlossen werden kann und die Reader-Breite auf Desktop- und Mobilgrößen keinen horizontalen Überlauf aufweist. Führen Sie nach Codeänderungen TypeScript-, Lint- und Produktionsbuild-Prüfungen durch.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Verwandte Skills