Agent Skills — Pacote de Produtividade em Inglês
4 das 5 habilidades neste repositório estão listadas no OpenAgentSkill; exemplo: git-commit-message
Uma pequena coleção de habilidades para agentes voltadas a tarefas cotidianas de trabalho intelectual: revisão de documentos técnicos, escrita de mensagens de commit, transformação de anotações de reunião em atas, revisão de código e estruturação de pesquisa aprofundada. Gratuito para usar, sem necessidade de cadastro.
Usuários de chinês: Também disponível o "Agent Skills 中文实战包" v1 (5 skills em chinês + guia de instalação em chinês + 3 casos práticos em chinês), a partir de ¥9,90 com compra única → Compre no Afdian. A versão original em inglês deste repositório é永久 gratuita (MIT).
Skills
| Skill | O que faz |
|---|---|
tech-writing-proofread | Revisa textos técnicos em inglês — erros de digitação, gramática, pontuação, consistência terminológica, jargão, estrutura — e retorna uma checklist itemizada de Original → Sugestão → Motivo sem reescrever o documento. |
git-commit-message | Gera mensagens de commit no formato conventional-commit a partir de alterações em staging: prefixo de tipo + assunto imperativo (≤50 caracteres) + corpo opcional explicando o porquê. |
meeting-notes | Transforma anotações brutas de reunião em atas estruturadas: conclusão primeiro, depois decisões / itens de ação / perguntas em aberto; todo item de ação recebe um responsável e um prazo. |
code-review-checklist | Revisão de código em cinco eixos (corretude, segurança, legibilidade, desempenho, cobertura de testes) com comentários acionáveis, sem críticas de estilo. |
deep-research-framework | Framework para relatórios de pesquisa aprofundada: defina a pergunta, hierarquize fontes, faça verificação cruzada e escreva relatórios com conclusão primeiro e declarações explícitas de incerteza. |
Veja em ação
Anotações brutas para dentro, atas estruturadas para fora — exemplo prático da skill meeting-notes (texto completo em skills/meeting-notes/SKILL.md; toda skill vem com um exemplo mínimo como este):
Entrada: "...James disse que a página de login está muito lenta, Maria sugeriu adicionar uma camada de cache, todos concordaram que vale um piloto; elabore a proposta até a próxima quarta-feira; estratégia de preços ainda em aberto, convide o Financeiro da próxima vez..."
Saída — Conclusão principal: Implementar um piloto de camada de cache para acelerar a página de login; estratégia de preços indefinida, pendente de reunião com o Financeiro. Decisões: adotar uma camada de cache para desempenho da página de login (primeiro piloto, não implementação completa). Itens de ação: Maria — elaborar a proposta de cache, prazo: próxima quarta-feira
[data a confirmar];[não atribuído]— agendar discussão de preços com Financeiro[horário a definir]. Perguntas em aberto: estratégia de preços — nenhuma decisão tomada; o responsável pelo item de ação agendará uma reunião dedicada com o Financeiro.
Observe o que a skill se recusa a fazer: ela não inventa a data do calendário para "próxima quarta-feira" nem adivinha um responsável que as anotações nunca nomearam — detalhes ausentes são marcados, nunca fabricados.
Como usar
Cada skill está em skills/<nome>/SKILL.md. O arquivo SKILL.md começa com um campo name e um description — a descrição é escrita para que frameworks de agentes possam identificar a skill quando uma solicitação correspondente chegar.
Para usar uma skill, diga ao seu agente o que você deseja fazer (por exemplo, "reveja este README" ou "transforme estas anotações em atas") e aponte para o SKILL.md correspondente, caso ele não seja selecionado automaticamente. O agente então seguirá o fluxo de trabalho descrito.
Segurança: nada para executar
Um estudo de 31.132 habilidades de agente publicadas descobriu que 26,1% continham pelo menos uma vulnerabilidade de segurança — e habilidades que incluíam scripts executáveis tinham 2,12× mais probabilidade de serem vulneráveis do que aquelas apenas com instruções (cobertura).
Este pacote é baseado apenas em instruções por design:
- Cada skill é um único
SKILL.md— Markdown simples, sem scripts, binários ou dependências. - As cinco skills juntas têm 283 linhas. Você pode ler cada palavra antes de instalar.
- Nenhuma skill mexe em credenciais, rede ou seus arquivos por conta própria; ela apenas diz ao seu agente como estruturar uma tarefa.
Instalar via SkillMD
Todas as cinco skills estão listadas no SkillMD. Instale qualquer uma pelo nome:
npx skillmds@latest add alapha888/git-commit-message
npx skillmds@latest add alapha888/code-review-checklist
npx skillmds@latest add alapha888/meeting-notes
npx skillmds@latest add alapha888/deep-research-framework
npx skillmds@latest add alapha888/tech-writing-proofread
Princípios de design
- Listas de verificação, não ensaios. Cada skill é um fluxo de trabalho que o agente pode executar passo a passo, com um exemplo mínimo executável.
- Revise, não reescreva. A skill de revisão aponta defeitos e sugere correções; ela nunca reescreve sua voz.
- Sem fabricação. As skills de atas de reunião e pesquisa recusam-se a inventar nomes, datas ou fontes — informações faltantes são marcadas, nunca adivinhadas.
- Acionável em vez de exaustivo. A revisão de código é limitada a 10 comentários; uma revisão cheia de trivialidades é pior do que uma curta que encontra o verdadeiro bug.
Licença
MIT. Use, faça fork, adapte — atribuição é apreciada, mas não obrigatória.
Desenvolvimento de habilidades personalizadas
Aceito encomendas de habilidades personalizadas / fluxos de trabalho de IA: uma skill sob medida para o fluxo de trabalho recorrente da sua equipe (a partir de ¥499), ou uma automação leve / construção de landing page (a partir de ¥999). Entre em contato via DM no Afdian. Após combinarmos o escopo, o depósito de 30% é feito através deste link do Afdian (faixas ¥150 / ¥299).
Agent Skills Pro
Precisa de fluxos de trabalho avançados? Agent Skills Pro (US$39, compra única) adiciona três skills pagas — multi-agent-decompose, codebase-map e release-notes — para coordenar agentes paralelos, integrar-se a repositórios desconhecidos e gerar notas de versão legíveis. O pacote gratuito acima permanece gratuito.