Skip to main content
skill CX Codex

mocha-skill — Claude Code skill: tests and installation

Creates Mocha tests for JavaScript and TypeScript with Chai assertions and Sinon mocks. Useful when a project needs unit-test scaffolding.

MIT 235 installs ★ 393 updated 2026-10-13

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add LambdaTest/agent-skills --skill mocha-skill -a claude-code
Open on GitHub

What mocha-skill does

This skill guides the agent in writing Mocha tests with describe and it, Chai assertions, and Sinon-based mocking. It covers regular and asynchronous cases, callback-style tests, lifecycle hooks, and sandbox cleanup so stubs do not remain active between tests.

The reference includes npx mocha, watch mode, npx mocha --grep "login", timeout configuration, and recursive runs. Project setup uses npm install mocha chai sinon --save-dev. Without these packages, the examples cannot run in the project.

What it helps with

  • generate unit tests for JavaScript and TypeScript
  • assert values and thrown errors with Chai
  • stub API calls through Sinon
  • cover Promise and callback-based flows
  • run Mocha with a grep filter or timeout

Example prompts for the agent

  • Create Mocha tests for this module using Chai assertions and Sinon mocks.
  • Add an async test for fetchData, then cover its callback form.
  • Run the suite with npx mocha --grep "login" and fix the failing tests.

How to install mocha-skill

1Skills CLI (Vercel)

npx skills add LambdaTest/agent-skills --skill mocha-skill -a claude-code

2Manually: put the files in place

~/.claude/skills/mocha-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mocha-skill/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about mocha-skill

How do I install mocha-skill in Claude Code?

Run npx skills add LambdaTest/agent-skills --skill mocha-skill -a claude-code, then check ~/.claude/skills/mocha-skill/SKILL.md.

What does mocha-skill do?

It helps generate Mocha tests for JavaScript and TypeScript with Chai assertions and Sinon mocks. The guidance also covers async tests and common Mocha commands.

Which dependencies does mocha-skill require?

Install mocha, chai, and sinon with npm install mocha chai sinon --save-dev before running the examples.

Source text

SKILL.md · MIT
---
name: mocha-skill
description: >
  Generates Mocha tests in JavaScript with Chai assertions and Sinon mocking.
  Use when user mentions "Mocha", "Chai", "sinon", "describe/it (not Jest)".
  Triggers on: "Mocha", "Chai", "sinon", "mocha test".
languages:
  - JavaScript
  - TypeScript
category: unit-testing
license: MIT
metadata:
  author: TestMu AI
  version: "1.0"
---

# Mocha Testing Skill

## Core Patterns

### Basic Test with Chai

```javascript
const { expect } = require('chai');

describe('Calculator', () => {
  let calc;
  beforeEach(() => { calc = new Calculator(); });

  it('should add two numbers', () => {
    expect(calc.add(2, 3)).to.equal(5);
  });

  it('should throw on divide by zero', () => {
    expect(() => calc.divide(10, 0)).to.throw('Division by zero');
  });
});
```

### Chai Assertions

```javascript
expect(value).to.equal(5);
expect(arr).to.have.lengthOf(3);
expect(obj).to.have.property('name');
expect(str).to.include('hello');
expect(fn).to.throw(Error);
expect(arr).to.deep.equal([1, 2, 3]);
expect(obj).to.deep.include({ name: 'Alice' });
```

### Sinon Mocking

```javascript
const sinon = require('sinon');

describe('UserService', () => {
  let sandbox;
  beforeEach(() => { sandbox = sinon.createSandbox(); });
  afterEach(() => { sandbox.restore(); });

  it('fetches user from API', async () => {
    const stub = sandbox.stub(api, 'get').resolves({ name: 'Alice' });
    const user = await userService.getUser(1);
    expect(user.name).to.equal('Alice');
    expect(stub.calledOnce).to.be.true;
  });
});
```

### Async Testing

```javascript
it('should fetch data', async () => {
  const data = await fetchData();
  expect(data).to.have.property('id');
});

it('callback style', (done) => {
  fetchData((err, data) => {
    expect(err).to.be.null;
    done();
  });
});
```

### Anti-Patterns

| Bad | Good | Why |
|-----|------|-----|
| Missing `done()` | Use async/await | Hanging tests |
| No sandbox | `sinon.createSandbox()` | Stubs leak |
| Arrow in `describe` | Regular function for `this.timeout()` | Context |

## Quick Reference

| Task | Command |
|------|---------|
| Run all | `npx mocha` |
| Watch | `npx mocha --watch` |
| Grep | `npx mocha --grep "login"` |
| Timeout | `npx mocha --timeout 10000` |
| Recursive | `npx mocha --recursive` |

## Setup: `npm install mocha chai sinon --save-dev`

## Deep Patterns → `reference/playbook.md`

| § | Section | Lines |
|---|---------|-------|
| 1 | Production Configuration | mocharc, NYC coverage, TypeScript |
| 2 | Testing with Chai + Sinon | Stubs, spies, assertions |
| 3 | Advanced Sinon Patterns | Fake timers, nock HTTP, sequential |
| 4 | Async Patterns | Promise, await, callback, events |
| 5 | Hooks & Test Organization | Lifecycle, nesting, grep tags |
| 6 | Custom Reporters & Plugins | Reporter class, root hooks |
| 7 | Express/API Testing | Supertest integration |
| 8 | CI/CD Integration | GitHub Actions, services |
| 9 | Debugging Quick-Reference | 10 common problems |
| 10 | Best Practices Checklist | 13 items |

© TestMu AI · MIT · LambdaTest/agent-skills

Similar skills

All skills for Testing and QA →

From the same set47

The whole set →
codeception-skill Generates PHP Codeception acceptance, functional, and unit tests using BDD actor workflows. Useful for web interface validation and browser automation. CX Codex +1 243installs flutter-testing-skill flutter-testing-skill generates widget tests, integration tests, and golden tests for Flutter in Dart. Runs locally or on real devices via TestMu AI cloud. CX Codex +1 242installs smartui-skill This skill prepares SmartUI visual regression tests for screenshot comparison. Use it to check pages and components across browsers and viewports. CX Codex +1 237installs jasmine-skill Generates test specs in Jasmine for JavaScript and TypeScript. Includes BDD patterns, spy and mock syntax, async support — the code editor writes describe, it, expect, and spy calls automatically. CX Codex +1 237installs unittest-skill Generates Python unittest tests with TestCase, setUp/tearDown, and assertion methods. Triggers when you mention unittest, TestCase, or self.assertEqual. CX Codex +1 235installs espresso-skill Generate Espresso UI tests for Android apps written in Kotlin or Java. Use the skill to exercise screen interactions and check what the interface displays afterward. CX Codex +1 234installs laravel-dusk-skill Generates E2E tests with Laravel Dusk. The agent writes PHP code with $browser->visit, form checks, and Page Objects. CX Codex +1 231installs test-framework-migration-skill test-framework-migration-skill converts E2E test scripts between Selenium, Playwright, Puppeteer, and Cypress. It rewrites selectors, assertions, and lifecycle methods automatically. CX Codex +1 229installs

Project sponsors

Companies that keep this analytics open