Communitygithub.com

ASoudy/AGS

Faites passer un modèle éprouvé de la mémoire automatique (MEMORY.md) à CLAUDE.md ou .claude/rules/ pour une application permanente.

Qu'est-ce que AGS ?

Cette compétence permet de promouvoir un modèle de comportement ou de convention, identifié comme fiable dans la mémoire automatique de Claude (MEMORY.md), vers le système de règles permanent du projet. Elle est utile pour transformer des observations ponctuelles en instructions contraignantes que Claude suivra dans toutes les sessions futures, évitant ainsi de répéter les mêmes corrections. La compétence prend en charge les cibles CLAUDE.md (pour les règles globales du projet) et .claude/rules/ (pour les règles spécifiques à des types de fichiers ou à des chemins). Le processus comprend la recherche du modèle dans MEMORY.md, la distillation en une règle concise et prescriptive, l'écriture dans le fichier cible approprié, et le nettoyage de la mémoire automatique. Un guide de décision est fourni pour déterminer quand promouvoir un modèle (après 3+ occurrences, correction répétée, convention essentielle) et quand s'abstenir (note de débogage unique, contexte de session, sujet susceptible de changer).

Compatible avec✓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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/si:promote — Transformer les apprentissages en règles

Déplace un modèle éprouvé de la mémoire automatique de Claude vers le système de règles du projet, où il devient une instruction contraignante plutôt qu'une simple note de fond.

Utilisation

/si:promote <description du modèle>                    # Détection automatique de la meilleure cible
/si:promote <modèle> --target claude.md                 # Promouvoir vers CLAUDE.md
/si:promote <modèle> --target rules/testing.md          # Promouvoir vers une règle ciblée
/si:promote <modèle> --target rules/api.md --paths "src/api/**/*.ts"  # Ciblée avec chemins

Workflow

Étape 1 : Comprendre le modèle

Analysez la description de l'utilisateur. Si elle est vague, posez une question de clarification :

  • "Quel comportement spécifique Claude doit-il suivre ?"
  • "Cela s'applique-t-il à tous les fichiers ou à des chemins spécifiques ?"

Étape 2 : Trouver le modèle dans la mémoire automatique

# Rechercher des entrées liées dans MEMORY.md
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"
grep -ni "<mots-clés>" "$MEMORY_DIR/MEMORY.md"

Affichez les entrées correspondantes et confirmez qu'elles correspondent à ce que l'utilisateur veut dire.

Étape 3 : Déterminer la bonne cible

Portée du modèleCibleExemple
S'applique à l'ensemble du projet./CLAUDE.md"Utiliser pnpm, pas npm"
S'applique à des types de fichiers spécifiques.claude/rules/<sujet>.md"Les gestionnaires API ont besoin de validation"
S'applique à tous vos projets~/.claude/CLAUDE.md"Privilégier la gestion explicite des erreurs"

Si l'utilisateur n'a pas précisé de cible, recommandez-en une en fonction de la portée.

Étape 4 : Distiller en une règle concise

Transformez l'apprentissage du format de note de la mémoire automatique vers le format d'instruction de CLAUDE.md :

Avant (MEMORY.md — descriptif) :

Le projet utilise les workspaces pnpm. Quand j'ai essayé d'installer avec npm, cela a échoué. Le fichier de verrouillage est pnpm-lock.yaml. Il faut utiliser pnpm install pour les dépendances.

Après (CLAUDE.md — prescriptif) :

## Build et dépendances
- Gestionnaire de paquets : pnpm (pas npm). Utiliser `pnpm install`.

Règles pour la distillation :

  • Une règle par ligne si possible
  • Voix impérative ("Utiliser X", "Toujours Y", "Jamais Z")
  • Inclure la commande ou l'exemple, pas seulement le concept
  • Pas d'historique — seulement l'instruction

Étape 5 : Écrire dans la cible

Pour CLAUDE.md :

  1. Lire le fichier CLAUDE.md existant
  2. Trouver la section appropriée (ou en créer une)
  3. Ajouter la nouvelle règle sous le bon titre
  4. Si le fichier dépasse 200 lignes, suggérer d'utiliser .claude/rules/ à la place

Pour .claude/rules/ :

  1. Créer le fichier s'il n'existe pas
  2. Ajouter le frontmatter YAML avec les paths si la règle est ciblée
  3. Écrire le contenu de la règle
---
paths:
  - "src/api/**/*.ts"
  - "tests/api/**/*"
---

# Règles de développement API

- Tous les endpoints doivent valider les entrées avec les schémas Zod
- Utiliser la classe `ApiError` pour les réponses d'erreur (pas l'objet Error brut)
- Inclure des commentaires JSDoc OpenAPI sur les fonctions de gestionnaire

Étape 6 : Nettoyer la mémoire automatique

Après la promotion, supprimez ou marquez l'entrée originale dans MEMORY.md :

# Afficher ce qui sera supprimé
grep -n "<modèle>" "$MEMORY_DIR/MEMORY.md"

Demandez à l'utilisateur de confirmer la suppression. Modifiez ensuite MEMORY.md pour supprimer l'entrée promue. Cela libère de l'espace pour de nouveaux apprentissages.

Étape 7 : Confirmer

✅ Promu vers {{cible}}

Règle : "{{règle distillée}}"
Source : MEMORY.md ligne {{n}} (supprimée)
MEMORY.md : {{lignes}}/200 lignes restantes

Ce modèle est désormais une instruction contraignante. Claude le suivra dans toutes les sessions futures.

Guide de décision pour la promotion

Promouvoir quand :

  • Le modèle est apparu 3 fois ou plus dans la mémoire automatique
  • Vous avez corrigé Claude à ce sujet plus d'une fois
  • Il s'agit d'une convention de projet que tout contributeur devrait connaître
  • Cela évite une erreur récurrente

Ne pas promouvoir quand :

  • Il s'agit d'une note de débogage ponctuelle (laisser dans la mémoire automatique)
  • C'est un contexte spécifique à une session (la mémoire de session gère cela)
  • Cela risque de changer bientôt (par exemple lors d'une migration)
  • Cela est déjà couvert par des règles existantes

CLAUDE.md vs .claude/rules/

Utiliser CLAUDE.md pourUtiliser .claude/rules/ pour
Règles globales du projetModèles spécifiques à un type de fichier
Commandes de buildConventions de test
Décisions architecturalesRègles de conception d'API
Conventions d'équipePièges spécifiques à un framework

Conseils

  • Garder CLAUDE.md sous 200 lignes — utiliser rules/ pour le surplus
  • Une règle par ligne est plus facile à maintenir que des paragraphes
  • Inclure la commande concrète, pas seulement le concept
  • Réviser les règles promues trimestriellement — supprimer ce qui n'est plus pertinent

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.

Skills associés