Communitygithub.com

ASoudy/AGS

Promove um padrão comprovado da memória automática (MEMORY.md) para CLAUDE.md ou .claude/rules/ para aplicação permanente.

O que é AGS?

Esta skill permite que um agente de IA (como Claude Code) promova padrões e aprendizados comprovados da sua memória automática (MEMORY.md) para o sistema de regras permanente do projeto, como CLAUDE.md ou regras escopadas em `.claude/rules/`. É útil porque transforma observações soltas em instruções executáveis que o agente seguirá em todas as sessões futuras, eliminando a necessidade de relembrar ou corrigir comportamentos repetidamente. A skill suporta plataformas como Claude Code e IDEs como Cursor ou Codex que respeitam arquivos CLAUDE.md e regras escopadas. O fluxo de trabalho envolve: (1) entender o padrão descrito pelo usuário, (2) localizar a entrada correspondente no MEMORY.md, (3) determinar o alvo apropriado (CLAUDE.md, regra escopada ou regra global), (4) destilar o aprendizado em uma instrução concisa e imperativa, (5) escrever no alvo escolhido, (6) limpar a entrada original do MEMORY.md para liberar espaço, e (7) confirmar a promoção com um resumo do que foi feito. A skill também fornece um guia de decisão para saber quando promover (padrão repetido 3+ vezes, correção recorrente, convenção do projeto) e quando não promover (nota de debug única, contexto de sessão, regras existentes).

Funciona com✓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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

/si:promote — Promover Aprendizados para Regras

Move um padrão comprovado da memória automática do Claude para o sistema de regras do projeto, onde se torna uma instrução aplicada, em vez de uma nota de contexto.

Uso

/si:promote <descrição do padrão>                    # Detecta automaticamente o melhor alvo
/si:promote <padrão> --target claude.md               # Promove para CLAUDE.md
/si:promote <padrão> --target rules/testing.md        # Promove para regra escopada
/si:promote <padrão> --target rules/api.md --paths "src/api/**/*.ts"  # Escopado com caminhos

Fluxo de Trabalho

Passo 1: Entender o padrão

Analise a descrição do usuário. Se vaga, faça uma pergunta esclarecedora:

  • "Qual comportamento específico o Claude deve seguir?"
  • "Isso se aplica a todos os arquivos ou a caminhos específicos?"

Passo 2: Encontrar o padrão na memória automática

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

Mostre as entradas correspondentes e confirme se são o que o usuário quer.

Passo 3: Determinar o alvo correto

Escopo do padrãoAlvoExemplo
Aplica-se a todo o projeto./CLAUDE.md"Use pnpm, não npm"
Aplica-se a tipos de arquivo específicos.claude/rules/<tópico>.md"Handlers de API precisam de validação"
Aplica-se a todos os seus projetos~/.claude/CLAUDE.md"Prefira tratamento explícito de erros"

Se o usuário não especificou um alvo, recomende um com base no escopo.

Passo 4: Destilar em uma regra concisa

Transforme o aprendizado do formato de nota do MEMORY.md para o formato de instrução do CLAUDE.md:

Antes (MEMORY.md — descritivo):

O projeto usa pnpm workspaces. Quando tentei npm install, falhou. O arquivo de lock é pnpm-lock.yaml. Deve-se usar pnpm install para dependências.

Depois (CLAUDE.md — prescritivo):

## Build e Dependências
- Gerenciador de pacotes: pnpm (não npm). Use `pnpm install`.

Regras para destilação:

  • Uma regra por linha quando possível
  • Voz imperativa ("Use X", "Sempre Y", "Nunca Z")
  • Inclua o comando ou exemplo, não apenas o conceito
  • Sem contexto prévio — apenas a instrução

Passo 5: Escrever no alvo

Para CLAUDE.md:

  1. Leia o CLAUDE.md existente
  2. Encontre a seção apropriada (ou crie uma)
  3. Adicione a nova regra sob o cabeçalho correto
  4. Se o arquivo exceder 200 linhas, sugira usar .claude/rules/ em vez disso

Para .claude/rules/:

  1. Crie o arquivo se ele não existir
  2. Adicione frontmatter YAML com paths se for escopado
  3. Escreva o conteúdo da regra
---
paths:
  - "src/api/**/*.ts"
  - "tests/api/**/*"
---

# Regras de Desenvolvimento da API

- Todos os endpoints devem validar a entrada com schemas Zod
- Use a classe `ApiError` para respostas de erro (não Error puro)
- Inclua comentários JSDoc OpenAPI nas funções handler

Passo 6: Limpar a memória automática

Após a promoção, remova ou marque a entrada original no MEMORY.md:

# Mostra o que será removido
grep -n "<padrão>" "$MEMORY_DIR/MEMORY.md"

Peça ao usuário para confirmar a remoção. Em seguida, edite o MEMORY.md para remover a entrada promovida. Isso libera espaço para novos aprendizados.

Passo 7: Confirmar

✅ Promovido para {{alvo}}

Regra: "{{regra destilada}}"
Fonte: MEMORY.md linha {{n}} (removida)
MEMORY.md: {{linhas}}/200 linhas restantes

O padrão agora é uma instrução aplicada. Claude o seguirá em todas as sessões futuras.

Guia de Decisão de Promoção

Promova quando:

  • O padrão apareceu 3+ vezes na memória automática
  • Você corrigiu o Claude sobre isso mais de uma vez
  • É uma convenção do projeto que qualquer contribuidor deveria saber
  • Previne um erro recorrente

Não promova quando:

  • É uma nota de debug única (deixe na memória automática)
  • É um contexto específico de sessão (a memória de sessão cuida disso)
  • Pode mudar em breve (ex.: durante uma migração)
  • Já está coberto por regras existentes

CLAUDE.md vs .claude/rules/

Use CLAUDE.md paraUse .claude/rules/ para
Regras globais do projetoPadrões específicos de tipo de arquivo
Comandos de buildConvenções de teste
Decisões de arquiteturaRegras de design de API
Convenções de equipePeculiaridades específicas de framework

Dicas

  • Mantenha o CLAUDE.md abaixo de 200 linhas — use rules/ para o excedente
  • Uma regra por linha é mais fácil de manter do que parágrafos
  • Inclua o comando concreto, não apenas o conceito
  • Revise as regras promovidas trimestralmente — remova o que não for mais 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.

Habilidades Relacionadas