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
npx skills add LambdaTest/agent-skills --skill mocha-skill -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/mocha-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mocha-skill/
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill mocha-skill -a codex2Manually: put the files in place
.agents/skills/mocha-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill mocha-skill -a cursor2Manually: put the files in place
.cursor/skills/mocha-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install LambdaTest/agent-skills mocha-skill2Manually: put the files in place
.github/skills/mocha-skill/SKILL.md1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill mocha-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/LambdaTest/agent-skills --path mocha-skillManually: put the files in place
.devin/skills/mocha-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill mocha-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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