add note about afterEach skipped

Author: bahmutov

README.md

@@ -93,6 +93,22 @@ To get typings, reference this module, for example by using `reference` comment
 
 For more details read [Cypress Intelligent Completion Guide](https://on.cypress.io/intellisense)
 
+## Warning
+
+Skipping tests in Mocha at run-time skips the `afterEach` hooks. In this example, `afterEach` will be skipped, and `after` hook will run.
+
+```js
+it('example', () => {
+  cy.skipOn('mac')
+})
+afterEach(() => {
+  // this will be skipped when a test is skipped
+})
+after(() => {
+  // this will run even after skipping test
+})
+```
+
 ## Authors
 
 - Kevin Old

cypress/integration/after-spec.js

@@ -0,0 +1,19 @@
+/// <reference path="../../index.d.ts" />
+// @ts-check
+it('runs after hooks after skipping?', () => {
+  cy.skipOn('mac')
+})
+
+it('does not skip this test', () => {})
+
+afterEach(() => {
+  // this will be skipped when a test is skipped
+  cy.log('in afterEach')
+  console.log('in afterEach for', cy)
+})
+
+after(() => {
+  // this will run after skipping test
+  cy.log('in after')
+  console.log('in after')
+})