Communitygithub.com

curiositech/windags-skills

Descoberta automatizada e correspondência de habilidades de agente para roteamento dinâmico de tarefas e avaliação de capacidades.

O que é windags-skills?

Esta skill implementa um sistema autônomo de descoberta de habilidades que resolve o problema de ovo e galinha em sistemas de aprendizado de agente, onde é necessário aprender o que constitui sucesso enquanto se aprende como alcançá-lo. Ela é projetada para arquiteturas de agentes que precisam descobrir habilidades de forma autônoma, como aqueles baseados em LLMs (Claude, Codex, Cursor) e sistemas de aprendizado por reforço (RL) visual. A skill suporta várias abordagens arquiteturais: arquitetura de modelo único para tarefas com critérios de sucesso predefinidos e arquitetura de processo duplo (Sistema 1/Sistema 2) para descoberta aberta de habilidades. O Sistema 1 usa LLMs para avaliação rápida e loops de treinamento, enquanto o Sistema 2 usa VLMs para validação independente de alta precisão para admissão na biblioteca de habilidades. A skill também inclui decomposição top-down de tarefas para comportamentos complexos, encadeamento bottom-up de habilidades a partir de primitivas, e destilação de conhecimento ambiental via RAG. Ela identifica falhas comuns, como avaliação carimbo de borracha (dependência circular), paralisia por explosão de primitivas (falta de habilidades intermediárias), desperdício de RAG sem contexto (sem destilação), contaminação em cascata da biblioteca (erros compostos) e sobrescrita manual de granularidade. Por meio de exemplos práticos (abertura de gaveta robótica, preparo de café e destilação de conhecimento ambiental), demonstra como evitar essas falhas e garantir uma descoberta de habilidades robusta e precisa.

Funciona com~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/agentic-skill-discovery

Perguntar na sua IA favorita

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

Documentação

Descoberta Autônoma de Habilidades para Agentes

Versão: 1.0
Domínio: Sistemas de Aprendizagem Autônoma, Arquitetura de IA, Aprendizado por Reforço

Conceito Central

A descoberta autônoma de habilidades resolve o problema do ovo e da galinha: aprender o que constitui sucesso enquanto se aprende como alcançá-lo. O sistema deve ser tanto aluno quanto professor, criando dependências circulares que exigem separação arquitetural entre proposta e validação.

Pontos de Decisão

Árvore de Decisão para Seleção de Arquitetura

Se a tarefa tem critérios de sucesso objetivos (ex.: navegação, manipulação com metas claras) → Usar Arquitetura de Modelo Único com avaliação rápida por LLM → Custo: Baixo | Precisão: ~75% | Caso de uso: Tarefas predeterminadas

Se a tarefa requer descoberta aberta de habilidades (ex.: tarefas criativas, exploração) → Usar Arquitetura de Processo Duplo (Sistema 1/Sistema 2) → Sistema 1: Avaliação rápida por LLM para loops de treinamento → Sistema 2: Validação independente por VLM para admissão na biblioteca → Custo: Alto | Precisão: ~76% | Caso de uso: Aprendizagem autônoma

Se for desejado comportamento complexo de várias etapas → Decomposição Top-Down de Missões → Começar com tarefa complexa falha → decompor em subtarefas → aprender pré-requisitos faltantes → Taxa de sucesso: 43,75% vs 12,50% para encadeamento bottom-up

Se estiver construindo biblioteca de habilidades a partir de primitivas → Encadeamento Bottom-Up de Habilidades apenas se as primitivas estiverem bem alinhadas com os objetivos finais → Risco: Explosão combinatória e falta de "habilidades intermediárias" → Fallback: Mudar para top-down quando a composição falhar

Se o desempenho estagnar com a abordagem atual → Verificar dependências circulares (mesmo modelo propondo e avaliando) → Se detectado: Implementar separação arquitetural → Se não detectado: Adicionar RAG com padrões de habilidades bem-sucedidas para destilação de conhecimento ambiental

Tabela de Decisão de Estratégia de Validação

CenárioAvaliação Rápida (Sistema 1)Avaliação Lenta (Sistema 2)Regra de Admissão na Biblioteca
Loops de treinamentoFunções de sucesso geradas por LLMNenhumaNão aplicável
Validação de habilidadeAvaliação por LLMVerificação por VLMExigir que ambos passem
Risco de contaminação da bibliotecaAlta tolerânciaTolerância zeroSubstituição pelo Sistema 2 necessária
Restrições de custoOtimizar para velocidadeOtimizar para precisãoAceitação assimétrica de custos

Modos de Falha

1. Avaliação Carimbo de Borracha

Sintomas: Altas taxas de sucesso relatadas, mas baixa conclusão de tarefas; biblioteca crescendo rapidamente Regra de Detecção: Se o mesmo modelo gera recompensas E avalia sucesso, existe dependência circular Causa Raiz: LLM atuando tanto como jogador quanto como árbitro cria viés de avaliação Correção: Implementar separação arquitetural com validador independente (ex.: VLM para tarefas visuais)

2. Paralisia por Explosão de Primitivas

Sintomas: Grande biblioteca de habilidades, mas incapacidade de resolver tarefas complexas; habilidades não compõem efetivamente Regra de Detecção: Se o número de habilidades cresce, mas a taxa de sucesso em tarefas complexas permanece estável, existe o problema de "habilidades intermediárias" Causa Raiz: Encadeamento bottom-up não consegue descobrir habilidades entre primitivas e objetivos complexos Correção: Mudar para decomposição top-down de missões a partir de comportamentos complexos desejados

3. Desperdício de RAG sem Contexto

Sintomas: Recuperação RAG ocorrendo, mas sem melhoria de desempenho; tratamento da recuperação como exemplos genéricos Regra de Detecção: Se o RAG não melhora o aprendizado de restrições (ex.: compreensão de física), é apenas um prompting caro Causa Raiz: Mecanismo de destilação de conhecimento ambiental ausente Correção: Estruturar a biblioteca de habilidades como um modelo progressivo de affordances ambientais, não apenas como uma coleção de exemplos

4. Contaminação em Cascata da Biblioteca

Sintomas: Desempenho degrada ao longo do tempo conforme a biblioteca cresce; falsos positivos se acumulam Regra de Detecção: Se a admissão na biblioteca usa a mesma avaliação que os loops de treinamento, a contaminação irá em cascata Causa Raiz: Habilidades ruins permitem composições ruins; erros na biblioteca se acumulam, diferentemente de ruído de treinamento Correção: Usar validação independente cara para admissão na biblioteca, avaliação barata apenas para treinamento

5. Sobrescrita Manual de Granularidade

Sintomas: Habilidades parecem desconectadas de fronteiras semânticas naturais; níveis de abstração forçados Regra de Detecção: Se especificar manualmente a granularidade da habilidade contradiz propostas do LLM, verificar alinhamento com o domínio Causa Raiz: LLMs codificam fronteiras semânticas de tarefas a partir de dados de treinamento Correção: Deixar o sistema propor habilidades livremente, observar a granularidade descoberta, ajustar apenas para necessidades específicas do domínio

Exemplos Práticos

Exemplo 1: Abertura de Gaveta Robótica com Validação de Processo Duplo

Cenário: O agente deve aprender a abrir vários tipos de gaveta sem critérios de sucesso predefinidos.

Processo do Sistema 1 (Rápido):

  1. LLM gera proposta de habilidade: "agarrar_macaneta_gaveta"
  2. LLM cria função de sucesso: macaneta_gaveta_agarrada = distância_garra < 0.02
  3. Treinamento RL usa essa função por 100 episódios
  4. LLM avalia: "Sucesso! A garra alcança consistentemente a maçaneta"
  5. Ponto de Decisão: Admitir na biblioteca? NÃO - requer Sistema 2

Processo do Sistema 2 (Lento):

  1. VLM analisa quadros de vídeo finais dos 10 melhores episódios
  2. Veredito do VLM: "A garra toca a maçaneta, mas não mantém a pegada - os dedos não fecham"
  3. Detecção: Falso positivo do Sistema 1 capturado
  4. Ação: Rejeitar admissão na biblioteca, refinar função de sucesso
  5. Iteração: Adicionar requisito de pressão de pegada à função de sucesso

Especialista vs Iniciante:

  • Iniciante erra: Confia na autoavaliação do LLM, admite habilidade mal aprendida
  • Especialista acerta: O mesmo modelo não pode avaliar o que propôs; precisa de validação independente

Resultado: Biblioteca mantém 76% de precisão vs 46% sem o Sistema 2

Exemplo 2: Decomposição Top-Down de Missões para Tarefa de Múltiplas Etapas

Cenário: "Preparar café" falha com encadeamento bottom-up de habilidades, apesar de ter primitivas como "agarrar_xicara", "derramar_liquido"

Análise de Falha Bottom-Up:

  • Habilidades disponíveis: agarrar_xicara, derramar_liquido, mover_bracos, detectar_objeto
  • Tentativas de composição: Todas as 16 possíveis cadeias de 2 habilidades testadas
  • Habilidades intermediárias faltantes: "alinhar_xicara_com_bico", "detectar_nivel_liquido", "coordenar_despejo_bimanual"
  • Ponto de Decisão: Bottom-up não consegue descobri-las - não são composições de primitivas

Decomposição Top-Down:

  1. Tarefa falha: "preparar_cafe"
  2. Decompor em: [aquecer_agua] → [moer_graos] → [alinhar_xicara] → [derramar_agua] → [adicionar_graos]
  3. Análise de lacunas: "alinhar_xicara" faltando na biblioteca
  4. Aprendizado sob demanda: Aprender "alinhar_xicara" com estado inicial = estado final de "moer_graos"
  5. Encadeamento: O estado de sucesso de cada subtarefa torna-se condição inicial da próxima tarefa

Análise de Trade-off:

  • Bottom-up: Taxa de sucesso de 12,50%, explora combinações de habilidades desnecessárias
  • Top-down: Taxa de sucesso de 43,75%, aprende apenas os pré-requisitos necessários
  • Custo: Top-down requer capacidade de decomposição de tarefas; bottom-up requer exploração exaustiva

Quando Top-Down Sai pela Culatra:

  • Se a decomposição da tarefa estiver errada, aprende habilidades para subtarefas incorretas
  • Se os estados iniciais não podem ser configurados de forma confiável, o encadeamento quebra
  • Mitigação: Validar decomposição antes do aprendizado da habilidade; implementar verificação de configuração de estado

Exemplo 3: Destilação de Conhecimento Ambiental via RAG

Cenário: O agente deve aprender habilidades de manipulação em novo ambiente sem restrições físicas explícitas

Sem RAG (taxa de sucesso de 25%):

  1. LLM gera recompensa: recompensa = distancia_ao_alvo
  2. Agente aprende a se aproximar, mas não leva em conta limites de colisão
  3. Falha: Nenhum conhecimento de que a garra deve estar a 5cm da superfície antes de agarrar

Com RAG (taxa de sucesso de 46%):

  1. Recuperar sucesso anterior: função de recompensa "alcancar_cubo_A"
  2. Padrão detectado: Todos os alcances bem-sucedidos incluem restrição altura_garra > 0.05
  3. LLM incorpora: recompensa = distancia_ao_alvo se altura_garra > 0.05 else -10
  4. Conhecimento destilado: Affordance ambiental aprendida implicitamente

Especialista vs Iniciante:

  • Iniciante erra: Trata RAG como fornecimento de exemplo, não reconhece aprendizado de restrições
  • Especialista acerta: RAG permite destilação de conhecimento ambiental através de reconhecimento de padrões

Quando RAG Sai pela Culatra:

  • Se os padrões recuperados forem de ambientes diferentes, restrições erradas são aprendidas
  • Se os exemplos bem-sucedidos forem muito esparsos, padrões não são estatisticamente significativos
  • Mitigação: Filtrar recuperação por similaridade de ambiente; exigir tamanho mínimo de amostra para extração de padrões

Gates de Qualidade

  • Proposta e validação usam diferentes capacidades de modelo (ex.: LLM propõe, VLM valida)
  • Precisão da avaliação rápida >45% e precisão da avaliação lenta >75% medidas em conjunto de teste reservado
  • Admissão na biblioteca requer validação independente, não apenas sucesso no loop de treinamento
  • Decomposição de tarefas complexas gera 3-7 subtarefas significativas com ordenação de dependência clara
  • Recuperação por RAG melhora o aprendizado de restrições em >15% em relação à linha de base sem RAG
  • Análise de granularidade de habilidades mostra agrupamento semântico, não enumeração paramétrica
  • Sistema pode detectar e se recuperar de modos de falha de dependência circular
  • Taxa de contaminação da biblioteca <25% verificada por avaliação independente
  • Decomposição top-down supera encadeamento bottom-up em >2x em tarefas complexas
  • Destilação de conhecimento ambiental demonstra aprendizado de restrições a partir de padrões de sucesso

Limitações (NÃO-FOR Boundaries)

NÃO use esta habilidade para:

  • Tarefas predeterminadas com critérios de sucesso conhecidos → Use RL padrão com recompensas artesanais
  • Tarefas de manipulação de etapa única → Use aprendizado supervisionado com dados de demonstração
  • Tarefas que exigem desempenho em tempo real → Validação de processo duplo muito lenta; use biblioteca de habilidades em cache
  • Domínios sem feedback visual → Validação por VLM indisponível; projete validadores independentes específicos do domínio
  • Ambientes com recursos limitados → Validação do Sistema 2 cara; aceite menor precisão ou use validação hierárquica

Delegue para estas habilidades:

  • Engenharia de recompensa padrão → Para tarefas com métricas de sucesso claras
  • Aprendizado por imitação → Para tarefas com dados de demonstração abundantes
  • RL hierárquico → Para tarefas com decomposição de habilidades conhecida
  • Meta-aprendizado → Para adaptação rápida a novas distribuições de tarefas
  • IA Constitucional → Para tarefas que exigem alinhamento de valores e restrições de segurança

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

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

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

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