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. 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 ### Step 1: Understanding the Skill with Concrete Examples
Skip this step only when the skill's usage patterns are already clearly understood. 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.