Skill Audit Report
ai-skill-audit audit https://github.com/alirezarezvani/claude-skills --llm --output html
Source: https://github.com/alirezarezvani/claude-skills
Summary
10 files analyzed — average score: 65%
completeness
55%
weight 20%
actionability
75%
weight 20%
testability
60%
weight 10%
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)
completeness
70%
weight 20%
actionability
60%
weight 20%
testability
60%
weight 10%
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)
completeness
80%
weight 20%
actionability
75%
weight 20%
testability
60%
weight 10%
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)
completeness
70%
weight 20%
actionability
60%
weight 20%
testability
60%
weight 10%
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)
completeness
80%
weight 20%
actionability
75%
weight 20%
testability
60%
weight 10%
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)
completeness
70%
weight 20%
actionability
60%
weight 20%
testability
60%
weight 10%
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)
completeness
70%
weight 20%
actionability
50%
weight 20%
testability
60%
weight 10%
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)
completeness
70%
weight 20%
actionability
60%
weight 20%
testability
60%
weight 10%
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)
completeness
80%
weight 20%
actionability
60%
weight 20%
testability
60%
weight 10%
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)
completeness
80%
weight 20%
actionability
60%
weight 20%
testability
60%
weight 10%
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)