O que Índice de Habilidades NeuroSkill faz?
O NeuroSkill é um companheiro de IA biométrico alimentado por um dispositivo EEG em tempo real. Ele lê ondas cerebrais e fisiologia continuamente e usa esses dados para informar cada resposta.
O NeuroSkill expõe a API de análise de EEG por meio de um servidor WebSocket local e um túnel HTTP.
O CLI npx neuroskill <comando> é a maneira mais rápida de consultá-lo a partir de um terminal, script de shell
ou qualquer pipeline de automação.
As habilidades são carregadas contextualmente — o LLM carrega o arquivo de habilidade relevante em seu contexto quando a mensagem do usuário corresponde ao domínio da habilidade.
Habilidades de Dados EEG e API
| Habilidade | Carregada quando | Descrição |
|---|---|---|
| neuroskill-transport | perguntas sobre transporte/conexão | Transporte WebSocket e HTTP, descoberta de porta, Guia de Início Rápido, modos de saída (--json / --full) e flags globais do CLI. |
| neuroskill-status | perguntas sobre status/dispositivo | Comando status — instantâneo completo do sistema: estado do dispositivo (4 tipos de dispositivo), qualidade do sinal, pontuações EEG, potências das bandas, razões, resumo de hooks, embeddings, rótulos, resumo do sono e histórico de gravação. |
| neuroskill-sessions | perguntas sobre sessão/histórico | Comandos session e sessions — análises detalhadas de métricas por sessão com tendências de primeira/segunda metade, listagem de sessões e auxiliares de timestamp Unix. |
| neuroskill-search | perguntas sobre comparação/tendência | Comandos search e compare — busca ANN por momentos EEG neuralmente similares em todo o histórico e comparação de sessões A/B com deltas de métricas e enfileiramento UMAP. |
| neuroskill-sleep | contexto de sono/fadiga | Comandos sleep e umap — classificação de estágios do sono baseada em EEG (Vigília/N1/N2/N3/REM) com análise de eficiência e episódios, e projeção 3D UMAP para comparação espacial de sessões. |
| neuroskill-labels | contexto de rótulo/busca | Comandos label, search-labels e interactive — criação de anotações de texto EEG, busca vetorial semântica sobre rótulos e busca em grafo multimodal de 5 camadas combinando texto, similaridade EEG e descoberta de capturas de tela com visualização 3D. |
| neuroskill-streaming | contexto de streaming/calibração/TTS | Comandos say, listen, notify, calibrate, calibrations, timer e raw — fala TTS no dispositivo, streaming de eventos WebSocket em tempo real, notificações do SO, gerenciamento de perfil de calibração, timer de foco e passagem de JSON bruto. |
| neuroskill-hooks | contexto de hooks/automação | Comando hooks — CRUD de Hooks Proativos, correspondência de padrões EEG em tempo real com portão de cenário (cognitivo/emocional/físico), sugestões de limiar, gatilhos de broadcast WebSocket e registro de auditoria. |
| neuroskill-dnd | contexto de DND/modo foco | Comando dnd — automação de Não Perturbe orientada por EEG, média móvel de pontuação de foco, estado DND do SO e ativação/desativação forçada. |
| neuroskill-calendar | perguntas sobre calendário/agenda/reuniões/eventos | Comando calendar — eventos de calendário do SO via EventKit (macOS), arquivos iCal (Linux/Windows); buscar por intervalo, verificar status de acesso, solicitar permissão. |
| neuroskill-screenshots | contexto de captura de tela/OCR/busca visual | Comandos search-images, screenshots-around, screenshots-for-eeg e eeg-for-screenshots — buscar capturas de tela por texto OCR (semântico ou substring), por similaridade visual (CLIP --by-image), encontrar capturas de tela próximas a um timestamp ou sessão EEG e ponte multimodal EEG↔captura de tela (encontrar estado cerebral para conteúdo de tela ou conteúdo de tela para estado cerebral). |
| neuroskill-data-reference | perguntas sobre campos de métricas | Todos os campos de métricas — potências de banda, razões e índices EEG, pontuações principais, medidas de complexidade, PPG/HRV, marcadores de movimento e artefato, códigos de estágio do sono, índices neurológicos e métricas de consciência. |
| neuroskill-recipes | perguntas sobre script/automação | Receitas de casos de uso e padrões de script — monitoramento de foco, rastreamento de estresse, análise do sono, consultas de carga cognitiva, rastreamento de meditação, busca multimodal em grafo, comparação A/B, consultas por intervalo de tempo e automação com cron/Python/Node.js/HTTP. |
Habilidades de LLM e IA
| Habilidade | Carregada quando | Descrição |
|---|---|---|
| neuroskill-llm | perguntas sobre LLM/chat/modelo | Servidor de inferência LLM integrado no dispositivo — gerenciamento de catálogo de modelos (adicionar/baixar/selecionar/excluir modelos GGUF), suporte a visão (mmproj), chat WebSocket e HTTP em streaming, chamada automática de ferramentas, ajuste de GenParams, histórico de chat persistente e API compatível com OpenAI. |
Habilidades de Protocolo e Intervenção
| Habilidade | Carregada quando | Descrição |
|---|---|---|
| neuroskill-evidence | qualquer intervenção, protocolo, rastreamento de hábito ou pergunta "o que funciona para mim?" | Mecanismo de coleta de evidências implícitas e motor de eficácia pessoal — esquema de rótulo padronizado px:, medição automática antes/depois, pontuação de resultado, classificação de protocolo pessoal, rastreamento de eventos de vida, regras de seleção baseadas em evidências e proteções de privacidade. Todas as outras habilidades que fornecem intervenções DEVEM seguir as regras desta habilidade. |
| neuroskill-protocols | qualquer intenção de protocolo/exercício/rotina detectada | Hub de estrutura de protocolos — motor de personalização, guia de integração de API, roteador de modalidade, orientação de correspondência e índice de 11 sub-habilidades de domínio. Sempre carregada junto com as sub-habilidades de domínio. |
| neuroskill-protocols-focus | foco, atenção, carga cognitiva, energia, alerta, meditação, fluxo, criatividade | Protocolos de foco, atenção, cognição, consciência, meditação profunda e energia/alerta. |
| neuroskill-protocols-stress | estresse, ansiedade, relaxamento, HRV, calma, sobrecarga, exercícios respiratórios | Protocolos de estresse, relaxamento, regulação autonômica, HRV, equilíbrio hemisférico e relaxamento profundo. |
| neuroskill-protocols-emotions | emoções, humor, raiva, luto, tristeza, vergonha, medo, solidão, alegria | Protocolos de regulação emocional, humor e processamento emocional estendido (12 emoções específicas). |
| neuroskill-protocols-sleep | sono, insônia, soneca, descanso, recuperação, NSDR, cansaço | Protocolos de sono, circadiano, recuperação, NSDR/yoga nidra e soneca energética. |
| neuroskill-protocols-body | corpo, tensão, pescoço, dor de cabeça, cansaço visual, postura, dor, aterramento | Protocolos corporais, somáticos, cervicais/pescoço, exercícios oculares, dor de cabeça/enxaqueca e motores. |
| neuroskill-protocols-routines | rotina matinal, academia, treino, exercício, hidratação, pausa | Protocolos de rotinas matinais, treino/academia, hidratação e pausa para movimento. |
| neuroskill-protocols-nutrition | comida, dieta, nutrição, cafeína, jejum, refeição, desejos, álcool | Protocolos dietéticos, de nutrição, horário da cafeína, jejum, alimentação e intestino-cérebro. |
| neuroskill-protocols-music | música, playlist, audição, batidas binaurais, canto | Protocolos de música — sugestões de gênero/BPM/artista para humor, foco, estresse, sono e liberação emocional. |
| neuroskill-protocols-digital | mídia social, telefone, tempo de tela, rolagem, detox digital, FOMO | Protocolos de mídia social, dependência digital, tempo de tela e restauração da atenção. |
| neuroskill-protocols-breathfree | não respiratório, livre de respiração, alternativo, tátil, inquietação, água fria | Mais de 30 alternativas não respiratórias — cognitivas, táteis, oculomotoras, micromovimentos, auditivas e fisiológicas passivas. |
| neuroskill-protocols-life | pai/mãe, idoso, adolescente, estudante, TDAH, autismo, deslocamento, trabalho por turnos, relacionamento, deficiência, cultural | Protocolos específicos de contexto para 11 situações de vida — parentalidade, envelhecimento, adolescentes, neurodivergentes, viajantes, trabalhadores manuais, saúde, relacionamentos, acessibilidade, culturais e situacionais. |
Ferramentas Disponíveis para o LLM
O chat LLM integrado tem acesso a estas ferramentas (ativadas em Configurações > LLM > Ferramentas):
| Ferramenta | Propósito |
|---|---|
date | Obter metadados de data/hora atuais (timestamps Unix, fuso horário, local/UTC). |
location | Geolocalização aproximada de IP público (país/região/cidade/fuso horário). |
bash | Executar comandos de shell e retornar stdout/stderr. |
read_file | Ler conteúdo de arquivo do disco. |
write_file | Escrever / criar arquivos. |
edit_file | Edições cirúrgicas de localizar e substituir em arquivos. |
search_output | Navegar por saídas grandes de ferramentas (regex paginado/head/tail). |
web_search | Pesquisar na web e retornar resultados. |
web_fetch | Buscar uma URL e retornar seu conteúdo. |
skill | Consultar a API EEG do NeuroSkill (status, sessões, rótulos, busca, hooks, DND, calibrações, TTS, etc.). |
Como Funciona o Carregamento de Habilidades
As habilidades são descobertas automaticamente a partir de:
~/.skill/skills/— habilidades globais do usuário<projeto>/.skill/skills/— habilidades locais do projeto- O diretório
skills/empacotado (este repositório)
Cada habilidade tem um SKILL.md com frontmatter YAML (name, description). Na inicialização do servidor
LLM, todas as habilidades são descobertas e seus nomes/descrições são injetados no prompt do sistema
como um bloco XML <available_skills>. Quando a tarefa do usuário corresponde à descrição de uma habilidade,
o LLM usa a ferramenta read_file para carregar as instruções completas do arquivo SKILL.md.