firefrost-gaming/claude-code-skills-reference
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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>
This commit is contained in:
daymade
2026-03-16 21:13:27 +08:00
parent 042c837db6
commit 6c30b5644b
2 changed files with 125 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
skill-creator/SKILL.md
View File

@@ -631,6 +631,14 @@ Take `best_description` from the JSON output and update the skill's SKILL.md fro
When creating or updating a skill, follow these steps in order. Skip steps only when clearly not applicable.
### Step 0: Prerequisites Check
Before starting any skill work, auto-detect all dependencies and proactively install anything missing. Discovering a missing tool mid-workflow (e.g., gitleaks at packaging time, PyYAML at validation) wastes time and breaks flow.
Run the quick check from [references/prerequisites.md](references/prerequisites.md), auto-install what you can, and present the user a summary checklist. Only proceed when all blocking dependencies are satisfied.
Key blockers: Python 3, PyYAML (validation/packaging), gitleaks (security scan), claude CLI (evals). All scripts must be invoked via `python3 -m scripts.<name>` from the skill-creator root directory — direct `python3 scripts/<name>.py` fails due to relative imports.
### Step 1: Understanding the Skill with Concrete Examples
Skip this step only when the skill's usage patterns are already clearly understood.

117
skill-creator/references/prerequisites.md Normal file
View File

@@ -0,0 +1,117 @@
# 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.