Communitygithub.com

AradhanaID/agent-skills

Legt fest, wo Frontend-Dateien in diesem Repository abgelegt werden. Wird beim Erstellen einer neuen Datei oder beim Verschieben einer Datei ausgelöst.

Was ist agent-skills?

Diese Skill orientiert sich an der Struktur von Frontend-Code: Ordnerkonventionen, Namensgebung und die Erkennung von falsch platzierten Dateien. Sie hilft Entwicklern und KI-Agenten, Dateien basierend auf ihrem Typ (Komponente, Hook, Utility, Test, Asset, Konfiguration) korrekt zu platzieren. Die Skill unterstützt gängige Code-Editoren und KI-Assistenten und arbeitet nach einem klaren Drei-Schritte-Prozess: Dateityp bestimmen, nach Regeln ablegen und Benennung mit benachbarten Dateien abgleichen. Die autoritativen Regeln befinden sich in der referenzierten Datei reference.md, die als einzige Quelle der Wahrheit dient. Bei Namens- oder Regelkonflikten wird der spezifischere Fall bevorzugt und der Konflikt gemeldet, damit die Regeln korrigiert werden können. Diese Skill ist besonders nützlich, um Konsistenz in großen oder wachsenden Frontend-Projekten zu wahren und das manuelle Nachschlagen von Konventionen zu vermeiden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AradhanaID/agent-skills/tree/HEAD/skills/structure

In Ihrer bevorzugten KI fragen

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

Dokumentation

Struktur

Diese Skill orientiert sich daran, wo Frontend-Code lebt: Ordnerkonventionen, Namensgebung und was eine Datei als falsch platziert kennzeichnet. Die Konventionen bewegen sich mit der Codebasis, daher befindet sich die maßgebliche Liste in reference.md – lesen Sie diese, bevor Sie eine Datei platzieren.

Schritte

  1. Fragen Sie, was die Datei ist, nicht wo sie hingehört. Komponente, Hook, Utility, Test, Asset, Konfiguration. Die Art bestimmt die Platzierung; die Art ist ein Leitwort für die Konventionen in reference.md. Erledigt-wenn: die Art in einem Wort genannt ist.
  2. Platzieren Sie nach den Regeln, ganze Einheiten auf einmal. Eine Komponente wird zusammen mit ihrem Test, ihrer Story und ihren Styles verschoben – niemals die Komponente allein. Erledigt-wenn: die Platzierung den Regeln wörtlich entspricht; alles, was von der Namensgebung abweicht, wird am Ende des Durchlaufs mit einem Grund aufgelistet.
  3. Bestätigen Sie die Benennung anhand der Nachbarn. Der Name stimmt mit den Geschwisterdateien und der allgemeinen Konvention überein: Singular/Plural, Punkt-Trennung, Groß-/Kleinschreibung. Erledigt-wenn: eine Verzeichnisauflistung einheitlich aussieht; nichts muss umbenannt werden, um sich anzupassen.

Referenz

  • reference.md – die Platzierungsregeln und Namenskonventionen. Aktualisieren Sie sie, wenn sich das Layout des Repos festigt; sie ist die einzige Quelle der Wahrheit, und an anderer Stelle genannte Konventionen sind Beinahe-Orte dieser Datei.
  • Wenn zwei Regeln in Konflikt zu stehen scheinen, gewinnt die spezifischere, und der Konflikt wird gemeldet, damit die Regeln korrigiert werden können.

Individual skills in this repo

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

Verwandte Skills