Communitygithub.com

ASoudy/AGS

Wandelt ein bewährtes Muster aus dem automatischen Speicher (MEMORY.md) in CLAUDE.md oder .claude/rules/ um, um es dauerhaft durchzusetzen.

Was ist AGS?

Diese Fertigkeit wandelt automatisch gesammelte Beobachtungen (aus MEMORY.md) in dauerhafte, durchsetzbare Regeln um, die in CLAUDE.md oder .claude/rules/ gespeichert werden. Sie ist nützlich für Entwickler, die mit KI-Agenten wie Claude Code arbeiten und sicherstellen möchten, dass wiederkehrende Erkenntnisse und Konventionen nicht nur als Notizen vorliegen, sondern als verbindliche Anweisungen für zukünftige Sitzungen gelten. Die Fertigkeit unterstützt die Auswahl des optimalen Ziels (projektweit oder bereichsspezifisch), destilliert die Beschreibungen aus dem automatischen Speicher in präskriptive Einzeiler, fügt diese in die entsprechenden Regeldateien ein und bereinigt den automatischen Speicher, um Platz für neue Erkenntnisse zu schaffen. Ein Entscheidungsleitfaden hilft dabei, zu beurteilen, ob ein Muster förderungswürdig ist (z. B. nach drei Wiederholungen) oder besser im automatischen Speicher verbleibt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/nginity-skills-library/engineering-team/self-improving-agent/skills/promote

In Ihrer bevorzugten KI fragen

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

Dokumentation

/si:promote — Erkenntnisse in Regeln überführen

Wandelt ein bewährtes Muster aus Claudes automatischem Speicher in das Regelwerk des Projekts um, wo es zu einer durchsetzbaren Anweisung wird und nicht nur eine Hintergrundnotiz bleibt.

Verwendung

/si:promote <Musterbeschreibung>                    # Bestes Ziel automatisch erkennen
/si:promote <Muster> --target claude.md             # In CLAUDE.md überführen
/si:promote <Muster> --target rules/testing.md      # In bereichsspezifische Regel überführen
/si:promote <Muster> --target rules/api.md --paths "src/api/**/*.ts"  # Bereichsspezifisch mit Pfaden

Arbeitsablauf

Schritt 1: Das Muster verstehen

Analysiere die Beschreibung des Benutzers. Bei Unklarheit eine gezielte Rückfrage stellen:

  • "Welches spezifische Verhalten soll Claude befolgen?"
  • "Gilt dies für alle Dateien oder nur für bestimmte Pfade?"

Schritt 2: Das Muster im automatischen Speicher finden

# Durchsuche MEMORY.md nach relevanten Einträgen
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"
grep -ni "<Schlüsselwörter>" "$MEMORY_DIR/MEMORY.md"

Zeige die passenden Einträge an und bestätige, dass sie gemeint sind.

Schritt 3: Das richtige Ziel bestimmen

MusterumfangZielBeispiel
Gilt für das gesamte Projekt./CLAUDE.md„pnpm verwenden, nicht npm“
Gilt für bestimmte Dateitypen.claude/rules/<thema>.md„API-Handler benötigen Validierung“
Gilt für alle Ihre Projekte~/.claude/CLAUDE.md„Explizite Fehlerbehandlung bevorzugen“

Wenn der Benutzer kein Ziel angegeben hat, empfehle eines basierend auf dem Umfang.

Schritt 4: In eine prägnante Regel destillieren

Wandle die Erkenntnis aus dem Notizformat des automatischen Speichers in das Anweisungsformat von CLAUDE.md um:

Vorher (MEMORY.md — beschreibend):

Das Projekt verwendet pnpm-Workspaces. Als ich npm install versuchte, schlug es fehl. Die Sperrdatei ist pnpm-lock.yaml. Es muss pnpm install für Abhängigkeiten verwendet werden.

Nachher (CLAUDE.md — vorschreibend):

## Build & Abhängigkeiten
- Paketmanager: pnpm (nicht npm). Verwende `pnpm install`.

Regeln für die Destillation:

  • Eine Regel pro Zeile, wenn möglich
  • Imperativ („Verwende X“, „Immer Y“, „Nie Z“)
  • Den Befehl oder das Beispiel angeben, nicht nur das Konzept
  • Keine Hintergrundgeschichte — nur die Anweisung

Schritt 5: Ins Ziel schreiben

Für CLAUDE.md:

  1. Vorhandene CLAUDE.md lesen
  2. Den passenden Abschnitt finden (oder erstellen)
  3. Die neue Regel unter der richtigen Überschrift anhängen
  4. Wenn die Datei 200 Zeilen überschreiten würde, stattdessen .claude/rules/ vorschlagen

Für .claude/rules/:

  1. Die Datei erstellen, falls sie nicht existiert
  2. YAML-Frontmatter mit paths hinzufügen, wenn bereichsspezifisch
  3. Den Regeltext schreiben
---
paths:
  - "src/api/**/*.ts"
  - "tests/api/**/*"
---

# API-Entwicklungsregeln

- Alle Endpunkte müssen Eingaben mit Zod-Schemas validieren
- Für Fehlerantworten die Klasse `ApiError` verwenden (nicht raw Error)
- OpenAPI-JSDoc-Kommentare an Handler-Funktionen einfügen

Schritt 6: Automatischen Speicher bereinigen

Nach der Überführung den ursprünglichen Eintrag in MEMORY.md entfernen oder markieren:

# Anzeigen, was entfernt wird
grep -n "<Muster>" "$MEMORY_DIR/MEMORY.md"

Den Benutzer um Bestätigung bitten. Dann MEMORY.md bearbeiten, um den überführten Eintrag zu entfernen. Dies schafft Platz für neue Erkenntnisse.

Schritt 7: Bestätigen

✅ Überführt nach {{Ziel}}

Regel: „{{destillierte Regel}}“
Quelle: MEMORY.md Zeile {{n}} (entfernt)
MEMORY.md: {{Zeilen}}/200 Zeilen verbleibend

Das Muster ist jetzt eine durchsetzbare Anweisung. Claude wird es in allen zukünftigen Sitzungen befolgen.

Entscheidungsleitfaden zur Überführung

Überführen, wenn:

  • Das Muster 3+ Mal im automatischen Speicher aufgetaucht ist
  • Sie Claude mehr als einmal dazu korrigiert haben
  • Es sich um eine Projektkonvention handelt, die jeder Mitwirkende kennen sollte
  • Es einen wiederkehrenden Fehler verhindert

Nicht überführen, wenn:

  • Es sich um eine einmalige Debugging-Notiz handelt (im automatischen Speicher belassen)
  • Es sich um sitzungsspezifischen Kontext handelt (Sitzungsspeicher übernimmt dies)
  • Es sich bald ändern könnte (z. B. während einer Migration)
  • Es bereits durch bestehende Regeln abgedeckt ist

CLAUDE.md vs. .claude/rules/

CLAUDE.md verwenden für.claude/rules/ verwenden für
Globale ProjektregelnDateityp-spezifische Muster
Build-BefehleTestkonventionen
ArchitekturentscheidungenAPI-Entwurfsregeln
TeamkonventionenFramework-spezifische Fallstricke

Tipps

  • CLAUDE.md unter 200 Zeilen halten — für Überlauf rules/ verwenden
  • Eine Regel pro Zeile ist einfacher zu warten als Absätze
  • Den konkreten Befehl angeben, nicht nur das Konzept
  • Überführte Regeln vierteljährlich überprüfen — entfernen, was nicht mehr relevant ist

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Verwandte Skills