Perguntas Frequentes
Este capítulo reúne perguntas frequentes, soluções de solução de problemas e explicações sobre a filosofia de design durante o uso do OpenSkills, ajudando você a localizar e resolver problemas rapidamente.
Conteúdo deste Capítulo
Perguntas Frequentes
Responda a dúvidas comuns sobre instalação, configuração e uso. Inclui diferenças entre OpenSkills e Claude Code, local de instalação de habilidades, problemas de sincronização do AGENTS.md, compartilhamento de habilidades entre múltiplos projetos, etc.
Solução de Problemas
Forneça métodos de diagnóstico e correção para erros comuns. Cubra etapas detalhadas de resolução para falhas de Git clone, não encontrar SKILL.md, habilidades não encontradas, erros de permissão, atualizações puladas, etc.
Por que CLI?
Explique os motivos de design do OpenSkills escolher CLI em vez de MCP. Compare profundamente as diferenças de posicionamento entre os dois, entenda por que o sistema de habilidades é mais adequado para o modo de arquivo estático.
Caminho de Aprendizado
Encontrou problemas?
│
├─ Não sabe como usar ──────────→ Perguntas Frequentes
│ (conceitos, configuração, dicas de uso)
│
├─ Ocorreu um erro ──────────────→ Solução de Problemas
│ (diagnóstico de erro, etapas de correção)
│
└─ Quer entender a filosofia de design ─→ Por que CLI?
(seleção técnica, decisões de arquitetura)Ordem recomendada:
- Primeiro veja Perguntas Frequentes → Entenda rapidamente conceitos centrais e dicas de uso
- Encontrar erros, veja Solução de Problemas → Encontre soluções com base nas mensagens de erro
- Quer entender profundamente, veja a filosofia de design → Entenda considerações técnicas CLI vs MCP
Pré-requisitos
Recomendado completar primeiro
- Início Rápido - Entenda o fluxo básico de uso
- Instalar OpenSkills - Certifique-se de que a configuração do ambiente está correta
Próximos Passos
Após concluir este capítulo, você pode:
- Explorar recursos avançados → Tutorial Avançado para aprender modo Universal, habilidades personalizadas, etc.
- Consultar referência de comandos → Referência da API CLI para obter documentação completa de comandos
- Entender atualizações de versão → Registro de Alterações para ver novos recursos e alterações
Navegação Rápida
| Tipo de Problema | Onde encontrar resposta |
|---|---|
| "O que é OpenSkills?" | Perguntas Frequentes |
| "Onde as habilidades são instaladas?" | Perguntas Frequentes |
| "Falha no Git clone" | Solução de Problemas |
| "Não encontrar SKILL.md" | Solução de Problemas |
| "Por que não usar MCP?" | Por que CLI? |