bats-testing-patterns

I took a look at your bats-testing-patterns skill and wanted to share some thoughts.

Links:

• GitHub
• Your skill in the SkillzWave marketplace

The TL;DR

You're at 60/100, which puts you in D territory (needs work). This is based on Anthropic's best practices for skill design. Your strongest area is Spec Compliance (12/15) – the metadata and structure are solid. The real drag is Progressive Disclosure Architecture (12/30) – that's where you're leaving the most points on the table.

What's Working Well

• Solid triggers – "unit tests," "shell scripts," "TDD," and "CI/CD" clearly signal when to use this. That's good discoverability.
• Comprehensive pattern coverage – You're addressing a real gap here. Assertions, mocking, fixtures, and CI integration all deserve their place.
• Useful test_helper.sh template – That helper pattern is production-ready and shows someone actually built this, not just theorized about it.
• Good spec compliance – Your frontmatter is clean, hyphen-case naming is correct, and the structure follows the rules.

The Big One: Monolithic File Structure

Here's the thing: 631 lines in a single SKILL.md is killing your PDA score (and that's -10 points you're leaving on the table). When a file gets that long, it becomes a reference manual, not a skill guide. Developers have to scroll through installation details, basic patterns, and advanced CI integration all at once.

The fix is straightforward: Split this into a primary guide + reference files:

SKILL.md (100-150 lines) - Overview, quick start, when to use
references/
  ├── installation.md
  ├── assertion-patterns.md
  ├── mocking-and-stubs.md
  ├── fixtures.md
  └── ci-integration.md

This keeps your main file ...