Навыки skill-standardization
📦

skill-standardization

Безопасно

Standardisieren und Validieren von SKILL.md-Dateien

Dieses Skill standardisiert und validiert SKILL.md-Dateien gegen die Agent Skills-Spezifikation. Es hilft Skill-Entwicklern, konforme Skill-Definitionen mit korrekter Frontmatter, Beschreibungen und Struktur zu erstellen und gewährleistet zuverlässiges Skill-Triggering und Marketplace-Kompatibilität.

Поддерживает: Claude Codex Code(CC)
🥉 73 Бронза
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «skill-standardization». Validate the skill at ./my-skill/SKILL.md

Ожидаемый результат:

Validating: ./my-skill/SKILL.md
✓ Required field: name = 'my-skill'
✓ Required field: description present
✓ Description length: 256 chars (OK)
✓ Name format: valid (lowercase alphanumeric + hyphens)
✓ Name matches directory: 'my-skill'
✓ Recommended section: When to use this skill
✓ Recommended section: Instructions
✓ Recommended section: Examples
✓ File length: 180 lines (OK)

Issues: 0 errors, 0 warnings

Использование «skill-standardization». Create SKILL.md for a git workflow skill

Ожидаемый результат:

---
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

Аудит безопасности

Безопасно
v1 • 3/18/2026

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.

4
Просканировано файлов
556
Проанализировано строк
0
находки
1
Всего аудитов
Проблем безопасности не найдено
Проверено: claude

Оценка качества

45
Архитектура
100
Сопровождаемость
87
Контент
33
Сообщество
100
Безопасность
91
Соответствие спецификации

Что вы можете построить

Neuen Skill vor der Veröffentlichung validieren

Verwenden Sie dies vor dem Einreichen eines neuen Skills im Marketplace, um sicherzustellen dass er alle Agent Skills-Spezifikationsanforderungen erfüllt und zuverlässig getriggert wird.

Bestehende Skills auf Konformität prüfen

Stapelvalidierung aller Skills in einem Verzeichnis um Spezifikationskonformitätsprobleme in einer Skill-Bibliothek zu identifizieren und zu beheben.

Legacy-Skill-Formate konvertieren

Migrieren Sie ältere Skill-Formate mit nicht standardmäßigen Überschriften und Frontmatter zur aktuellen Agent Skills-Spezifikation.

Попробуйте эти промпты

Einen einzelnen Skill validieren
Validieren Sie meine SKILL.md-Datei unter .agent-skills/my-new-skill/SKILL.md gegen die Agent Skills-Spezifikation. Prüfen Sie alle erforderlichen Felder, das Namensformat, die Beschreibungslänge und die empfohlenen Abschnitte.
Neue SKILL.md erstellen
Erstellen Sie eine neue SKILL.md für einen Skill der PDF-Operationen wie Extraktion, Formularausfüllung und Zusammenführen abwickelt. Der Skill sollte getriggert werden wenn Benutzer mit PDF-Dateien arbeiten müssen.
Skill-Beschreibung verbessern
Meine Skill-Beschreibung ist 'Hilft bei CSV-Dateien.' Verbessern Sie sie damit der Skill zuverlässiger bei relevanten Prompts getriggert wird, entsprechend den Agent Skills Best Practices.
Skill-Verzeichnis stapelweise validieren
Validieren Sie alle Skills im .agent-skills-Verzeichnis und geben Sie eine Zusammenfassung welche Skills Fehler, welche Warnungen und welche vollständig konform sind.

Лучшие практики

  • Konzentrieren Sie sich zuerst auf die Beschreibungsschwäche - schwache Beschreibungen verhindern die Skill-Aktivierung
  • Verwenden Sie imperativische Trigger-Phrasierungen wie 'Use when...' um die Triggering-Zuverlässigkeit zu verbessern
  • Fügen Sie 2-5 Evaluierungstestfälle (evals/evals.json) vor der Marketplace-Veröffentlichung hinzu

Избегать

  • Verwenden Sie vage Beschreibungen wie 'Hilft bei Dateien' die niemals triggern
  • Das Frontmatter-Block weglassen oder nach dem Inhalt platzieren
  • YAML-Listen-Syntax für allowed-tools anstelle von leerzeichen-getrennten Zeichenketten verwenden

Часто задаваемые вопросы

Was ist die Agent Skills-Spezifikation?
Die Agent Skills-Spezifikation (agentskills.io) definiert das Standardformat für Skill-Definitionen in Claude Code und kompatiblen Agents. Sie umfasst Frontmatter-Felder, Verzeichnisstrukturen und Dokumentationsabschnitte.
Warum benötigt meine Skill-Beschreibung imperativische Phrasierung?
Die Beschreibung bestimmt wann Ihr Skill getriggert wird. Imperativische Phrasierungen wie 'Use when...' helfen der KI zuverlässig Benutzer-Intents mit Skills abzugleichen. Schwache Beschreibungen führen dazu dass Skills niemals aktiviert werden.
Was ist die maximale Beschreibungslänge?
Das Beschreibungsfeld muss zwischen 1 und 1024 Zeichen lang sein. Halten Sie es prägnant aber fügen Sie Trigger-Schlüsselwörter und Synonyme hinzu um die Aktivierung zuverlässiger zu machen.
Kann ich mehrere Skills gleichzeitig validieren?
Ja. Führen Sie 'bash scripts/validate_skill.sh --all .agent-skills/' aus um alle Skills in einem Verzeichnis stapelweise zu validieren. Der Script meldet Fehler und Warnungen pro Skill mit einer Zusammenfassung.
Was sind Evals und sollte ich sie hinzufügen?
Evals sind Evaluierungstestfälle in evals/evals.json die überprüfen ob Ihr Skill korrekt getriggert wird. Das Hinzufügen von 2-5 Testfällen wird vor der Veröffentlichung empfohlen um zuverlässiges Verhalten sicherzustellen.
Welche Tools kann mein Skill verwenden?
Skills können erlaubte Tools in der Frontmatter mit dem Feld allowed-tools deklarieren. Gängige Tools umfassen Bash, Read, Write, Edit, Glob und Grep. Nur vorab genehmigte Tools funktionieren mit Claude Code.

Сведения для разработчиков

Автор

supercent-io

Лицензия

MIT

Ссылка

main

Структура файлов