6c30b5644b
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>
118 lines
3.7 KiB
Markdown
118 lines
3.7 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
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)
|
|
|
|
```bash
|
|
# 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)
|
|
|
|
```bash
|
|
# 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)
|
|
|
|
```bash
|
|
# 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.
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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.
|