Guia Original CODEZ / 01
Como escolher uma habilidade de agente: da classificação por estrelas ao teste prático
Listas podem ajudar a refinar sua busca. A seleção ideal depende da capacidade da habilidade em realizar uma tarefa específica no seu ambiente. Este guia fornece um método de filtragem reutilizável.
Fontes conferidas:
O formato e os fatos dos projetos vêm das fontes originais vinculadas; as etapas de seleção e aceitação são recomendações editoriais da CODEZ. Os skills PDF são entradas reais, comparadas aos originais em um commit fixado. Não executamos esses skills de terceiros; os exemplos não são resultados medidos.
01 / Primeiro determine qual habilidade você precisa
Agent Skills costumam ser organizados em pastas. SKILL.md contém metadados e instruções de tarefas; a pasta também pode incluir scripts, referências e modelos. O campo compatibility da especificação informa requisitos do ambiente, mas é opcional. Mesmo sem ele, verifique o corpo do documento e as dependências.
Primeiro, descreva os métodos de entrada, saída e aceitação. Por exemplo, "Extrair tabelas de PDFs com camadas de texto para arquivos CSV, preservando os nomes das colunas". "Ajudar-me a processar documentos" é muito amplo, dificultando determinar se um candidato é adequado.
02 / O que as estrelas de um repositório indicam
As estrelas do GitHub podem ser usadas para adicionar projetos aos favoritos e expressar apreço pelo trabalho dos mantenedores. Portanto, usamos isso como um indicador para descobrir a popularidade de um projeto.
Este site usa estrelas de repositório para classificação. Um repositório com centenas de habilidades pode atrair atenção apenas por uma parte do seu conteúdo; o total de estrelas de um repositório não pode ser atribuído a cada habilidade individualmente. Ao comparar habilidades de dois repositórios, a adequação à tarefa é comparada em primeiro lugar, seguida pela popularidade como consideração secundária.
A data da atualização mais recente só ajuda a localizar informações. Uma única alteração não relacionada não significa que a funcionalidade que você precisa foi corrigida; você deve verificar os commits, exemplos e registros de problemas do diretório correspondente.
03 / Transformar requisitos em condições inspecionáveis
As seguintes condições são mais fáceis de interpretar e verificar do que uma simples classificação de popularidade. O número de condições atendidas pelos candidatos não precisa ser combinado em uma pontuação total aparentemente precisa.
| Cenário | Primeiro verifique | Observe durante o uso experimental. |
|---|---|---|
| Processamento de documentos e planilhas | Tipo de entrada, formato de saída, dependências do sistema | Perda de nomes de colunas, codificação, layout ou dados |
| Fluxo de trabalho de código e desenvolvimento | Idioma de destino, versão do framework e ferramentas necessárias | Escopo das alterações, feedback sobre erros e aprovação do projeto na inspeção. |
| Pesquisa e Compilação de Dados | Escopo da fonte, requisitos de citação e condições da rede. | É possível rastrear as citações até a origem delas? A conclusão excede as evidências? |
04 / Abra o arquivo original e verifique o ambiente e o escopo operacional.
Abra SKILL.md pelo cartão deste site e leia o README da mesma pasta. Um README em chinês ajuda a entender as instruções, mas a disponibilidade de idiomas não comprova a adequação do skill. Sem uma versão em chinês, confira os requisitos essenciais no original.
Anote essas informações antes de testar:
- Ambiente operacional: Clientes, sistemas operacionais, ferramentas de linha de comando e requisitos de versão explicitamente definidos, suportados.
- Escopo da operação: Quais arquivos serão lidos ou modificados, quais serviços externos serão acionados e se credenciais serão necessárias.
- Recursos adicionais: Os scripts e arquivos de referência citados no texto existem? O que os comandos executados farão?
- Condições de uso: leia as licenças do projeto e da pasta do skill. As etiquetas «Não especificado» ou «Pendente de verificação» indicam informações ainda não confirmadas.
- Informações reproduzíveis: Registre o endereço do repositório, o caminho específico da habilidade e a versão do commit durante o período de teste para evitar não conseguir encontrar o mesmo conteúdo posteriormente.
05 / Compare candidatos com a mesma tarefa pequena
Selecione dois ou três candidatos que melhor se adequem à tarefa e teste-os com a mesma entrada não sensível em uma cópia de teste recuperável. Habilite apenas os recursos necessários no momento, seguindo as instruções de instalação do cliente.
Defina as condições de sucesso antes de começar. Para extração de tabelas, verifique a contagem de linhas, os nomes das colunas e os valores nulos; para modificações de código, verifique a funcionalidade desejada, os arquivos modificados e as verificações de projeto existentes. Quando uma execução falhar, registre o erro e o ambiente; não atribua imediatamente a falha ao modelo ou à habilidade em si.
Registre todas as correções manuais necessárias, ferramentas adicionais, custos de serviços externos e tempo de conclusão. Usar um método de registro consistente para tarefas repetitivas facilita a tomada de decisões, em vez de depender de uma única impressão do resultado.
- Candidatos e versões: Repositório/Caminho de habilidade/Commit.
- Entrada e ambiente: Amostra / Sistema operacional / Cliente e dependências.
- Resultados e correções: critérios de aceitação atendidos e trabalho manual pendente.
- Recursos e decisões: Serviços, tempo e custos utilizados, e razões para adoção ou adiamento.
06 / Candidatos reais: como escolher entre dois skills PDF com o mesmo nome?
Este site inclui os arquivos skills/pdf/SKILL.md de anthropics/skills e skills/.curated/pdf/SKILL.md de openai/skills. Ambos têm o nome PDF; o repositório e o caminho completo são registrados primeiro para evitar tratar entradas com o mesmo nome como o mesmo conjunto de instruções. A tabela abaixo compara os pontos principais das tarefas originais, mas não implica exclusão mútua de habilidades, nem usa o sistema de classificação por estrelas para determinar qual é mais precisa.
O documento da Anthropic fornece exemplos de várias técnicas de manipulação de PDFs, incluindo extração de texto e tabelas, manipulação de páginas, geração e OCR de documentos digitalizados, e direciona o processamento de formulários para o arquivo FORMS.md. O documento da OpenAI enfatiza a leitura, a criação e a revisão do layout, exigindo verificações após a renderização da página e novamente após atualizações significativas; a extração de texto é insuficiente para comprovar a correção do layout.
| Candidato e caminho completo | Principais pontos do texto original | A CODEZ recomenda verificar isso primeiro. | Ainda precisa ser verificado. |
|---|---|---|---|
| anthropics/skills / skills/pdf/SKILL.md | São fornecidos exemplos para cada operação: Extração, Processamento de Páginas, Geração e OCR. | Ao extrair tabelas ou processar documentos digitalizados, verifique primeiro as operações e dependências correspondentes. | Estrutura da tabela, idioma e precisão do OCR, disponibilidade de fontes citadas e ferramentas. |
| openai/skills / skills/.curated/pdf/SKILL.md | Crie, revise e verifique o layout através da renderização da página. | Quando for necessário um relatório legível, verifique primeiro o processo de renderização e inspeção. | Fontes, tabelas, números de página e paginação; se o texto pode ser exibido em um ambiente real. |
anthropics/skills: skills/pdf/SKILL.md (commit fixado) ↗
openai/skills: skills/.curated/pdf/SKILL.md (commit fixado) ↗
07 / Decomponha a "Extração bem-sucedida" em itens de aceitação verificáveis.
Esta é uma proposta de teste: compare candidatos com a mesma lista de inventário de duas páginas, sem dados sensíveis. Inclua o número de material 0017, nomes de colunas em chinês, uma descrição vazia, cabeçalho repetido na segunda página e uma célula mesclada. Confira manualmente o resultado esperado e guarde as páginas de origem e uma cópia do arquivo. Este teste não foi executado.
Antes de começar, verifique se a entrada permite a seleção de texto e tente uma pequena extração. As verificações de seleção e extração devem servir apenas como indícios: a presença de camadas de texto não garante a estrutura correta da tabela, e documentos digitalizados com texto OCR existente também podem conter erros. Quando o OCR for necessário, registre o idioma e as ferramentas do sistema; dependências ausentes devem ser registradas como problemas de ambiente.
- Registre o commit do candidato, cliente, modelo, versão das ferramentas e tipo de entrada. Evite confundir diferenças de ambiente com diferenças entre skills.
- Registre as linhas corrigidas manualmente e os respectivos motivos, o tempo de execução e os serviços efetivamente utilizados; os dados que não foram medidos devem ser deixados em branco.
- A conclusão correspondente só será aceita se todos os critérios de aceitação listados forem atendidos. Mesmo que uma amostra seja aprovada, sua entrada real ainda precisa ser verificada.
| Itens de Inspeção | Resultados a serem verificados | Como agir em caso de falha |
|---|---|---|
| Número do material | Preserve os zeros à esquerda de 0017; não o converta automaticamente em 17 | Após esclarecer os tipos de campo, extraia os dados novamente e verifique cada item. |
| Tabelas que atravessam páginas | O cabeçalho da segunda página não é contabilizado como dado, e nenhum registro é perdido ou duplicado. | Anote a numeração das páginas, verifique o número de linhas em cada página e, em seguida, mescle-as. |
| Caracteres chineses e valores nulos | Nomes de colunas legíveis e descrições vazias preservadas, sem preencher com suposições | Verifique a codificação e as posições dos campos e marque as posições que não podem ser recuperadas. |
| Mesclar células | Os valores de descrição correspondem aos registros corretos e as regras de divisão estão documentadas | Preserve a área de origem e defina manualmente as regras de correspondência |
| Formato do relatório de saída | O conteúdo renderizado não apresenta truncamento, sobreposição ou caracteres ausentes. | Corrija a fonte ou o layout e verifique a renderização mais recente. |
08 / Categorias, licenças e dependências são três verificações separadas
Conforme os originais, os dois skills PDF foram reclassificados de «Design» e «Desenvolvimento» para «Documentos», respectivamente. Suas entradas e saídas principais são PDF; Python e ferramentas de renderização são meios para a tarefa. A categoria ajuda a encontrar candidatos, mas não determina qual é mais adequado para extração ou revisão de layout.
Ambas as entradas possuem seus próprios arquivos LICENSE.txt no diretório, e este site mantém uma etiqueta "Arquivo de licença pendente de verificação". Por favor, leia as licenças originais de cada diretório; não presuma que elas sejam de uso livre simplesmente porque o repositório é público ou a organização à qual pertence é conhecida.
A lista de dependências também deve ser verificada para cada operação específica. A instalação de bibliotecas Python não garante a disponibilidade das ferramentas de renderização do sistema ou do ambiente OCR; este documento não comprova a compatibilidade com nenhum cliente. Anote quaisquer ferramentas ausentes, etapas não verificadas e limitações de uso em seu registro de decisões.
09 / Skill de Cloudflare: verificar primeiro a configuração e as credenciais
Em 2026-10-14, esta seção verificou o commit fixo de cloudflare/skills / skills/cf-cli/SKILL.md e a documentação oficial. São recomendações de seleção e teste da CODEZ; este Skill não foi executado.
cf não reutiliza o login de Wrangler. Verificar primeiro a conta e as permissões do token; registrar a versão da CLI, a configuração e os recursos de destino para não confundir diferenças de ambiente com diferenças do Skill.
| Cenário | Primeiro verifique | Observe durante o uso experimental. |
|---|---|---|
| Existe wrangler.jsonc, wrangler.json ou wrangler.toml, mas não cloudflare.config.ts | Manter primeiro o fluxo de Wrangler para dev, build e deploy; os comandos de projeto de cf não leem essa configuração existente. | Revisar primeiro os comandos e alterações de arquivos propostos pelo Skill; decidir separadamente sobre a migração da configuração. |
| cloudflare.config.ts já existe | Verificar dev, build e deploy conforme o fluxo de projeto de cf; a CLI está em beta e uma categoria não comprova compatibilidade. | Verificar Node.js 22.18 ou posterior e a conta de destino; inspecionar a saída de compilação e o Worker de destino em uma cópia de teste. |
cloudflare/skills / skills/cf-cli/SKILL.md ↗