Communitygithub.com

Administração e Desenvolvimento de Suíte Admin

Estenda e modifique o painel de administração, portal do desenvolvedor e console de operações. Use ao adicionar novas abas de admin, métricas, recursos de monitoramento ou ferramentas internas. Ativa para desenvolvimento de dashboard, análise de dados, gerenciamento de usuários e ferramentas internas.

O que é Administração e Desenvolvimento de Suíte Admin?

Esta skill capacita agentes de IA a projetar, estender e manter abas administrativas, métricas, ferramentas de monitoramento e portais internos (admin dashboard, developer portal, operations console) seguindo padrões estabelecidos. Ela fornece árvores de decisão claras para escolher entre modificar abas existentes, criar novas abas, adicionar novos endpoints ou construir ferramentas dedicadas, com base na complexidade dos dados (cliente vs servidor) e na necessidade de atualizações em tempo real. A skill cobre modos de falha críticos, como lentidão de consultas ao banco de dados, cache desatualizado, falta de logging de auditoria, exposição de dados sensíveis (PHI) e escalonamento de privilégios, oferecendo soluções práticas com exemplos de código. Além disso, inclui um exemplo completo de implementação de uma aba de monitoramento de saúde da produção, destacando diferenças entre abordagens de novatos e especialistas, e impõe portões de qualidade obrigatórios (controle de acesso, rate limiting, auditoria, performance, conformidade HIPAA) para garantir código seguro e robusto. A skill também define limites claros, delegando funcionalidades para usuários externos, autenticação, mudanças de schema, e-mail, configuração de API e otimização a outras skills especializadas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/admin-dashboard

Perguntar na sua IA favorita

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

Documentação

Desenvolvimento da Suíte de Administração e Desenvolvedor

Esta skill ajuda você a estender o painel de administração e construir ferramentas internas seguindo os padrões estabelecidos.

PONTOS DE DECISÃO

Quando Adicionar Aba vs Modificar Endpoint vs Criar Nova Ferramenta

Adicionando Nova Funcionalidade de Admin:
├─ Usuário precisa de visualização de dados somente leitura?
│  ├─ Dados existem na API atual? → Modificar aba existente
│  ├─ Novo tipo de dado necessário? → Adicionar nova aba + novo endpoint
│  └─ Análises complexas necessárias? → Criar aba de análises dedicada
│
├─ Usuário precisa modificar dados do sistema?
│  ├─ Operações CRUD simples? → Adicionar aba de gerenciamento
│  ├─ Operações em lote necessárias? → Criar aba do console de operações
│  └─ Workflow de múltiplas etapas? → Construir componente de wizard
│
├─ Ferramentas internas para desenvolvedores?
│  ├─ Inspeção de código/documentação? → Adicionar ao portal de desenvolvimento
│  ├─ Monitoramento do sistema? → Adicionar ao console de operações
│  └─ Ferramentas de suporte ao usuário? → Adicionar ao painel de administração
│
└─ Funcionalidade para usuário externo?
   → PARE: Use a skill de desenvolvimento frontend

Estratégia de Implementação de Conteúdo da Aba

Avaliação de Complexidade da Aba:
├─ Exibição simples de estatísticas (< 5 métricas)?
│  → Usar padrão de grade StatCard
│
├─ Tabela de dados com filtragem?
│  ├─ < 1000 linhas? → Filtragem no lado do cliente
│  └─ > 1000 linhas? → Paginação e busca no lado do servidor
│
├─ Monitoramento em tempo real?
│  ├─ Atualizações a cada 30s+? → Usar SWR com intervalo de atualização
│  └─ Atualizações a cada 5s-? → Usar conexão WebSocket
│
└─ Controles interativos?
   ├─ Toggles/botões simples? → Ações inline
   └─ Formulários complexos? → Diálogos modais + fluxos de confirmação

MODOS DE FALHA

1. Espiral da Morte de Performance de Consulta ao Banco

Sintoma: Painel de administração expira ou carrega lentamente (>5 segundos) Detecção: Monitorar tempos de resposta de /api/admin/* >3s Correção: Adicionar índices ao banco, implementar paginação, armazenar em cache estatísticas agregadas

-- RUIM: Varredura completa da tabela
SELECT COUNT(*) FROM pageViews WHERE userId = ?

-- BOM: Usar intervalos de timestamp indexados
SELECT COUNT(*) FROM pageViews WHERE createdAt > NOW() - INTERVAL 24 HOUR

2. Cache Desatualizado Mostrando Dados Errados

Sintoma: Administrador vê métricas desatualizadas que não correspondem à atividade recente Detecção: Usuário relata que as estatísticas não mudam após ações conhecidas Correção: Implementar invalidação de cache em mutações de dados, adicionar carimbos de data/hora "Última Atualização"

// Adicionar quebra de cache às mutações
await updateUserData(userId);
await revalidateTag('admin-stats'); // Limpar cache

3. Falta de Logging de Auditoria

Sintoma: Ações do administrador não são registradas na tabela auditLog Detecção: Verificar entradas de auditLog para ações de admin nas últimas 24h Correção: Adicionar chamadas logAdminAction() a TODOS os endpoints de admin

// Necessário em todo endpoint de admin
await logAdminAction(admin.id, AuditAction.USER_DATA_VIEW, 'users', userId);

4. Exposição de Dados por Violação de HIPAA

Sintoma: PHI visível em mensagens de erro, logs ou visualizações agregadas Detecção: Erro contém email/telefone/dados médicos do usuário Correção: Sanitizar todas as respostas de erro, usar identificadores hash nas visualizações de admin

// RUIM: Expõe email do usuário
{ error: "Usuário [email protected] não encontrado" }

// BOM: Usa identificadores anônimos
{ error: "ID do usuário hash_123abc não encontrado" }

5. Escalonamento de Privilégio de Admin

Sintoma: Usuários comuns podem acessar endpoints de admin Detecção: Usuário não-admin recebe dados de admin em vez de 403 Correção: Adicionar verificação requireAdmin() como primeira linha de todo endpoint de admin

export async function GET(request: Request) {
  const admin = await requireAdmin(); // Deve ser a PRIMEIRA
  if (!admin) return Response.json({ error: 'Proibido' }, { status: 403 });
  // ... resto do manipulador
}

EXEMPLOS PRÁTICOS

Adicionando Aba de Monitoramento de Saúde da Produção

Cenário: Adicionar monitoramento de saúde da API em tempo real com métricas de latência, taxas de erro e status do serviço.

1. Navegação no Ponto de Decisão:

  • Usuário precisa de monitoramento em tempo real → Usar SWR com atualização a cada 30s
  • Dados do sistema, não dados do usuário → Adicionar ao painel de administração
  • Novo tipo de dados (métricas da API) → Criar nova aba + endpoint

2. Passos de Implementação:

Criar endpoint com padrões necessários:

// src/app/api/admin/health/route.ts
export async function GET(request: Request) {
  const admin = await requireAdmin(); // Segurança primeiro
  if (!admin) return Response.json({ error: 'Proibido' }, { status: 403 });
  
  const rateLimitResult = await rateLimiter.check(admin.id); // Rate limiting
  if (!rateLimitResult.allowed) return Response.json({}, { status: 429 });
  
  await logAdminAction(admin.id, 'HEALTH_VIEW', 'metrics', null); // Auditoria
  
  const metrics = await getHealthMetrics(); // Busca de dados
  return Response.json(metrics);
}

Criar componente da aba:

function ProductionHealthTab() {
  const { data: health, error } = useSWR('/api/admin/health', fetcher, {
    refreshInterval: 30000 // Atualizações em tempo real
  });
  
  return (
    <div className="space-y-6">
      <div className="grid grid-cols-4 gap-4">
        <StatCard label="Tempo de Atividade da API" value="99.9%" status="good" />
        <StatCard label="Latência Média" value="45ms" trend="down" />
        <StatCard label="Taxa de Erro" value="0.1%" status="warning" />
        <StatCard label="Serviços Ativos" value="12/12" status="good" />
      </div>
    </div>
  );
}

3. Diferenças entre Especialista e Novato:

  • Novato erra: Logging de auditoria, rate limiting, tratamento de erro seguro para HIPAA
  • Especialista acerta: Estratégia de invalidação de cache, configuração de monitoramento de performance, limites de erro adequados

PORTÕES DE QUALIDADE

  • Controle de acesso de admin: verificação requireAdmin() passa com usuário admin, falha com usuário comum
  • Rate limiting: Endpoint retorna 429 quando o limite de taxa é excedido (60 req/min padrão)
  • Logging de auditoria: Ação de admin registrada na tabela auditLog com tipo de ação correto
  • Baseline de performance: Aba carrega em <2 segundos com volume de dados realista
  • Conformidade HIPAA: Nenhum PHI exposto em mensagens de erro ou saída de debug
  • Validação de dados: Requisições inválidas retornam erros 400 adequados com mensagens seguras
  • Comportamento de cache: Dados atualizam em até 30 segundos após mudanças no backend
  • Limites de erro: UI lida graciosamente com falhas de API sem travar
  • Responsivo para mobile: Layout da aba funciona em telas de tablet (768px+)
  • Atualizações em tempo real: Auto-atualização funciona sem vazamentos de memória por mais de 10 minutos

FRONTEIRAS DE NÃO USO

NÃO use esta skill para:

  • Funcionalidades voltadas para usuário externo → Use frontend-development
  • Fluxos de autenticação/login → Use auth-security
  • Mudanças no esquema do banco de dados → Use database-operations
  • Sistemas de email/notificação → Use communications
  • Configuração de rate limiting de API → Use backend-api
  • Configuração de conformidade HIPAA → Use security-compliance
  • Otimização de performance → Use optimization

Delegue para outras skills quando:

  • Adicionando funcionalidades públicas para usuário → frontend-development
  • Modificando autenticação de usuário → auth-security
  • Criando novos endpoints de API para uso externo → backend-api
  • Configurando infraestrutura de monitoramento → devops-infrastructure

Individual skills in this repo

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

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Conversation patterns and interaction protocols for multi-agent systems. Covers request/response, pub/sub, blackboard, delegation chains, debate, critique, consensus, fan-out/fan-in, supervisor-worker, and peer negotiation. Deep analysis of AutoGen conversation patterns, CrewAI delegation, LangGraph state passing, and FIPA-ACL performatives. Teaches how to design what agents say to each other and in what order. Activate on: "agent conversation", "agent protocol", "multi-agent debate", "agent delegation", "supervisor worker pattern", "agent voting", "consensus protocol", "fan-out fan-in", "agent negotiation", "blackboard pattern", "agent dialogue", "conversation topology", "agent handoff". NOT for: wire format or serialization (use agent-interchange-formats), orchestration infrastructure (use agentic-infrastructure-2026), single agent behavior (use agentic-patterns).

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Build and adopt production AI agent infrastructure in 2026. Covers framework selection (LangGraph, CrewAI, AutoGen, MCP), orchestration patterns, evaluation, observability, memory systems, and tool use. Also covers the SOCIAL dimension: how to sell agent infrastructure internally, change management, measuring ROI, building trust in autonomous systems, and scaling adoption across teams. Activate on: "agent infrastructure", "agent framework comparison", "which agent framework", "sell AI tools internally", "agent adoption", "agent observability", "agent evaluation", "MCP architecture", "agentic mesh", "enterprise AI agents", "AI change management", "agent ROI". NOT for: building specific agents (use ai-engineer), designing agent behavior patterns (use agentic-patterns), prompt tuning (use prompt-engineer).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

curiositech/windags-skills

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

Build production-ready LLM applications, advanced RAG systems, and intelligent agents. Implements vector search, multimodal AI, agent orchestration, and enterprise AI integrations. Use PROACTIVELY for LLM features, chatbots, AI agents, or AI-powered applications.

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

Habilidades Relacionadas