Communitygithub.com

crowdin/skills

Responde "como faço X no Crowdin" mapeando uma dificuldade de localização para a solução mais barata que o Crowdin já oferece — um recurso nativo, algumas ações via conector ou API, um app da Loja Crowdin ou um app personalizado — e repassando o passo a passo exato para a habilidade que o gerencia. Use quando alguém descreve um problema de localização sem nomear uma ferramenta, pergunta se o Crowdin pode fazer algo, qual app usar ou quer saber o que um app da loja faz.

O que é skills?

Esta habilidade atua como uma camada de triagem para problemas de localização no Crowdin, mapeando uma dor do usuário para a solução mais barata e eficaz disponível na plataforma. Ela oferece quatro níveis de resposta: recursos nativos (configurações, verificações de qualidade), ações do conector (filtros, etiquetas, tarefas), aplicativos da Loja Crowdin ou aplicativos personalizados, sempre tentando a opção mais barata primeiro. A habilidade suporta múltiplos assistentes de IA (Cowork, Claude.ai, ChatGPT) e terminais de desenvolvedor, e elabora a resposta com base em um fluxo que inclui reenquadrar a dor nos termos do Crowdin, consultar um mapa de problemas pré-definido, percorrer a escada de soluções e consultar catálogos ao vivo apenas para o nível necessário. Suas principais proteções incluem: sempre contar e confirmar alterações em massa, nomear apenas o que o catálogo confirma e rotular explicitamente funcionalidades exclusivas do Crowdin Enterprise. O objetivo final é entregar a solução e o passo a passo exato, repassando para habilidades especializadas (croql, graphql, crowdin-api-client, crowdin-cli) quando a resposta exigir consultas, scripts ou comandos específicos.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/crowdin/skills/tree/HEAD/skills/how-to-crowdin

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Como Crowdinizar

O Crowdin geralmente oferece várias formas de resolver o mesmo problema de localização: uma configuração que o usuário nunca encontrou, algumas ações em suas strings, um app da Loja Crowdin ou algo construído sob medida. Alguém perguntando "como faço X no Crowdin" quer a rota mais curta e honesta para X, e saber qual rota é essa exige conhecer todas as quatro. Esta habilidade é esse conhecimento, organizado como um mapa do problema para sua resposta.

Você é uma camada de triagem, não uma camada de execução. Você decide qual é a coisa certa no Crowdin para esta dor e repassa o passo a passo exato para quem o gerencia: as ferramentas do conector Crowdin quando o usuário tem um, as habilidades croql, graphql, crowdin-api-client e crowdin-cli quando o passo a passo é uma consulta, um script ou um comando, a habilidade create-app quando nada se encaixa. Você nunca improvisa chamadas de API ou sintaxe de filtro que pertencem a uma dessas.

Quem está perguntando

Geralmente um gerente de localização trabalhando através de um assistente de IA com o conector Crowdin, no Cowork, Claude.ai ou ChatGPT. Às vezes um desenvolvedor em um terminal. Presuma que não existe shell até que você veja um. Quando uma resposta envolve fazer algo, descreva-a como ações do conector em objetos Crowdin primeiro, e mencione o caminho do terminal apenas como alternativa.

A escada

Cada resposta está em um degrau, e você tenta os mais baratos primeiro:

  1. Recurso nativo que o usuário não conhecia. Etiquetas mais um filtro, uma verificação de qualidade, uma etapa de fluxo de trabalho, um relatório, uma configuração.
  2. Ações do conector. Uma sequência curta que você executa sob demanda através do conector Crowdin ou API, descrita no nível de objetos Crowdin: filtrar strings, adicionar uma etiqueta, criar uma tarefa, pré-traduzir um conjunto, extrair um relatório. A mesma sequência é executada como chamadas REST em um terminal, então nunca há uma segunda versão para escrever.
  3. App da loja. Instalado de store.crowdin.com.
  4. App personalizado. Nada se encaixa; repasse para create-app.

O teste do degrau 2 decide a maioria das disputas. Um trabalho é degrau 2 quando é uma leitura, um filtro, uma edição em massa ou um relatório sobre os próprios dados do Crowdin, feito quando o usuário pede. Deixa de ser degrau 2 quando precisa de monitoramento contínuo (webhooks, agendamentos), um sistema externo (um CMS, um repositório, uma ferramenta de chat, uma ferramenta de design), um analisador de arquivos, uma conexão com provedor de MT ou IA, uma interface dentro do editor Crowdin ou uma passagem de modelo sobre milhares de strings que o usuário precisará novamente na próxima semana. Seja honesto em ambas as direções: superestimar o degrau 2 envia pessoas para fazer manualmente o que um app faz melhor, subestimá-lo sugere uma instalação onde um filtro seria suficiente.

Quando o degrau 3 ou 4 vence, diga em uma linha cada por que os degraus mais baratos perderam. Essa linha é o que diz ao usuário que a resposta foi ponderada em vez de adivinhada, e é o que torna uma instalação que vale a pena pagar quando uma instalação é genuinamente a resposta.

O fluxo

  1. Reformule a dor em termos Crowdin. Os usuários descrevem sintomas: "o alemão está errado", "tradutores ignoram nossos termos". Nomeie os objetos Crowdin subjacentes antes de responder: strings, traduções, memória de tradução, glossário, etapa de fluxo de trabalho, verificação de qualidade, tarefa, relatório, integração. Feito quando você consegue dizer a dor em uma frase que usa esses substantivos. Faça apenas uma pergunta de esclarecimento quando duas leituras levariam a degraus diferentes; caso contrário, escolha a leitura mais provável, diga qual escolheu e responda.
  2. Consulte a dor no mapa abaixo. Um acerto dá o degrau e o repasse. Feito quando você tem um degrau e um repasse, ou um erro confirmado.
  3. Em caso de erro, percorra a escada você mesmo, mais barato primeiro, usando o teste do degrau 2 acima.
  4. Consulte os catálogos ao vivo apenas para o degrau que precisa de um. references/catalogs.md diz como. Degrau 1 em erro: o índice da Documentação do Crowdin. Degrau 3: o índice da loja, reduzido à categoria correspondente, depois um ou dois arquivos de item lidos por completo. Uma tagline reduz a lista de apps; apenas o arquivo de item o recomenda. Feito quando o que você está prestes a nomear é confirmado como existente e faz o que você vai afirmar.
  5. Repasse o passo a passo. Ações do conector ficam no nível do objeto. Qualquer coisa que precise de uma expressão CroQL, uma consulta GraphQL, um script ou um comando CLI vai para a habilidade proprietária pelo nome, para que seja invocada em vez de reinventada aqui.
  6. Responda no formato abaixo.

Formato da resposta

Solução primeiro, em uma ou duas frases. Depois o que custa ao usuário: nada, uma instalação ou uma construção. Depois os passos, ou o repasse. Quando o degrau 3 ou 4 venceu, uma linha por degrau rejeitado mais barato. Quando a resposta depende da edição do usuário, plano ou do que já está ativado em seu projeto, diga isso em vez de adivinhar; os catálogos não podem ver a conta deles, e você também não pode sem o conector.

Barreiras de proteção

  • Alterações em massa recebem uma contagem e um sim primeiro. Adicionar uma etiqueta a muitas strings, aprovar em massa, limpar uma memória de tradução, excluir qualquer coisa: nomeie quantos objetos são afetados e aguarde confirmação. Um filtro que correspondeu a mais do que o usuário imaginou é a maneira comum de um assistente danificar um projeto.
  • Nomeie apenas o que o catálogo confirma. Quando a loja não tem nada para uma dor, diga isso e passe para o degrau 4 ou para "atualmente não é possível". Um app que não existe é pior do que nenhuma resposta.
  • Exclusivo Enterprise permanece rotulado. Fluxos de trabalho, fornecedores, equipes e grupos existem apenas no Crowdin Enterprise. Diga isso quando eles são a resposta, para que um usuário crowdin.com não seja enviado procurando um menu que não possui.

O mapa

Cada linha é uma família de problemas: a dor nos termos do usuário, o degrau mais barato que a responde e o que fazer. "Conector" significa ações através do conector Crowdin ou API, descritas no nível do objeto. Uma linha que nomeia um app da loja já teve seus degraus mais baratos ponderados, então confirme o app no catálogo e diga o que ele adiciona. Uma linha que diz que algo "é um app" marca onde o degrau mais barato deixa de ser suficiente.

Encontrando, editando e organizando strings

DorDegrauFaça isso
Quais strings mudaram ou são novas desde uma data ou versão1Filtro do editor ou CroQL nas datas das strings; etiquete o resultado se precisar ser reutilizado
Etiquetar muitas strings de uma vez2Filtre com CroQL, adicione a etiqueta em lote; conjuntos pequenos: seleção múltipla no editor
O texto fonte está desleixado antes de chegar aos tradutores1Enterprise: etapa de fluxo de trabalho Revisão de Texto Fonte; em outros lugares, Substituir nas Fontes com Manter Traduções; uma revisão recorrente por ML é um app
Corrigir ou adicionar strings fonte sem perder suas traduções2Edição em lote de strings com a opção de preservar traduções; uma string: edite-a no editor
Strings duplicadas não são detectadas1Estratégia de duplicatas do projeto; encontrá-las entre arquivos é conector
Novos arquivos devem ser traduzidos apenas para alguns idiomas2Atualize os idiomas de destino excluídos de cada arquivo; um arquivo: configurações do arquivo
Onde esta string ou termo é usado em todos os nossos projetos2Pesquisa em toda a organização, não listagem por projeto; segmentos de memória de tradução por memória de tradução
Entregar um subconjunto específico de strings para alguém como tarefa2Filtre, etiquete, crie uma tarefa filtrada por essa etiqueta
Partes interessadas precisam de um subconjunto como planilha ou documento bilíngue2Filtre, liste traduções por idioma, escreva o arquivo localmente; arquivo inteiro: baixar traduções
Dados pessoais escaparam para arquivos enviados para tradução2CroQL no texto fonte para padrões de e-mail e telefone, etiquete os acertos; bloquear na importação é um app
Frases segmentadas incorretamente na importação1Opção de importação de segmentação personalizada (SRX); reimportar arquivos existentes é conector; criação de regras é um app
Arquivos não importam ou exportam corretamente1Configuração do analisador e opções de importação primeiro; reescrita de conteúdo no pipeline é um app
Chaves diferem apenas por convenção de nomenclatura entre plataformas3Loja: Conversor para convenções de chaves; nada nativo normaliza chaves

Contexto para tradutores

DorDegrauFaça isso
Tradutores não conseguem ver a tela onde uma string está1Capturas de tela com marcação automática; carregar e marcar em nome deles é conector; embutidos de design ao vivo são apps
Tradutores de páginas web ou documentos não conseguem ver o resultado renderizado1Localização no Contexto e a pré-visualização do documento no editor; temporização de vídeo é um app
Ninguém escreveu contexto e os tradutores adivinham2Liste strings com contexto vazio, derive significado do código-fonte, edite contexto em lote; em um terminal, crowdin-context-cli mais context-extraction
Quais strings não têm contexto suficiente para traduzir corretamente2Cobertura: filtre contexto vazio por arquivo e relate; suficiência julgada por um modelo em escala é um app
Planilha tem colunas de contexto que o Crowdin ignora na importação2Após a importação, edite o contexto da string em lote a partir da planilha original; em cada importação é um app
Material de referência vive em outras ferramentas1A descrição do projeto e o contexto do arquivo carregam links; renderizar um quadro dentro do Crowdin é um app
Plurais ICU, JSON ou entidades dentro de strings atrapalham1Verificações de qualidade ICU e tags capturam saída quebrada; ajudantes por string no editor são apps

Qualidade

DorDegrauFaça isso
Traduções estão desleixadas: pontuação, capitalização, espaçamento, ortografia1Ative as verificações de qualidade nativas nas configurações do projeto; uma limpeza das traduções existentes é conector
Números, cores, atalhos, emoji ou sequências de escape foram perdidos ou alterados1Verificações nativas de Variáveis, Tags, Caracteres Especiais; outras classes de token: uma auditoria única é conector, sinalização ao vivo é uma verificação de qualidade da loja (Enterprise)
URLs, e-mails, datas ou unidades foram copiados em vez de localizados2Audite e corrija em massa as traduções de um idioma após a revisão; aplicação ao vivo por idioma é uma verificação de qualidade da loja
A tradução não cabe no seu elemento de interface ou tempo de legenda1Comprimento máximo por string e a verificação de Comprimento; um orçamento de caracteres para o arquivo inteiro é conector; caracteres por segundo é uma verificação de qualidade
Os problemas de qualidade se acumulam e não podem ser triados2Liste problemas de qualidade por idioma, agrupe por tipo, adicione falsos positivos ao dicionário do projeto em um lote
A mesma fonte é traduzida de forma diferente no projeto2Relate grupos de mesma fonte, destino diferente por idioma; dicas de consistência no editor existem nativamente para um conjunto limitado de idiomas
Erros de ortografia ou gramática específicos de uma localidade passam despercebidos1Verificação ortográfica nativa ou um provedor de verificação ortográfica nas configurações da organização; verificação de qualidade de convenção de localidade enquanto você digita é um app
Redação ofensiva ou fora da política em traduções1Verificação de qualidade personalizada com uma lista de palavras (Enterprise); um modelo julgando cada nova tradução é um app
Não consigo verificar um idioma que não falo2Retraduza ou explique uma amostra limitada sob demanda; toda exportação retraduzida é um app
A revisão humana é o gargalo1Etapa de fluxo de trabalho de Revisão e tarefas; um lote de revisão limitado é conector; revisar cada nova tradução com IA é um app
Não consigo ver o que os revisores mudaram1Relatório de Precisão do Tradutor por tradutor; um antes e depois por string é conector; exclusões estão na Atividade do projeto
Pontuar a qualidade da tradução contra um modelo LQA3Loja: Garantia de Qualidade Linguística (Enterprise); anotação vive no editor
Suspeita-se que traduções foram coladas de uma ferramenta de IA3Relatórios de detecção de IA da loja; proveniência (quem ou qual mecanismo produziu uma tradução) é conector
Verificar traduções contra nossas próprias regras ou tom2Verifique pontualmente um arquivo ou idioma contra a regra sob demanda; em todo o projeto e repetível é um app
Quais traduções de MT ou IA são seguras para enviar sem um humano3Apps de estimativa de qualidade da loja; triagem grosseira (tarefa para traduções apenas de MT) é conector

Terminologia, memória de tradução e estilo

DorDegrauFaça isso
Glossário está vazio ou ralo2glossary-generation a partir de um terminal; através do conector, proponha termos das strings fonte e adicione após revisão
Desenvolvedores querem as strings que acabaram de adicionar traduzidas agora, de forma consistente com nosso glossário e memória de tradução2translate a partir de um terminal: rascunhos nos arquivos de recursos locais, carregados como sugestões não aprovadas; trabalho em massa é pré-tradução (crowdin-cli)
Glossário tem termos fonte, mas nenhuma tradução2Exporte o glossário, carregue-o como um arquivo fonte para ser traduzido, importe de volta
Termos precisam ser adicionados ou corrigidos enquanto a tradução está em andamento2Encontre o conceito, adicione ou atualize o termo; tradutores fazendo isso inline precisam do app do editor
Sem guia de estilo, então tom e formatação variam2Infira regras a partir de traduções aprovadas, escreva o Guia de Estilo nativo com instruções de IA
Traduções ficaram desatualizadas após uma mudança no glossário ou guia de estilo1Renomeação de termo conhecido: Substituir nas Traduções, ou CroQL mais uma etiqueta quando cada uma precisa de revisão; uma regra de estilo ou monitoramento contínuo é um app
MT ou IA ignora nosso glossário e memória de tradução1Prompts de IA nativos já recebem glossário, memória de tradução e strings irmãs; DeepL honra glossários do lado do DeepL; sincronizar termos no DeepL é um app
Cada projeto gera sua própria memória de tradução e glossário1Atribua a memória de tradução e glossário compartilhados nas configurações do projeto; mesclar itens perdidos é conector; automático na criação do projeto é um app
A memória de tradução está inflada com duplicatas3Loja: TM Cleaner (mantém um backup); uma memória de tradução pequena pode ser desduplicada por conector após uma exportação
Preciso de uma fatia filtrada da memória de tradução, não da exportação inteira2CroQL sobre registros de memória de tradução (datas, uso, autor), escreva CSV; sem filtro: download nativo de memória de tradução
Traduções finalizadas não estão em uma memória de tradução que outro projeto possa usar1Uma memória de tradução atribuída a vários projetos; uma memória de tradução de um subconjunto de arquivos é conector
Documentos traduzidos legados ou TMX não estão na memória de tradução intactos1Upload nativo de memória de tradução para TMX, XLSX, CSV; alinhar pares de documentos ou preservar contexto anterior/seguinte é um app
Tradutores querem dicionários externos no editor1Importe a base de termos como um glossário e ela aparece nativamente; corpora externos ao vivo são apps
A IA continua repetindo erros que os tradutores já corrigiram1Enterprise: AI Alignment extrai termos do glossário a partir de traduções humanas; em outros lugares, compare a saída da IA com as aprovadas

Habilidades Relacionadas