Novo framework ensina agentes a reproduzir o jeito de trabalhar de cada pessoa

Da escrita ao conjunto de regras

Karl Koch transformou anotações sobre interfaces, HTML, comportamento e avaliação de rascunhos de IA em uma coleção instalável de habilidades para agentes. A proposta é converter anos de critérios pessoais em gatilhos, regras, exemplos e verificações que o agente possa descobrir, carregar conforme a necessidade e aplicar sem que o usuário precise repetir todo o contexto em cada conversa.

A coleção kemiljk/skills reúne onze habilidades em um único repositório com licença MIT. Duas já existiam como repositórios independentes - fluid-design e modern-css-html - e mantêm seus nomes públicos, mas ganharam versões consolidadas com arquivos ativados menores, exemplos movidos para referências, listas de revisão mais claras e uma regra explícita de precedência entre preferências de movimento e CSS nativo. As demais codificam critérios recorrentes nas revisões de Koch: priorizar HTML semântico, tornar as ações perceptíveis em diferentes formas de entrada, decidir em prosa antes de partir para pixels ou código, conectar intenção de design à implementação, privilegiar antecipação e confiabilidade, remover elementos sem finalidade demonstrável, tratar saídas geradas como rascunhos e preparar protótipos para casos de borda reais. A décima primeira habilidade, dxe, coordena as outras dez, sem impor uma estética própria.

Revisão completa com dxe

O autor afirma que a composição manual das habilidades não funcionava em sua rotina: ele acionava uma lente estreita e esquecia as demais até que um problema chegasse à produção. dxe foi criado para executar uma revisão de conjunto sobre todo o espaço de trabalho ou sobre um caminho específico. O comando lê cada arquivo SKILL.md e interrompe a execução se algum estiver ausente; por isso, a instalação global de todas as habilidades é apresentada como pré-requisito.

O resultado é um único relatório, em vez de dez opiniões separadas. Ele contém uma hipótese sobre o que a revisão pretende melhorar, descobertas organizadas por gravidade e vinculadas à habilidade que as identificou, cortes feitos pela abordagem de subtração e o trabalho restante em ordem de prioridade. dxe review produz apenas achados; dxe fix acrescenta correções de alta confiança; e o comando também pode limitar a análise a um diretório ou componente.

Ordem de aplicação e uso

A composição segue cinco etapas: intenção, com write-first-design e subtractive-design; plataforma, com HTML semântico e CSS moderno; sensação, com movimento, affordances e encantamento de produto; ponte, que relaciona estrutura de design e código; e publicação, com julgamento da saída de IA e endurecimento do protótipo. Se preferências de movimento entrarem em conflito com a pureza do CSS, fluid-design define o comportamento desejado e modern-css-html escolhe a implementação mais nativa possível. JavaScript só deve ser usado quando CSS não conseguir expressar interrupção, velocidade ou continuidade de gestos.

A instalação completa pode ser feita globalmente com npx skills add kemiljk/skills -g --all, embora instalações seletivas continuem disponíveis para projetos compartilhados. Também é possível direcionar as habilidades a agentes específicos. Koch recomenda criar uma coleção pessoal quando os mesmos comentários se repetem em rascunhos de IA, prompts e arquivos de instrução. Ensaios continuam explicando histórias e razões; as habilidades transformam esse conhecimento em restrições executáveis, permitindo compartilhar critérios sem exigir que colaboradores leiam todo o arquivo de origem.