firefrost-gaming/claude-code-skills-reference

Files

daymade 6c30b5644b feat(skill-creator): add Step 0 prerequisites check with auto-install

Adds dependency detection before skill creation starts, preventing
mid-workflow failures (e.g., gitleaks missing at packaging, PyYAML
missing at validation). Documents correct script invocation via
python3 -m syntax and auto-installation commands.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-16 21:13:27 +08:00

3.7 KiB

Raw Blame History

Skill Creator Prerequisites

Auto-detect and install all dependencies before starting skill creation. This prevents failures mid-workflow (e.g., discovering gitleaks is missing only at the packaging step).

Quick Check Script

Run all checks in one go:

echo "=== Skill Creator Prerequisites ==="
echo -n "Python 3: "; python3 --version 2>/dev/null || echo "MISSING"
echo -n "PyYAML: "; python3 -c "import yaml; print('OK')" 2>/dev/null || echo "MISSING"
echo -n "gitleaks: "; gitleaks version 2>/dev/null || echo "MISSING"
echo -n "claude CLI: "; which claude 2>/dev/null || echo "MISSING"
echo -n "anthropic SDK: "; python3 -c "import anthropic; print('OK')" 2>/dev/null || echo "MISSING (optional)"
echo -n "uv: "; uv --version 2>/dev/null || echo "MISSING (optional)"

Dependencies by Phase

Dependency	Required For	Phase	Severity
Python 3.7+	All scripts	All	Blocking
PyYAML	`quick_validate.py`, `package_skill.py`	Validation, Packaging	Blocking
gitleaks	`security_scan.py`	Security Review (Step 6)	Blocking for packaging
claude CLI	`run_eval.py`, `run_loop.py`	Testing, Description Optimization	Blocking for evals
anthropic SDK	`improve_description.py`, `run_loop.py`	Description Optimization	Optional (only for desc optimization)
uv	Skills that bundle Python scripts	Export/Runtime	Optional (skill-specific)
webbrowser	`generate_review.py` (viewer)	Eval Review	Optional (can use `--static` fallback)

Auto-Installation

PyYAML (required)

# Preferred: via uv
uv pip install --system pyyaml

# Alternative: via pip
pip3 install pyyaml

# Verify
python3 -c "import yaml; print(yaml.__version__)"

gitleaks (required for packaging)

# macOS
brew install gitleaks

# Linux
wget https://github.com/gitleaks/gitleaks/releases/download/v8.21.2/gitleaks_8.21.2_linux_x64.tar.gz
tar -xzf gitleaks_8.21.2_linux_x64.tar.gz && sudo mv gitleaks /usr/local/bin/

# Verify
gitleaks version

anthropic SDK (optional, for description optimization)

# Preferred: via uv
uv pip install --system anthropic

# Alternative: via pip
pip3 install anthropic

# Verify
python3 -c "import anthropic; print('OK')"

Also requires ANTHROPIC_API_KEY environment variable to be set.

claude CLI (required for evals)

The claude CLI (Claude Code) must be installed and available in PATH. If the user is already running this skill inside Claude Code, this is already satisfied.

# Verify
which claude && claude --version

If missing, the user needs to install Claude Code from https://claude.ai/claude-code.

Script Invocation

All scripts must be run from the skill-creator root directory using module syntax:

# CORRECT — run from skill-creator directory
cd <skill-creator-path>
python3 -m scripts.package_skill <skill-path>
python3 -m scripts.security_scan <skill-path>
python3 -m scripts.aggregate_benchmark <workspace-path> --skill-name <name>

# WRONG — direct invocation fails with ModuleNotFoundError
python3 scripts/package_skill.py <skill-path>  # ImportError: No module named 'scripts'

This is because the scripts use relative imports (from scripts.quick_validate import ...).

Presenting Results to User

After running all checks, present a summary table:

Skill Creator Prerequisites:
  [x] Python 3.12.0
  [x] PyYAML 6.0.1
  [x] gitleaks 8.21.2
  [x] claude CLI (running inside Claude Code)
  [ ] anthropic SDK — not installed (only needed for description optimization)
  [x] uv 0.6.x

If any blocking dependency is missing and auto-install fails, clearly explain what the user needs to do and stop before proceeding to skill creation.

3.7 KiB Raw Blame History