Improve docblocks

Couple of docblock and linting fixes.
Is `limit` more common than `skip`? I wonder if we should swap these.