Communitygithub.com

ASoudy/AGS

Convierte un patrón comprobado de la memoria automática (MEMORY.md) en CLAUDE.md o .claude/rules/ para su cumplimiento permanente.

¿Qué es AGS?

Esta habilidad automatiza la promoción de patrones aprendidos por un agente de IA (como Claude Code) desde su memoria automática (MEMORY.md) hacia el sistema de reglas del proyecto, ya sea en el archivo `CLAUDE.md` o en reglas con ámbito en `.claude/rules/`. Al hacerlo, un patrón que antes era solo una nota de fondo se convierte en una instrucción vinculante que el agente debe seguir en sesiones futuras. Es útil para desarrolladores que trabajan con Claude Code y desean codificar convenciones de proyecto, correcciones recurrentes o decisiones arquitectónicas de forma permanente, evitando la necesidad de recordárselas constantemente al agente. El flujo de trabajo incluye la búsqueda del patrón en MEMORY.md, la determinación del destino óptimo según el ámbito (todo el proyecto, tipos de archivo específicos o todos los proyectos), la destilación del aprendizaje en una regla concisa y prescriptiva, la escritura en el destino correspondiente y la limpieza de la entrada original en MEMORY.md para liberar espacio para nuevos aprendizajes. La habilidad también proporciona una guía de decisión para saber cuándo promocionar un patrón y cuándo no, así como consejos para mantener el archivo de reglas organizado y por debajo de las 200 líneas.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

/si:promote — Graduar Aprendizajes a Reglas

Mueve un patrón comprobado de la memoria automática de Claude al sistema de reglas del proyecto, donde se convierte en una instrucción vinculante en lugar de una nota de fondo.

Uso

/si:promote <descripción del patrón>                    # Detectar automáticamente el mejor destino
/si:promote <patrón> --target claude.md              # Promocionar a CLAUDE.md
/si:promote <patrón> --target rules/testing.md       # Promocionar a regla con ámbito
/si:promote <patrón> --target rules/api.md --paths "src/api/**/*.ts"  # Con ámbito y rutas

Flujo de Trabajo

Paso 1: Entender el patrón

Analiza la descripción del usuario. Si es vaga, haz una pregunta aclaratoria:

  • "¿Qué comportamiento específico debería seguir Claude?"
  • "¿Esto aplica a todos los archivos o solo a rutas específicas?"

Paso 2: Encontrar el patrón en la memoria automática

# Buscar entradas relacionadas en MEMORY.md
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"
grep -ni "<palabras_clave>" "$MEMORY_DIR/MEMORY.md"

Muestra las coincidencias y confirma que son las que el usuario quiere.

Paso 3: Determinar el destino correcto

Ámbito del patrónDestinoEjemplo
Aplica a todo el proyecto./CLAUDE.md"Usar pnpm, no npm"
Aplica a tipos de archivo específicos.claude/rules/<tema>.md"Los handlers de API necesitan validación"
Aplica a todos tus proyectos~/.claude/CLAUDE.md"Prefiere el manejo explícito de errores"

Si el usuario no especificó un destino, recomienda uno según el ámbito.

Paso 4: Destilar en una regla concisa

Transforma el aprendizaje del formato de nota de MEMORY.md al formato de instrucción de CLAUDE.md:

Antes (MEMORY.md — descriptivo):

El proyecto usa pnpm workspaces. Cuando intenté npm install falló. El archivo de bloqueo es pnpm-lock.yaml. Debo usar pnpm install para las dependencias.

Después (CLAUDE.md — prescriptivo):

## Compilación y Dependencias
- Gestor de paquetes: pnpm (no npm). Usar `pnpm install`.

Reglas para la destilación:

  • Una línea por regla cuando sea posible
  • Voz imperativa ("Usa X", "Siempre Y", "Nunca Z")
  • Incluye el comando o ejemplo, no solo el concepto
  • Sin historia de fondo — solo la instrucción

Paso 5: Escribir en el destino

Para CLAUDE.md:

  1. Lee el CLAUDE.md existente
  2. Encuentra la sección adecuada (o crea una)
  3. Añade la nueva regla bajo el encabezado correcto
  4. Si el archivo superaría las 200 líneas, sugiere usar .claude/rules/ en su lugar

Para .claude/rules/:

  1. Crea el archivo si no existe
  2. Añade metadatos YAML con paths si tiene ámbito
  3. Escribe el contenido de la regla
---
paths:
  - "src/api/**/*.ts"
  - "tests/api/**/*"
---

# Reglas de Desarrollo de API

- Todos los endpoints deben validar la entrada con esquemas Zod
- Usar la clase `ApiError` para las respuestas de error (no Error directamente)
- Incluir comentarios JSDoc con OpenAPI en las funciones handler

Paso 6: Limpiar la memoria automática

Después de promocionar, elimina o marca la entrada original en MEMORY.md:

# Mostrar lo que se eliminará
grep -n "<patrón>" "$MEMORY_DIR/MEMORY.md"

Pide al usuario que confirme la eliminación. Luego edita MEMORY.md para eliminar la entrada promocionada. Esto libera espacio para nuevos aprendizajes.

Paso 7: Confirmar

✅ Promocionado a {{destino}}

Regla: "{{regla destilada}}"
Fuente: MEMORY.md línea {{n}} (eliminada)
MEMORY.md: {{líneas}}/200 líneas restantes

El patrón ahora es una instrucción vinculante. Claude lo seguirá en todas las sesiones futuras.

Guía de Decisión de Promoción

Promocionar cuando:

  • El patrón apareció 3+ veces en la memoria automática
  • Corregiste a Claude al respecto más de una vez
  • Es una convención del proyecto que cualquier colaborador debería conocer
  • Previene un error recurrente

No promocionar cuando:

  • Es una nota de depuración de una sola vez (déjala en la memoria automática)
  • Es contexto específico de una sesión (la memoria de sesión lo maneja)
  • Podría cambiar pronto (por ejemplo, durante una migración)
  • Ya está cubierto por reglas existentes

CLAUDE.md vs .claude/rules/

Usa CLAUDE.md paraUsa .claude/rules/ para
Reglas globales del proyectoPatrones específicos de tipos de archivo
Comandos de compilaciónConvenciones de pruebas
Decisiones arquitectónicasReglas de diseño de API
Convenciones del equipoParticularidades de frameworks

Consejos

  • Mantén CLAUDE.md por debajo de 200 líneas — usa rules/ para desbordar
  • Una regla por línea es más fácil de mantener que párrafos
  • Incluye el comando concreto, no solo el concepto
  • Revisa las reglas promocionadas trimestralmente — elimina lo que ya no sea relevante

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 relacionados