Communitygithub.com

YepAPI/skills

Comentários encadeados, @menções, reações, fila de moderação, UI otimista e paginação por cursor.

O que é skills?

Esta skill implementa um sistema completo de comentários e discussões para aplicações web, suportando comentários encadeados, reações com emoji, @menções, fila de moderação e exclusão suave. Ela utiliza uma UI otimista (optimistic UI) para adicionar comentários instantaneamente, confirmando com o servidor e revertendo em caso de erro, garantindo uma experiência fluida. A paginação por cursor evita carregar todos os comentários de uma vez, ideal para discussões ativas. A skill fornece padrões de código (React Query + Drizzle ORM) e regras de design para evitar problemas como profundidade de encadeamento ilimitada ou remoção de comentários com respostas.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/comments-discussions

Perguntar na sua IA favorita

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

Documentação

Comentários e Discussões

Regras

  • Comentários encadeados: chave estrangeira parent_id na tabela de comentários — null para nível superior, referencia o pai para respostas
  • UI otimista: adicionar comentário à UI imediatamente, confirmar com resposta do servidor, reverter em caso de erro
  • @menções: analisar @username no corpo do comentário — acionar dropdown de pesquisa de usuário ao digitar @, notificar usuários mencionados
  • Reações: tabela separada reactions (commentId, userId, emoji) — restrição única em (commentId, userId, emoji)
  • Moderação: campo status (published, flagged, removed) — fila de moderação para conteúdo sinalizado, sinalização automática com lista de palavras
  • Exclusão suave: definir timestamp deletedAt — mostrar placeholder "excluído" para comentários com respostas, ocultar completamente comentários excluídos sem respostas
  • Paginação por cursor: cursor (commentId) + limit — ordenado por createdAt, carregar comentários mais antigos ao rolar
  • Histórico de edição: armazenar edições em tabela separada ou array JSON — mostrar indicador "editado" com timestamp da última edição

Padrões

// Modelo de dados do comentário
// comments: id, postId, authorId, parentId (nullable), body, status, deletedAt, createdAt, updatedAt
// reactions: id, commentId, userId, emoji, createdAt (unique: [commentId, userId, emoji])
// mentions: id, commentId, mentionedUserId, createdAt

// Consulta encadeada — buscar nível superior + respostas aninhadas
const comments = await db.query.comments.findMany({
  where: and(eq(comments.postId, postId), isNull(comments.parentId)),
  with: {
    author: { columns: { id: true, name: true, avatar: true } },
    replies: {
      with: { author: { columns: { id: true, name: true, avatar: true } } },
      orderBy: [asc(comments.createdAt)],
    },
    reactions: true,
  },
  orderBy: [desc(comments.createdAt)],
  limit: 20,
});

// Adição otimista de comentário (React Query)
const addComment = useMutation({
  mutationFn: (body: string) => api.post(`/posts/${postId}/comments`, { body }),
  onMutate: async (body) => {
    await queryClient.cancelQueries({ queryKey: ["comments", postId] });
    const previous = queryClient.getQueryData(["comments", postId]);
    queryClient.setQueryData(["comments", postId], (old: Comment[]) => [
      { id: `temp-${Date.now()}`, body, author: currentUser, createdAt: new Date() },
      ...old,
    ]);
    return { previous };
  },
  onError: (_err, _body, context) => {
    queryClient.setQueryData(["comments", postId], context?.previous);
  },
  onSettled: () => queryClient.invalidateQueries({ queryKey: ["comments", postId] }),
});

Evitar

  • Profundidade de encadeamento ilimitada — limitar a 2-3 níveis, depois achatar respostas mais profundas
  • Carregar todos os comentários de uma vez — usar paginação por cursor, especialmente para discussões ativas
  • Análise de menções apenas no cliente — validar e extrair menções no servidor para notificações
  • Exclusão definitiva de comentários com respostas — isso órfão o tópico; use exclusão suave e mostre placeholder
  • Reações sem restrições únicas — permite reações duplicadas do mesmo usuário

Individual skills in this repo

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

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Habilidades Relacionadas