Audit and improve skill collections with an 8-dimension scoring framework, duplication detection, remediation planning, and CI quality gates; use when evaluating skill quality, generating remediation plans, validating report format, or enforcing repository-wide skill artifact conventions.
Does it follow best practices?
Evaluation — 93%
↑ 1.33xAgent success when using this tile
Validation for skill structure
#!/usr/bin/env sh
# Check basic consistency across skill directories.
set -eu
SKILLS_DIR="${1:-skills}"
ISSUES=0
for skill_dir in "$SKILLS_DIR"/*; do
[ -d "$skill_dir" ] || continue
skill_name=$(basename "$skill_dir")
if [ ! -f "$skill_dir/SKILL.md" ]; then
echo "MISSING_SKILL: $skill_name/SKILL.md"
ISSUES=$((ISSUES + 1))
continue
fi
if ! grep -q '^---$' "$skill_dir/SKILL.md"; then
echo "NO_FRONTMATTER: $skill_name/SKILL.md"
ISSUES=$((ISSUES + 1))
fi
if [ -d "$skill_dir/scripts" ]; then
for script in "$skill_dir"/scripts/*.sh; do
[ -f "$script" ] || continue
first_line=$(sed -n '1p' "$script")
if [ "$first_line" != "#!/usr/bin/env sh" ]; then
echo "BAD_SHEBANG: $script"
ISSUES=$((ISSUES + 1))
fi
done
fi
done
echo "Consistency check complete: $ISSUES issue(s) found"
exit "$ISSUES"Install with Tessl CLI
npx tessl i pantheon-ai/skill-quality-auditor@0.1.4evals
scenario-1
scenario-2
scenario-3
scenario-4
scenario-5
references
scripts