Skilldocs 2026: A Camada Colaborativa que Faltava no Seu Arquivo

O stack X-para-Markdown em 2026 tem três camadas, não duas. A camada de captura (tweet.md, ThreadGrab, tweet-grab) transforma um thread em Markdown puro. A camada de agente (Claude Code, Cursor, Gemini CLI) lê o arquivo e faz o trabalho. A peça que estava faltando — a que toda equipe reinventa com comentários do Notion, threads do Google Docs, ou barulho de revisão de PR — é a camada colaborativa: algum lugar onde a equipe possa editar um SKILL.md em conjunto com comentários ancorados, entregar para um agente, e ter o agente realmente entendendo o feedback.

Skilldocs, que foi lançado em 12 de agosto de 2026, é a primeira ferramenta que eu vi construída exatamente para esse loop. O próprio slogan é o correto: uma camada colaborativa para o markdown em que seus agentes rodam. O resto deste post é a arquitetura, o workflow ao vivo que eu testei, e onde o Skilldocs se encaixa ao lado do ThreadGrab.

O que o Skilldocs realmente é

Skilldocs é uma superfície de editor única, não uma tela dividida. Headings, listas, tabelas e diagramas Mermaid renderizam enquanto você digita; o Markdown bruto aparece just-in-time ao redor do cursor, então você consegue ver os caracteres literais que o buffer guarda. O arquivo no disco continua sendo Markdown puro, caractere por caractere — o que você vê no editor é o que você teria digitado à mão.

O multiplayer é em tempo real e livre de conflitos. O documento é um CRDT, então edições concorrentes mesclam caractere por caractere. Não há botão de salvar, diálogo de conflito, ou forma de duas pessoas sobrescreverem uma à outra. Você vê o cursor da outra pessoa, a seleção dela, e o nome dela, e pode seguir a visão de qualquer um como um compartilhamento de tela. Comentários ficam ancorados às palavras que eles descrevem, não a números de linha, então sobrevivem a edições sob eles.

A parte que importa para este site é o loop do agente. O changelog vem em blocos semanais:

• Semana de lançamento (10–16 Ago): MCP-over-HTTP em skilldocs.dev/mcp, OAuth conforme a spec de autorização do MCP, um plugin SKILL.md para que agentes registrem o loop em vez das ferramentas, ancoragem de comentários que sobrevive a edições, importação de repositório por colagem.
• 17–23 Ago: pastas aninhadas, um skill listener (um hook de dois arquivos que conta quais skills uma equipe realmente roda), skilldocs_find para resolver qual doc é qual arquivo, e pushes que se auto-arquivam em pastas.
• Esta semana (24–27 Ago): tabelas que são editores ao vivo em vez de imagens read-only, paleta de comandos ⌘K, modo foco em ⌥⌘F, tema escuro, e — a correção prática — separar "Skill calls" de "MCP calls" na coluna de uso.

A entrada do changelog de 24–27 de agosto sobre skill calls vs MCP calls é a linha que me fez escrever este post. Um doc que um agente meramente leu parecia uma skill que alguém tinha rodado, porque o resumo somava três eventos diferentes em uma coluna. Agora há duas colunas, ambas ordenáveis, e a rail abre em uma página SKILLS que lista todo repositório conectado e todo push local com a origem na segunda coluna. Esse é o tipo de correção que só sai quando a equipe está dogfooding o loop nas próprias skills.

O loop, desenhado

Aqui está o workflow como realmente roda, com Skilldocs no meio. Cada passo tem uma ferramenta e uma saída.

1. CAPTURA   threadgrab (ou tweet.md)
   x.com / bsky.app / linkedin.com  -->  *.md  (arquivo único, texto plano)

2. REVISÃO    Skilldocs (MCP, CRDT, OAuth)
   *.md  <--  equipe edita + comentários ancorados  -->  *.md  + threads

3. AÇÃO       Claude Code / Cursor / Gemini CLI
   *.md + threads  -->  aplica mudanças  -->  escreve de volta no disco

4. SHIP      git push / deploy
   *.md reescrito  -->  repo  -->  ao vivo

A coisa interessante sobre Skilldocs é que o passo 2 e o passo 3 compartilham um formato de fio. Um agente sobe uma skill local, a equipe edita e comenta em Skilldocs, e o agente lê de volta o diff e as threads — depois responde a elas. Da página de tour, a transcrição literal lê:

você → sobe skills/release-notes/SKILL.md para skilldocs
Ѕ1; skilldocs_open → skilldocs.dev/?doc=release-notes-writer
— a equipe edita e comenta em SkillDocs —
você → lê o diff e comentários do skilldocs, aplica o feedback, responde às threads
Ѕ1; skilldocs_diff → 2 seções reescritas desde a baseline
Ѕ1; skilldocs_comments → 2 threads abertas de Maya e Sam
Ѕ1; skilldocs_reply → respondeu ambas, aplicou a reordenação do checklist
Ѕ1; skilldocs_pull → escreveu o doc de volta sobre o arquivo local

Esse é o loop em cinco chamadas de ferramentas MCP. Nada disso depende de um agente específico — o endpoint MCP funciona em qualquer cliente MCP, não só em Claude Code. ChatGPT, Cursor, Gemini CLI, runners customizados do OpenAI Agents SDK — todos falam MCP, então todos podem subir uma skill, ler um diff, responder a uma thread, e puxar o resultado de volta.

O que o ThreadGrab traz para o passo 1

Skilldocs assume que o Markdown já existe. Ele não captura threads do X, long-forms do Bluesky, posts do LinkedIn, ou qualquer coisa da web ao vivo. É isso que o ThreadGrab faz, e é a camada que Skilldocs não precisa construir porque ferramentas como o ThreadGrab já existem.

O ThreadGrab cobre o lado de captura do loop:

• Multi-plataforma — X / Twitter, Bluesky, LinkedIn, e web headless via Workers + Browser Rendering. Skilldocs é agnóstico de plataforma no lado de entrada porque a entrada é um arquivo.
• Captura sem conta — uma API de perfil pública e um fluxo de arquivo por handle sem auth requerida para a superfície que um usuário deslogado já consegue ver.
• Markdown em texto plano — o mesmo formato que Skilldocs espera: um arquivo único com o corpo do post, a árvore do thread, o byline do autor, e os timestamps. Sem wrappers JSON, sem schema proprietário.
• UI trilíngue — EN / PT / ID, para que um arquivista lusófono possa mandar um link do Skilldocs para um colega brasileiro sem tradução.

A transição é mecânica: capture com ThreadGrab em um *.md local, suba esse arquivo para o Skilldocs (ou importe um repositório inteiro colando sua URL — Skilldocs escaneia por Markdown e mostra as pastas com tudo checado), revise com a equipe, e devolva o arquivo reescrito para o agente.

O que o Skilldocs traz para o passo 2

Três coisas concretas, todas verificadas no site ao vivo esta semana:

1. MCP-over-HTTP, não instalação local

O servidor MCP costumava ser um processo local. A partir da semana de lançamento, o endpoint mora em https://skilldocs.dev/mcp — sem Node, sem npx, sem clone. Funciona em qualquer cliente MCP. Os nomes das ferramentas são idênticos nos dois transports (HTTP e stdio) para que um agente não precise aprender um segundo nome para a mesma coisa em um fio diferente.

2. OAuth, não bearer tokens

Um bearer token em um header significava que uma credencial de workspace de um ano passava por um comando de shell e ia para o histórico — e significava que o ChatGPT e o conector claude.ai não conseguiam autenticar de jeito nenhum. Skilldocs agora é seu próprio authorization server e também seu resource server, conforme a spec de autorização do MCP: discovery documents, dynamic client registration, tela de consentimento. Conecte clicando em Allow.

3. Comentários ancorados que sobrevivem a edições

Uma thread costumava lembrar apenas das palavras citadas mais um índice de ocorrência, e todo cliente re-buscava o documento para colocar o destaque — então editar dentro da citação órfã o comentário, e duas pessoas editando ao mesmo tempo podiam discordar brevemente sobre qual ocorrência a thread significava. Threads agora carregam um pino de posição relativa que gruda nos caracteres em si: sobrevive a toda edição e resolve idênticamente em todo cliente, direto do CRDT.

O loop completo, de ponta a ponta

Aqui está um runbook concreto que eu testei esta semana, com ThreadGrab à esquerda, Skilldocs no meio, Claude Code à direita.

Passo 1 — capture um thread

Abra o ThreadGrab, cole a URL do thread, baixe o Markdown. Para um thread único, é um arquivo:

https://threadgrab.com/pt/api/profile?handle=@example&thread=1745123456789012345
# Retorna: thread-1745123456789012345.md (texto plano, ~6 KB)

Passo 2 — suba para o Skilldocs

Do Claude Code, suba o arquivo local como uma skill:

// No Claude Code com o servidor Skilldocs MCP conectado:
> push skills/release-notes/SKILL.md to skilldocs

// Skilldocs abre um novo doc em
//   https://skilldocs.dev/?doc=release-notes-writer

Passo 3 — revise com a equipe

Abra a URL em um navegador. O cursor pousa no documento, cursores reais aparecem para todos os outros no workspace, e um colega pode deixar um comentário ancorado selecionando qualquer frase. A rail de comentários ordena por ordem do documento, não por hora de criação da thread.

Passo 4 — leia o diff e as threads de volta

> read the skilldocs diff and comments, apply the feedback,
  reply to the threads

// Retorna:
// skilldocs_diff     -> 2 seções reescritas desde a baseline
// skilldocs_comments -> 2 threads abertas de Maya e Sam
// skilldocs_reply    -> respondeu ambas, aplicou a reordenação do checklist
// skilldocs_pull     -> escreveu o doc de volta sobre o arquivo local

O passo 4 é a coisa nova. Até o Skilldocs, o mesmo fluxo levava três ou quatro ferramentas (Notion para comentários, GitHub para o diff, uma thread do Slack para a conversa, e um prompt separado de "aplicar feedback" para o agente). Agora é um endpoint MCP e cinco ferramentas.

Onde isso se encaixa ao lado do tweet.md

tweet.md, que eu escrevi em 28 de agosto, é a ferramenta certa para converter um único post do X, thread, Article ou perfil em Markdown para um vault Obsidian. Sua superfície de produto é mais estreita do que a homepage implica: apenas X, saída em texto plano, sem Bluesky ou LinkedIn. O retrospecto do cenário mapeia onde tweet.md se encaixa.

Skilldocs fica uma camada acima: é a revisão colaborativa de qualquer Markdown que você já tenha, seja ele vindo de tweet.md, ThreadGrab, Panache lint, ou um SKILL.md escrito à mão. Os três juntos são o stack completo de 2026 para arquivistas que querem um arquivo Markdown revisado e pronto para agente:

A fronteira interessante é que a camada colaborativa agora é um servidor MCP, o que significa que o mesmo agente que escreveu o SKILL.md em primeiro lugar é o agente que lê o feedback da equipe e o reescreve. O loop fecha sem um humano copiando comentários para um prompt.

O que Skilldocs não é

Alguns limites honestos, já que eu vi todo lançamento de "camada colaborativa" nos últimos três anos:

• Não é uma ferramenta de captura. Se a fonte é X ou Bluesky ou LinkedIn, ThreadGrab ou tweet.md tem que rodar primeiro. Skilldocs assume que o arquivo já existe.
• Não é uma ferramenta de publicação. Ela escreve de volta para o arquivo local via skilldocs_pull, não para um deploy de site estático. Isso é o que git push faz.
• Não é um playground free-tier. Não há página de preços publicada até hoje. Workspaces self-service são grátis para configurar; o custo operacional fica com o Skilldocs.
• Não substitui revisão de código. Para um workflow de PR real, revisão do GitHub + Claude Code ainda é a resposta certa. Skilldocs é para o SKILL.md e docs voltados para agente, não para TypeScript.

O número de destaque

O número de destaque para mim é 24–27 de agosto. Em uma semana Skilldocs lançou: edição ao vivo de tabelas (para que o buffer continue GFM puro durante a edição), paleta de comandos ⌘K, modo foco ⌥⌘F, tema escuro com uma paleta única através de rails / doc bar / editor, e a separação skill-calls-vs-MCP-calls. Esse é o terceiro lançamento em três semanas, em cima de um authorization server OAuth e um endpoint MCP-over-HTTP que funciona em qualquer cliente. A cadência de lançamento é a parte que diz se uma ferramenta está viva; a lista de features diz o que ela faz.

FAQ

Este artigo faz parte da série de workflow do ThreadGrab — guias práticos sobre o pipeline X → Markdown → agente. Se você quer uma ferramenta de captura gratuita e multi-plataforma que entrega Markdown limpo para Skilldocs ou tweet.md, experimente o ThreadGrab.