O que codex-obsidian-skills faz?
Habilidades do Codex para converter materiais de curso em Markdown do Obsidian e organizar cofres Obsidian existentes.
Funcionalidades
- Conversão de Material de Curso: Transforma slides de aula, PDFs, notas e outros formatos de curso em arquivos Markdown do Obsidian.
- Organização de Cofres: Reestrutura e organiza cofres Obsidian existentes, aplicando convenções consistentes de nomenclatura e pastas.
- Suporte a Metadados: Extrai e incorpora metadados (título, autor, data, tags) nos arquivos Markdown gerados.
- Links Bidirecionais: Cria links entre conceitos relacionados, facilitando a navegação e descoberta.
- Tags e Grafos: Adiciona tags relevantes e estrutura para visualização em grafos do Obsidian.
Plataformas Suportadas
- Codex CLI
- Cursor
- Claude Code
- Outros agentes de IA compatíveis com skills Codex
Como Usar
Para converter um material de curso:
codex skill run blacksheep1118/codex-obsidian-skills --input curso.pdf --output vault/curso/
Para organizar um cofre existente:
codex skill run blacksheep1118/codex-obsidian-skills --organize vault/meu-cofre/
Parâmetros
| Parâmetro | Descrição | Obrigatório |
|---|---|---|
--input | Caminho para o arquivo de entrada (PDF, Markdown, etc.) | Sim (para conversão) |
--output | Diretório de saída para os arquivos Markdown | Sim (para conversão) |
--organize | Caminho do cofre Obsidian para organizar | Sim (para organização) |
--tags | Lista de tags separadas por vírgula para adicionar | Não |
--dry-run | Simula a operação sem modificar arquivos | Não |
Exemplo de Conversão
Entrada (aula-01.pdf): slides de aula sobre algoritmos de ordenação.
Saída (no diretório vault/aula-01/):
aula-01.md— Nota principal com resumo e metadadosconceitos/bubble-sort.md— Nota detalhada sobre Bubble Sortconceitos/quick-sort.md— Nota detalhada sobre Quick Sortexercicios/lista-01.md— Exercícios relacionados
Exemplo de Organização
O skill pode reorganizar um cofre existente aplicando convenções como:
meu-cofre/
├── aulas/
│ ├── 2025-01-10-aula-01.md
│ └── 2025-01-17-aula-02.md
├── conceitos/
│ ├── algoritmo.md
│ └── estrutura-de-dados.md
└── tags/
Notas Técnicas
- Preserva links internos e referências existentes.
- Não modifica arquivos fora do diretório especificado.
- Suporta codificação UTF-8.
- Os arquivos gerados usam o formato YAML frontmatter para metadados.
Licença
Este skill é fornecido sob a licença MIT.