Claude Skills

No ecossistema Anthropic, uma “Skill” é uma pasta com um SKILL.md que embute instruções, referências e scripts reutilizáveis — ensinando o Claude como operar um sistema externo (por exemplo, o Obsidian). É a camada de “como fazer”, complementar ao MCP (“o que acessar”).

Definition

Claude Skills são funcionalidades do ecossistema Anthropic que carregam dinamicamente instruções para o Claude sobre como interagir com sistemas externos. Um plugin como kepano/obsidian-skills (13,9k+ estrelas no GitHub) fornece habilidades pré-feitas que ensinam o Claude a criar notas, adicionar links internos, pesquisar conteúdo ou extrair texto de uma página no Obsidian.

Key Points

  • A mesma Skill pode rodar no Claude.ai, no Claude Code e via API — é portátil entre frentes.
  • No LLM Wiki, Skills permitem que o usuário dê instruções em linguagem natural (“escreva um resumo do artigo X numa nova página do meu wiki”) e o Claude execute os passos operando o arquivo local do Obsidian.
  • O relatório posiciona Skills como a “instrutora de ferramentas” do ecossistema, ao lado do Claude Code (agente), MCP (conector) e Projects (isolamento de contexto).
  • Conexão direta com este vault: o scripts/mcp-server.py e os fluxos guiados (ingest/query/lint em llm-wiki) são, na prática, a mesma ideia de “Skills” — procedimentos reutilizáveis que operam a pasta wiki/.

🔗 Conexão inferida — sugestão do segundo cérebro

Liga para: claude-code, model-context-protocol, obsidian Evidência observável: O relatório descreve Skills, MCP e Claude Code como um trio integrado; Skills são citadas como a ponte prática entre o LLM e o Obsidian no padrão LLM Wiki.

Implications

Este vault já é operado por Skills no Hermes (os bundles synaptic-ingest, synaptic-find, etc. são exatamente Skills). A lição do relatório é usar Skills para tirar o “muito manual” do fluxo: em vez de o dono fazer cada passo, a Skill encapsula o procedimento. Isso alinha com a queixa do dono de que o processo era “muito manual”.

Open Questions

  • Quais Skills específicas trariam mais valor para o dono (ingest automático? relatoria em português? visualização do grafo?)?
  • Skills locais devem ser versionadas em wiki/ ou mantidas fora da camada de conhecimento?

Official Obsidian Skills vs Custom Vault Skills (2026)

A 2026 hands-on tutorial (roanmonteiro, 2026-05-03) splits the skill layer into two tiers with different jobs:

  • Official skills (kepano/obsidian-skills, 13.9k+ stars, launched January 2026) teach Obsidian’s “native language”: obsidian-markdown (wikilinks, callouts, typed frontmatter — without it the graph stays empty), obsidian-bases (.base database views), json-canvas, obsidian-cli (vault automation via terminal), and defuddle (clean URL extraction that slashes ingest token cost).
  • Custom vault skills encode your patterns, not Obsidian’s: the tutorial ships adr-writing (MADR numbering, immutable-once-accepted, superseded-not-deleted) and debrief-writing (blameless post-mortems forcing a “generalizable learning” section) as templates.

The tutorial’s division of labor maps onto the descriptive/imperative split it also draws: skills are descriptive (“how we do X here”), slash commands are imperative (“do X now”) — e.g. /wiki-ingest presenting an INGESTION PLAN and waiting for approval before writing a line to the wiki, with allowed-tools frontmatter as the security allowlist that makes prompt injection via clipped content unable to run destructive commands.

Implications: this vault already runs the same two tiers — global bundles (synaptic-ingest, synaptic-query) as operational skills, .agents/wiki-page-templates.md + _schema.md as the schema layer the tutorial puts in “Zone 0”. The defuddle observation (content extraction dominates ingest cost) is worth revisiting when the RSS/feed ingester proposed in vault-roadmap ships.

Enriched Skills and Headless Runs

The video distinguishes a basic SKILL.md from a richer skill folder containing reference files and visual assets. In the example, the instruction file routes Claude Code to brand guidance, allowing a design skill to produce consistent PDFs and other artifacts without putting every detail into one prompt file.

It also describes invoking a skill outside an interactive chat through claude -p, a one-shot headless session that can be launched from a dashboard or internal application. This makes the skill the reusable unit while the interface acts as a launcher. The source is a practitioner demonstration, not independent evidence about current Claude product behavior.

Implications: Skills in this vault can remain small routers with references rather than monolithic instruction files. Headless execution is useful only after the skill is reliable; otherwise it automates an unverified workflow.

Sources