# Skill Audit Report

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

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

## Summary

File | Type | Name | Grade | Score | Issues
--- | --- | --- | --- | --- | ---
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)