Include skipped tests in runner return value

Before: %{failures: 0, total: 3}
After:  %{failures: 0, skipped: 1, total: 3}

Does *not* alter the counting of 'total', which
(still) doesn't include skipped tests. Added docs
to clarify this.