skill-regressionlisted
Install: claude install-skill Songhonglei/build-better-skills
# Skill Regression
- **Version**: 1.0.3
- **License**: MIT
- **Author**: Evan Song · [github.com/Songhonglei](https://github.com/Songhonglei)
- **Repository**: https://github.com/Songhonglei/build-better-skills/tree/main/skills/skill-regression
- **Part of**: [`build-better-skills`](https://github.com/Songhonglei/build-better-skills) suite — see [Stages](https://github.com/Songhonglei/build-better-skills#stages) for the lifecycle map.
## What it does
Given a target skill directory, this skill:
1. Normalizes test file naming (TEST.md is canonical; legacy Test.md/TESTS.md auto-renamed)
2. Loads or LLM-generates structured test cases
3. Runs script-layer assertions (subprocess + regex/contains/exact)
4. Runs AI-layer semantic scoring (LLM-as-judge, configurable threshold)
5. Outputs a Markdown report (with optional upload hook)
Two execution backends, auto-detected:
| Backend | When | What it tests |
|---------|------|---------------|
| `api` (default outside OpenClaw) | LLM API + system prompt | Whether SKILL.md is well-written enough for LLMs to follow correctly |
| `openclaw` (default inside OpenClaw) | Cron probe job → real agent → jsonl polling | End-to-end agent + skill integration |
## Quick start
```bash
# 1. First time: configure your LLM
python3 scripts/setup.py
# 2. Run regression on a skill
bash scripts/run_regression.sh /path/to/my-skill
# 3. Detailed mode (full input/output per case)
bash scripts/run_regression.sh /path/to/my-skill --detail
# 4. Re-run o