skill-standardization
Padronizar e validar arquivos SKILL.md
Esta habilidade padroniza e valida arquivos SKILL.md de acordo com a especificação Agent Skills. Ajuda desenvolvedores de habilidades a criar definições compatíveis com frontmatter, descrições e estrutura adequados, garantindo acionamento confiável das habilidades e compatibilidade com o marketplace.
Скачать ZIP навыка
Загрузить в Claude
Перейдите в Settings → Capabilities → Skills → Upload skill
Включите и начните использовать
Протестировать
Использование «skill-standardization». Valide a habilidade em ./my-skill/SKILL.md
Ожидаемый результат:
Validando: ./my-skill/SKILL.md
✓ Campo obrigatório: name = 'my-skill'
✓ Campo obrigatório: description presente
✓ Comprimento da descrição: 256 chars (OK)
✓ Formato do nome: válido (alfanumérico minúsculo + hífens)
✓ Nome corresponde ao diretório: 'my-skill'
✓ Seção recomendada: When to use this skill
✓ Seção recomendada: Instructions
✓ Seção recomendada: Examples
✓ Comprimento do arquivo: 180 lines (OK)
Problemas: 0 errors, 0 warnings
Использование «skill-standardization». Criar SKILL.md para uma habilidade de fluxo de trabalho git
Ожидаемый результат:
---
name: git-workflow
description: >
Manage git workflows including committing changes, creating branches, and handling pull requests.
Use when the user needs to work with git repositories, even if they do not say 'git' explicitly.
Triggers on: commit changes, create branch, pull request, merge branches, git status.
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
tags: git, workflow, version-control
version: "1.0"
---
# Git Workflow
## When to use this skill
- Creating commits with appropriate messages
- Managing branches (create, switch, delete)
- Handling pull requests
Аудит безопасности
БезопасноSecurity analysis confirms this is a legitimate skill standardization tool. All 153 static findings are false positives: the 'weak cryptographic algorithm' patterns incorrectly flag 'name' field validation as crypto hashes; 'shell command substitution' refers to legitimate script validation logic; 'Ruby backtick execution' flags markdown code examples; 'hardcoded URLs' are documentation links. No malicious behavior, command injection, data exfiltration, or prompt injection detected.
Оценка качества
Что вы можете построить
Validar nova habilidade antes de publicar
Use antes de enviar uma nova habilidade ao marketplace para garantir que atenda a todos os requisitos da especificação Agent Skills e será acionada de forma confiável.
Auditar habilidades existentes para conformidade
Valide em lote todas as habilidades em um diretório para identificar e corrigir problemas de conformidade com a especificação em toda uma biblioteca de habilidades.
Converter formatos legados de habilidades
Migre formatos antigos de habilidades com cabeçalhos e frontmatter não padronizados para a especificação Agent Skills atual.
Попробуйте эти промпты
Valide meu arquivo SKILL.md em .agent-skills/my-new-skill/SKILL.md contra a especificação Agent Skills. Verifique todos os campos obrigatórios, formato do nome, comprimento da descrição e seções recomendadas.
Crie um novo SKILL.md para uma habilidade que manipula operações PDF incluindo extração, preenchimento de formulários e mesclagem. A habilidade deve ser acionada quando usuários precisarem trabalhar com arquivos PDF.
Minha descrição de habilidade é 'Ajuda com arquivos CSV.' Melhore-a para que a habilidade seja acionada de forma mais confiável em prompts relevantes, seguindo as melhores práticas Agent Skills.
Valide todas as habilidades no diretório .agent-skills e forneça um resumo mostrando quais habilidades têm erros, quais têm avisos e quais estão totalmente compatíveis.
Лучшие практики
- Foque primeiro na qualidade da descrição - descrições fracas impedem a ativação da habilidade
- Use fraseologia de acionamento imperativa como 'Use when...' para melhorar a confiabilidade do acionamento
- Adicione 2-5 casos de teste de avaliação (evals/evals.json) antes de publicar no marketplace
Избегать
- Usar descrições vagas como 'Ajuda com arquivos' que nunca acionam
- Omitir o bloco frontmatter ou colocá-lo após o conteúdo
- Usar sintaxe de lista YAML para allowed-tools em vez de strings delimitadas por espaço
Часто задаваемые вопросы
O que é a especificação Agent Skills?
Por que minha descrição de habilidade precisa de fraseologia imperativa?
Qual é o comprimento máximo da descrição?
Posso validar múltiplas habilidades de uma vez?
O que são evals e devo adicioná-los?
Quais ferramentas minha habilidade pode usar?
Сведения для разработчиков
Автор
supercent-ioЛицензия
MIT
Репозиторий
https://github.com/supercent-io/skills-template/tree/main/.agent-skills/skill-standardization/Ссылка
main
Структура файлов