SKILL 91 · AGENT SKILL
Analytical Method Validation: critérios antes dos dados
Organiza validação, verificação e transferência de procedimentos analíticos por framework, critérios prévios, estatística reproduzível e revisão qualificada.
FONTE PRIMÁRIA
Confira o projeto original.
A imagem é uma ilustração editorial exclusiva. A origem, a licença e as permissões devem ser conferidas no repositório oficial antes da instalação.
Abrir repositório original ↗
O QUE ESTA SKILL VERIFICA
O que ela coloca na mesa.
DETALHES DA SKILL
Como esta skill funciona na prática.
Entenda a função, o melhor cenário de uso e o resultado que você deve revisar antes de incluir esta skill no seu fluxo de trabalho.
Quando ela é útil
Planejamento, avaliação e documentação de validação, verificação, transferência e comparação de procedimentos analíticos sob ICH Q2(R2), Q14, M10 e marcos aplicáveis.
O que ela faz
Organiza validação, verificação e transferência de procedimentos analíticos por framework, critérios prévios, estatística reproduzível e revisão qualificada.
O que você deve receber
Relatório rastreável com framework, critérios definidos antes dos dados, cálculos, ressalvas e pontos que permanecem sob decisão de analistas, qualidade e autoridades competentes.
Onde pode ser usada
Hosts compatíveis com Agent Skills. Os scripts oficiais exigem Python 3.11 ou superior e usam somente a biblioteca padrão, mas precisam de revisão e validação no ambiente da organização.
O ZIP é textual. O uso completo pode ler dados laboratoriais, executar análises e gerar documentos com impacto regulatório. Use dados sintéticos no primeiro teste, restrinja permissões e mantenha decisões com profissionais autorizados.
ANÁLISE EDITORIAL
Validar um método analítico não é pedir a uma IA que examine uma planilha e declare que o ensaio funciona. É definir antes qual norma governa, qual é o uso pretendido, quais características precisam ser estudadas e quais critérios serão aceitos. A Analytical Method Validation organiza esse trabalho para procedimentos como HPLC, LC-MS/MS, GC, eletroforese capilar, ICP-MS, dissolução, qNMR, qPCR, NIR e ensaios de ligação ou baseados em células.
A curadoria do Bastidores da IA fixou a Skill no commit 844f4a35ccaa6a1a6ebeae4ddf0f56901b2f769e do repositório K-Dense-AI/scientific-agent-skills. Em 20 de agosto de 2026, o projeto registrava exatamente 33.999 estrelas no GitHub. O SKILL.md auditado declarava versão 1.0, compatibilidade com Python 3.11 ou superior e licença MIT.
Ilustração editorial exclusiva: a capa representa medições passando por critérios e revisão humana. Não é fotografia, captura de tela, laudo, certificado, interface real ou prova de que um método foi validado.
O que esta Skill faz de verdade
A Skill ajuda a planejar estudos, estruturar protocolos, avaliar dados e montar documentação para validação, verificação, transferência e comparação de procedimentos analíticos. O primeiro passo obrigatório é escolher o marco correto. Ela separa ICH Q2(R2) e Q14 para procedimentos de controle de qualidade, ICH M10 para métodos bioanalíticos, capítulos USP, documentos CLSI e ISO/IEC 17025.
Essa separação é central. O ICH Q2(R2) orienta a seleção e avaliação das características de validação para procedimentos incluídos em pedidos de registro. O ICH Q14 trata do desenvolvimento e do ciclo de vida do procedimento. Já o ICH M10 traz recomendações específicas para medição bioanalítica em amostras de estudos. Misturar esses contextos pode gerar um protocolo aparentemente completo, mas inadequado ao uso pretendido.
A Skill também inclui scripts de referência para planejar o estudo, avaliar resposta, precisão, exatidão, limites de detecção e quantificação, checar corridas bioanalíticas e comparar métodos. O pacote local do Bastidores não redistribui esses scripts. Ele preserva apenas a instrução principal, a licença e o registro de origem.
Para quem serve
Ela é útil para analistas, estatísticos, equipes de desenvolvimento analítico, controle de qualidade, garantia da qualidade e pesquisadores que precisam preparar ou revisar evidências. Também pode ajudar profissionais de dados a reconhecer quando uma análise estatística simples não responde à pergunta regulatória ou laboratorial.
Não é uma ferramenta para decidir liberação de lote, encerrar investigação de resultado fora de especificação, conceder acreditação, emitir certificado ou substituir responsável técnico. O próprio mantenedor limita a Skill a planejamento, cálculo e organização documental. A decisão final permanece com analista qualificado, revisor técnico, unidade de qualidade, direção do laboratório e autoridade aplicável.
Para leitores fora de laboratório, o maior valor está na disciplina: critérios antes dos dados, rastreabilidade da fonte, distinção entre repetibilidade e precisão intermediária, confirmação dos limites e separação entre diferença estatística e equivalência. O guia Como decidir quando uma saída de IA precisa de revisão humana complementa essa leitura com uma matriz editorial de risco.
Compatibilidade e pré-requisitos
O núcleo funciona em hosts compatíveis com Agent Skills e pode ser lido sem executar nada. Para usar os scripts oficiais, o requisito declarado é Python 3.11 ou superior. Segundo o SKILL.md, os cálculos usam somente a biblioteca padrão, sem NumPy, SciPy ou acesso de rede. Essa característica reduz dependências, mas não elimina a obrigação de revisar o código e testar os resultados no ambiente real.
Antes do primeiro uso, tenha o procedimento, o uso pretendido, a especificação, o intervalo reportável e o marco regulatório ou laboratorial aplicável. Quando o trabalho depender de USP, CLSI ou ISO, obtenha cópia autorizada. A Skill alerta que esses documentos são protegidos e não devem ser reconstruídos por um agente. A página pública do ISO/IEC 17025 explica o papel geral da norma, mas não substitui o texto licenciado.
Instalação recomendada
Comece pelo recorte documental local. Leia SKILL.md e ORIGEM.md, confira a versão e compare o commit com o repositório oficial. Se decidir testar a Skill completa, instale somente a pasta skills/analytical-method-validation do commit fixado, em um projeto controlado. O repositório documenta o padrão npx skills add K-Dense-AI/scientific-agent-skills, mas instalar a coleção inteira amplia contexto e superfície de execução. Prefira um subconjunto.
Depois de instalar, inventarie assets, references e scripts. Leia cada script antes de executá-lo, confirme os argumentos, formatos de entrada, códigos de saída e destino dos arquivos. Não use dados regulados, pessoais ou de produção no primeiro teste. Uma planilha sintética pequena é suficiente para verificar parsing, arredondamento, mensagens de erro e estrutura do relatório.
Configuração antes do primeiro uso
Registre por escrito qual framework governa. Para Q2(R2), identifique se o atributo é teor, impureza quantitativa, teste limite ou identidade. Para M10, declare se o método é cromatográfico ou ensaio de ligação, pois os critérios não são iguais. Para USP, CLSI ou ISO, cite a edição e a cópia autorizada usada pela organização.
Defina os critérios de aceitação antes de olhar os resultados. A Skill destaca que Q2(R2) não fornece uma tabela universal de números para todos os casos. Os limites precisam vir de especificações, perfil analítico alvo, desenvolvimento e justificativa científica. O índice oficial de diretrizes de qualidade do ICH reúne Q2 e Q14. Não copie números de um exemplo para outro método sem demonstrar pertinência.
Prepare também um dicionário das colunas, unidades, grupos, níveis e réplicas. Preserve dados brutos e registre qualquer exclusão. Se a análise usar um critério informado na linha de comando, grave esse comando junto do resultado. Sem essa trilha, um arquivo de saída pode parecer reproduzível enquanto esconde uma margem escolhida depois dos dados.
Primeiro uso seguro
O primeiro exercício deve ser educacional e sintético. Escolha um conjunto de calibração com cinco níveis e réplicas. Registre o modelo esperado, o intervalo e o limite de erro antes de executar. Compare o coeficiente de determinação com os resíduos, a falta de ajuste e o erro retrocalculado. O objetivo é entender por que um valor alto de r², isoladamente, não demonstra linearidade ou adequação.
- Fixe framework, finalidade, atributo medido e versão da Skill.
- Escreva critérios e justificativas antes de carregar os dados.
- Use dados sintéticos, identificados como exemplo.
- Execute um único script e preserve entrada, comando, saída e mensagens.
- Refaça pelo cálculo ou software estatístico validado da organização.
- Peça revisão a alguém que não escolheu os critérios.
Não transforme o primeiro resultado em modelo aprovado. Divergências podem surgir de unidades, arredondamento, agrupamento, desenho experimental, distribuição adotada ou interpretação do framework. O teste seguro termina com perguntas documentadas, não com uma assinatura simulada.
Resultado esperado
Uma boa saída identifica o marco aplicado, a pergunta respondida, os dados usados, os parâmetros, o cálculo, as ressalvas e o que ainda exige decisão humana. Para precisão, deve separar variação dentro e entre grupos quando o desenho permitir. Para limites, deve nomear a abordagem e mostrar confirmação próxima do limite. Para transferência, deve declarar a margem de equivalência antes do teste.
O relatório esperado não usa a linguagem “método validado” apenas porque um script terminou com código zero. Ele apresenta achados que podem sustentar uma revisão. A conclusão formal depende do protocolo aprovado, dos registros originais, de investigações abertas, do sistema de qualidade e das assinaturas exigidas.
Permissões e riscos
O pacote documental do Bastidores não executa código. A Skill completa pede leitura, escrita, edição e shell, permissões capazes de acessar dados locais e produzir arquivos. Restrinja o diretório, use cópias e negue acesso a compartilhamentos, instrumentos, LIMS, ELN e sistemas regulados no teste inicial.
O risco principal não é somente técnico. Uma análise correta pode ser aplicada ao framework errado. Um limite de aceitação pode ser copiado sem justificativa. Um resultado sintético pode ser confundido com dado real. Um agente pode resumir indevidamente material protegido. Mantenha identificação visível de rascunho, fonte por afirmação e revisão independente.
Há ainda risco de privacidade e integridade. Dados bioanalíticos podem estar ligados a estudos, participantes e decisões regulatórias. Não envie conjuntos sensíveis a serviços externos sem base legal, contrato, controle de acesso e avaliação da organização. A ausência de rede nos scripts auditados não impede que o agente hospedeiro ou outros componentes transmitam conteúdo.
Erros comuns
Usar Q2(R1) como estrutura atual. A Skill registra que Q2(R2) reorganizou características e se conecta ao ciclo de vida de Q14. Confirme o documento final vigente no índice oficial do ICH.
Escolher critérios depois dos dados. Documente os limites e a justificativa no protocolo. Se houver mudança, preserve a versão anterior e explique por que o estudo precisa ser replanejado.
Tratar r² como prova. Examine resíduos, erro retrocalculado, falta de ajuste, faixa e heterocedasticidade. A correlação pode crescer com a amplitude sem eliminar curvatura relevante.
Confundir repetibilidade com precisão intermediária. Variação entre dias, analistas ou instrumentos pode dominar a rotina mesmo quando as réplicas no mesmo grupo parecem excelentes.
Concluir equivalência porque p é maior que 0,05. Falhar em detectar diferença não prova equivalência. A margem deve ser definida antes e o teste precisa responder a essa hipótese.
Reproduzir norma protegida. Para USP, CLSI e ISO, use a cópia autorizada. Não peça à IA para inventar limiares ausentes ou reconstruir trechos pagos.
Versão auditada e download local
O recorte foi preparado a partir da versão 1.0 no commit 844f4a35ccaa6a1a6ebeae4ddf0f56901b2f769e. A licença individual declarada no frontmatter é MIT e o arquivo LICENSE.md do repositório também usa MIT.
O ZIP local tem 8.383 bytes e somente três arquivos textuais: SKILL.md, LICENSE.md e ORIGEM.md. SHA-256: fff981f5e0ab67645ce8285b7840f86ad7738cee78768565445ac3daad794d43. Scripts, referências, modelos, dados, dependências e credenciais ficaram fora. O botão de download local serve para auditoria. O repositório oficial permanece uma ação separada para quem precisar da distribuição completa.
Resultado esperado e limite final
A Skill é valiosa quando torna o raciocínio verificável: marco correto, critérios prévios, desenho compatível, cálculo reproduzível e limites explícitos. Ela falha quando vira atalho para um parecer que o código não pode emitir.
Use os cálculos como uma segunda lente, não como fonte única. Compare com software e procedimentos aprovados, preserve dados e parâmetros, trate cada divergência como objeto de investigação e mantenha a decisão com profissionais autorizados. Em trabalho regulado, a rastreabilidade do processo importa tanto quanto o número final.
Fontes primárias
CONFIGURAÇÃO
Instale só depois de ler.
Abra a fonte oficial, leia README e licença, fixe uma versão ou commit e só então siga o método indicado pelo mantenedor. Não execute comandos copiados de comentários ou vídeos sem revisão.
npx skills add K-Dense-AI/scientific-agent-skills --skill analytical-method-validationInstale somente a Skill em projeto controlado. O ZIP local é documental e não inclui scripts. Revise o código oficial, use dados sintéticos no primeiro teste e mantenha decisões reguladas com profissionais autorizados.
Abra a fonte e o README
- Confira mantenedor e nome do repositório.
- Leia licença, requisitos e permissões.
- Escolha uma versão ou commit para aprovar.
Comece em um projeto de teste
- Use o comando acima ou o método do README.
- Prefira instalação por projeto antes da global.
- Não copie tokens, chaves ou arquivos sensíveis.
Faça um teste pequeno
- Confirme a descrição e os arquivos instalados.
- Execute uma tarefa reversível.
- Registre versão aprovada e remova o que não usar.