Skill Audit Report

ai-skill-audit audit https://github.com/alirezarezvani/claude-skills --llm --output html

Source: https://github.com/alirezarezvani/claude-skills

Summary

FileTypeNameGradeScoreIssues
SKILL.md skill "engineering-skills" C 72% 5
SKILL.md skill "c-level-advisor" C 70% 6
SKILL.md skill "finance-skills" C 66% 6
SKILL.md skill "pm-skills" C 65% 7
SKILL.md skill "ra-qm-skills" C 65% 7
SKILL.md skill "business-growth-skills" D 63% 7
SKILL.md skill "engineering-advanced-skills" D 63% 7
SKILL.md skill "product-skills" D 63% 7
SKILL.md skill "marketing-skills" D 63% 7
SKILL-AUTHORING-STANDARD.md skill Skill Authoring Standard D 60% 8

10 files analyzed — average score: 65%

Skill Authoring Standard

D
skill unknown Score: 60%
completeness 55% weight 20%
clarity 45% weight 15%
actionability 75% weight 20%
safety 5% weight 15%
testability 60% weight 10%
trust 100% weight 20%
Details & Suggestions

completeness (55%)

  • Rich runbook body (2197 words, 42 sections, 109 bullets)
  • Has 12 code block(s) in body (inline examples)
  • Body contains warning/caveat language
  • Runbook style (no formal inputs)
  • Add a description explaining what this skill does
  • Add a dedicated ## Examples section for discoverability
  • Extract warnings into a dedicated ## Gotchas section

clarity (45%)

  • Well-structured body (42 sections, 109 bullets)
  • Add a clear, concise description (20-200 characters ideal)
  • Replace vague words: things

actionability (75%)

  • Body contains actionable instructions (4 action items, 1 numbered)
  • Body references tools or includes code
  • No inputs defined (not always needed)

safety (5%)

  • Add gotchas/caveats to warn about common failure points
  • Add specific gotchas (describe what can go wrong and why)
  • Address what happens when things go wrong (errors, failures, retries)

testability (60%)

  • Body contains inline examples
  • Body code blocks serve as examples
  • Structured body describes expected behavior

trust (100%)

  • Contains 1 executable code block(s): python
  • [python] #!/usr/bin/env python3
  • Includes 9 companion script(s): codex-install.bat, codex-install.sh, convert.sh, gemini-install.sh, generate-docs.py, install.sh, openclaw-install.sh, sync-codex-skills.py, sync-gemini-skills.py
  • Contains 1 inline command(s):
  • $ python #!/usr/bin/env python3 """Tool description — what it does in one line."""...
  • Executable code found — no suspicious patterns detected

Needs work skill with 8 suggestions for improvement (weakest: safety)

"business-growth-skills"

D
skill claude-native Score: 63%
completeness 70% weight 20%
clarity 70% weight 15%
actionability 60% weight 20%
safety 5% weight 15%
testability 60% weight 10%
trust 100% weight 20%
Details & Suggestions

completeness (70%)

  • Has description
  • Rich runbook body (134 words, 6 sections, 2 bullets)
  • Has 3 code block(s) in body (inline examples)
  • Runbook style (no formal inputs)
  • Add a dedicated ## Examples section for discoverability
  • Add gotchas/caveats to warn about common failure points

clarity (70%)

  • Structured body (6 sections, 2 bullets)
  • Language is concrete and specific
  • Description is very long — consider trimming to under 200 characters

actionability (60%)

  • Body has some actionable content
  • Body references tools or includes code
  • No inputs defined (not always needed)
  • Add more action-oriented bullet points or numbered steps

safety (5%)

  • Add gotchas/caveats to warn about common failure points
  • Add specific gotchas (describe what can go wrong and why)
  • Address what happens when things go wrong (errors, failures, retries)

testability (60%)

  • Body contains inline examples
  • Body code blocks serve as examples
  • Structured body describes expected behavior

trust (100%)

  • Contains 2 executable code block(s): bash
  • [bash] npx agent-skills-cli add alirezarezvani/claude-skills/business-growth
  • [bash] python3 customer-success-manager/scripts/health_score_calculator.py --help
  • Includes 9 companion script(s): codex-install.bat, codex-install.sh, convert.sh, gemini-install.sh, generate-docs.py, install.sh, openclaw-install.sh, sync-codex-skills.py, sync-gemini-skills.py
  • Contains 2 inline command(s):
  • $ bash npx agent-skills-cli add alirezarezvani/claude-skills/business-growth
  • $ bash python3 customer-success-manager/scripts/health_score_calculator.py --help ...
  • Executable code found — no suspicious patterns detected

Needs work skill with 7 suggestions for improvement (weakest: safety)

"c-level-advisor"

C
skill claude-native Score: 70%
completeness 80% weight 20%
clarity 80% weight 15%
actionability 75% weight 20%
safety 5% weight 15%
testability 60% weight 10%
trust 100% weight 20%
Details & Suggestions

completeness (80%)

  • Has description
  • Rich runbook body (856 words, 15 sections, 27 bullets)
  • Has 6 code block(s) in body (inline examples)
  • Body contains warning/caveat language
  • Runbook style (no formal inputs)
  • Add a dedicated ## Examples section for discoverability
  • Extract warnings into a dedicated ## Gotchas section

clarity (80%)

  • Well-structured body (15 sections, 27 bullets)
  • Language is concrete and specific
  • Description is very long — consider trimming to under 200 characters

actionability (75%)

  • Body contains actionable instructions (0 action items, 3 numbered)
  • Body references tools or includes code
  • No inputs defined (not always needed)

safety (5%)

  • Add gotchas/caveats to warn about common failure points
  • Add specific gotchas (describe what can go wrong and why)
  • Address what happens when things go wrong (errors, failures, retries)

testability (60%)

  • Body contains inline examples
  • Body code blocks serve as examples
  • Structured body describes expected behavior

trust (100%)

  • Includes 9 companion script(s): codex-install.bat, codex-install.sh, convert.sh, gemini-install.sh, generate-docs.py, install.sh, openclaw-install.sh, sync-codex-skills.py, sync-gemini-skills.py
  • Executable code found — no suspicious patterns detected

Acceptable skill with 6 suggestions for improvement (weakest: safety)

"engineering-advanced-skills"

D
skill claude-native Score: 63%
completeness 70% weight 20%
clarity 70% weight 15%
actionability 60% weight 20%
safety 5% weight 15%
testability 60% weight 10%
trust 100% weight 20%
Details & Suggestions

completeness (70%)

  • Has description
  • Rich runbook body (330 words, 5 sections, 2 bullets)
  • Has 2 code block(s) in body (inline examples)
  • Runbook style (no formal inputs)
  • Add a dedicated ## Examples section for discoverability
  • Add gotchas/caveats to warn about common failure points

clarity (70%)

  • Structured body (5 sections, 2 bullets)
  • Language is concrete and specific
  • Description is very long — consider trimming to under 200 characters

actionability (60%)

  • Body has some actionable content
  • Body references tools or includes code
  • No inputs defined (not always needed)
  • Add more action-oriented bullet points or numbered steps

safety (5%)

  • Add gotchas/caveats to warn about common failure points
  • Add specific gotchas (describe what can go wrong and why)
  • Address what happens when things go wrong (errors, failures, retries)

testability (60%)

  • Body contains inline examples
  • Body code blocks serve as examples
  • Structured body describes expected behavior

trust (100%)

  • Contains 1 executable code block(s): bash
  • [bash] npx agent-skills-cli add alirezarezvani/claude-skills/engineering
  • Includes 9 companion script(s): codex-install.bat, codex-install.sh, convert.sh, gemini-install.sh, generate-docs.py, install.sh, openclaw-install.sh, sync-codex-skills.py, sync-gemini-skills.py
  • Contains 1 inline command(s):
  • $ bash npx agent-skills-cli add alirezarezvani/claude-skills/engineering
  • Executable code found — no suspicious patterns detected

Needs work skill with 7 suggestions for improvement (weakest: safety)

"engineering-skills"

C
skill claude-native Score: 72%
completeness 80% weight 20%
clarity 70% weight 15%
actionability 75% weight 20%
safety 30% weight 15%
testability 60% weight 10%
trust 100% weight 20%
Details & Suggestions

completeness (80%)

  • Has description
  • Rich runbook body (394 words, 9 sections, 3 bullets)
  • Has 3 code block(s) in body (inline examples)
  • Body contains warning/caveat language
  • Runbook style (no formal inputs)
  • Add a dedicated ## Examples section for discoverability
  • Extract warnings into a dedicated ## Gotchas section

clarity (70%)

  • Structured body (9 sections, 3 bullets)
  • Language is concrete and specific
  • Description is very long — consider trimming to under 200 characters

actionability (75%)

  • Body contains actionable instructions (3 action items, 0 numbered)
  • Body references tools or includes code
  • No inputs defined (not always needed)

safety (30%)

  • Mentions error handling concepts
  • Add gotchas/caveats to warn about common failure points
  • Add specific gotchas (describe what can go wrong and why)

testability (60%)

  • Body contains inline examples
  • Body code blocks serve as examples
  • Structured body describes expected behavior

trust (100%)

  • Contains 2 executable code block(s): bash
  • [bash] npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team
  • [bash] python3 <skill>/scripts/<tool>.py --help
  • Includes 9 companion script(s): codex-install.bat, codex-install.sh, convert.sh, gemini-install.sh, generate-docs.py, install.sh, openclaw-install.sh, sync-codex-skills.py, sync-gemini-skills.py
  • Contains 2 inline command(s):
  • $ bash npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team
  • $ bash python3 <skill>/scripts/<tool>.py --help
  • Executable code found — no suspicious patterns detected

Acceptable skill with 5 suggestions for improvement (weakest: safety)

"finance-skills"

C
skill claude-native Score: 66%
completeness 70% weight 20%
clarity 90% weight 15%
actionability 60% weight 20%
safety 5% weight 15%
testability 60% weight 10%
trust 100% weight 20%
Details & Suggestions

completeness (70%)

  • Has description
  • Rich runbook body (93 words, 6 sections, 2 bullets)
  • Has 3 code block(s) in body (inline examples)
  • Runbook style (no formal inputs)
  • Add a dedicated ## Examples section for discoverability
  • Add gotchas/caveats to warn about common failure points

clarity (90%)

  • Description length (193 chars) is ideal
  • Structured body (6 sections, 2 bullets)
  • Language is concrete and specific

actionability (60%)

  • Body has some actionable content
  • Body references tools or includes code
  • No inputs defined (not always needed)
  • Add more action-oriented bullet points or numbered steps

safety (5%)

  • Add gotchas/caveats to warn about common failure points
  • Add specific gotchas (describe what can go wrong and why)
  • Address what happens when things go wrong (errors, failures, retries)

testability (60%)

  • Body contains inline examples
  • Body code blocks serve as examples
  • Structured body describes expected behavior

trust (100%)

  • Contains 2 executable code block(s): bash
  • [bash] npx agent-skills-cli add alirezarezvani/claude-skills/finance
  • [bash] python3 financial-analyst/scripts/ratio_calculator.py --help
  • Includes 9 companion script(s): codex-install.bat, codex-install.sh, convert.sh, gemini-install.sh, generate-docs.py, install.sh, openclaw-install.sh, sync-codex-skills.py, sync-gemini-skills.py
  • Contains 2 inline command(s):
  • $ bash npx agent-skills-cli add alirezarezvani/claude-skills/finance
  • $ bash python3 financial-analyst/scripts/ratio_calculator.py --help python3 financ...
  • Executable code found — no suspicious patterns detected

Acceptable skill with 6 suggestions for improvement (weakest: safety)

"marketing-skills"

D
skill claude-native Score: 63%
completeness 70% weight 20%
clarity 80% weight 15%
actionability 50% weight 20%
safety 5% weight 15%
testability 60% weight 10%
trust 100% weight 20%
Details & Suggestions

completeness (70%)

  • Has description
  • Rich runbook body (483 words, 9 sections, 5 bullets)
  • Has 4 code block(s) in body (inline examples)
  • Runbook style (no formal inputs)
  • Add a dedicated ## Examples section for discoverability
  • Add gotchas/caveats to warn about common failure points

clarity (80%)

  • Well-structured body (9 sections, 5 bullets)
  • Language is concrete and specific
  • Description is very long — consider trimming to under 200 characters

actionability (50%)

  • Runbook body present
  • Body references tools or includes code
  • No inputs defined (not always needed)
  • Add action-oriented instructions (bullet points starting with verbs)

safety (5%)

  • Add gotchas/caveats to warn about common failure points
  • Add specific gotchas (describe what can go wrong and why)
  • Address what happens when things go wrong (errors, failures, retries)

testability (60%)

  • Body contains inline examples
  • Body code blocks serve as examples
  • Structured body describes expected behavior

trust (100%)

  • Contains 2 executable code block(s): bash
  • [bash] codex --full-auto "Read marketing-skill/marketing-ops/SKILL.md, then help me wri
  • [bash] # Content scoring
  • Includes 9 companion script(s): codex-install.bat, codex-install.sh, convert.sh, gemini-install.sh, generate-docs.py, install.sh, openclaw-install.sh, sync-codex-skills.py, sync-gemini-skills.py
  • Contains 2 inline command(s):
  • $ bash codex --full-auto "Read marketing-skill/marketing-ops/SKILL.md, then help m...
  • $ bash # Content scoring python3 marketing-skill/content-production/scripts/conten...
  • Executable code found — no suspicious patterns detected

Needs work skill with 7 suggestions for improvement (weakest: safety)

"product-skills"

D
skill claude-native Score: 63%
completeness 70% weight 20%
clarity 70% weight 15%
actionability 60% weight 20%
safety 5% weight 15%
testability 60% weight 10%
trust 100% weight 20%
Details & Suggestions

completeness (70%)

  • Has description
  • Rich runbook body (177 words, 6 sections, 2 bullets)
  • Has 3 code block(s) in body (inline examples)
  • Runbook style (no formal inputs)
  • Add a dedicated ## Examples section for discoverability
  • Add gotchas/caveats to warn about common failure points

clarity (70%)

  • Structured body (6 sections, 2 bullets)
  • Language is concrete and specific
  • Description is very long — consider trimming to under 200 characters

actionability (60%)

  • Body has some actionable content
  • Body references tools or includes code
  • No inputs defined (not always needed)
  • Add more action-oriented bullet points or numbered steps

safety (5%)

  • Add gotchas/caveats to warn about common failure points
  • Add specific gotchas (describe what can go wrong and why)
  • Address what happens when things go wrong (errors, failures, retries)

testability (60%)

  • Body contains inline examples
  • Body code blocks serve as examples
  • Structured body describes expected behavior

trust (100%)

  • Contains 2 executable code block(s): bash
  • [bash] npx agent-skills-cli add alirezarezvani/claude-skills/product-team
  • [bash] python3 product-manager-toolkit/scripts/rice_prioritizer.py --help
  • Includes 9 companion script(s): codex-install.bat, codex-install.sh, convert.sh, gemini-install.sh, generate-docs.py, install.sh, openclaw-install.sh, sync-codex-skills.py, sync-gemini-skills.py
  • Contains 2 inline command(s):
  • $ bash npx agent-skills-cli add alirezarezvani/claude-skills/product-team
  • $ bash python3 product-manager-toolkit/scripts/rice_prioritizer.py --help python3 ...
  • Executable code found — no suspicious patterns detected

Needs work skill with 7 suggestions for improvement (weakest: safety)

"pm-skills"

C
skill claude-native Score: 65%
completeness 80% weight 20%
clarity 70% weight 15%
actionability 60% weight 20%
safety 5% weight 15%
testability 60% weight 10%
trust 100% weight 20%
Details & Suggestions

completeness (80%)

  • Has description
  • Rich runbook body (151 words, 6 sections, 2 bullets)
  • Has 3 code block(s) in body (inline examples)
  • Body contains warning/caveat language
  • Runbook style (no formal inputs)
  • Add a dedicated ## Examples section for discoverability
  • Extract warnings into a dedicated ## Gotchas section

clarity (70%)

  • Structured body (6 sections, 2 bullets)
  • Language is concrete and specific
  • Description is very long — consider trimming to under 200 characters

actionability (60%)

  • Body has some actionable content
  • Body references tools or includes code
  • No inputs defined (not always needed)
  • Add more action-oriented bullet points or numbered steps

safety (5%)

  • Add gotchas/caveats to warn about common failure points
  • Add specific gotchas (describe what can go wrong and why)
  • Address what happens when things go wrong (errors, failures, retries)

testability (60%)

  • Body contains inline examples
  • Body code blocks serve as examples
  • Structured body describes expected behavior

trust (100%)

  • Contains 2 executable code block(s): bash
  • [bash] npx agent-skills-cli add alirezarezvani/claude-skills/project-management
  • [bash] python3 senior-pm/scripts/project_health_dashboard.py --help
  • Includes 9 companion script(s): codex-install.bat, codex-install.sh, convert.sh, gemini-install.sh, generate-docs.py, install.sh, openclaw-install.sh, sync-codex-skills.py, sync-gemini-skills.py
  • Contains 2 inline command(s):
  • $ bash npx agent-skills-cli add alirezarezvani/claude-skills/project-management
  • $ bash python3 senior-pm/scripts/project_health_dashboard.py --help python3 scrum-...
  • Executable code found — no suspicious patterns detected

Acceptable skill with 7 suggestions for improvement (weakest: safety)

"ra-qm-skills"

C
skill claude-native Score: 65%
completeness 80% weight 20%
clarity 70% weight 15%
actionability 60% weight 20%
safety 5% weight 15%
testability 60% weight 10%
trust 100% weight 20%
Details & Suggestions

completeness (80%)

  • Has description
  • Rich runbook body (223 words, 6 sections, 2 bullets)
  • Has 3 code block(s) in body (inline examples)
  • Body contains warning/caveat language
  • Runbook style (no formal inputs)
  • Add a dedicated ## Examples section for discoverability
  • Extract warnings into a dedicated ## Gotchas section

clarity (70%)

  • Structured body (6 sections, 2 bullets)
  • Language is concrete and specific
  • Description is very long — consider trimming to under 200 characters

actionability (60%)

  • Body has some actionable content
  • Body references tools or includes code
  • No inputs defined (not always needed)
  • Add more action-oriented bullet points or numbered steps

safety (5%)

  • Add gotchas/caveats to warn about common failure points
  • Add specific gotchas (describe what can go wrong and why)
  • Address what happens when things go wrong (errors, failures, retries)

testability (60%)

  • Body contains inline examples
  • Body code blocks serve as examples
  • Structured body describes expected behavior

trust (100%)

  • Contains 2 executable code block(s): bash
  • [bash] npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team
  • [bash] python3 risk-management-specialist/scripts/risk_matrix_calculator.py --help
  • Includes 9 companion script(s): codex-install.bat, codex-install.sh, convert.sh, gemini-install.sh, generate-docs.py, install.sh, openclaw-install.sh, sync-codex-skills.py, sync-gemini-skills.py
  • Contains 2 inline command(s):
  • $ bash npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team
  • $ bash python3 risk-management-specialist/scripts/risk_matrix_calculator.py --help...
  • Executable code found — no suspicious patterns detected

Acceptable skill with 7 suggestions for improvement (weakest: safety)