zudo-test-wisdom

Type to search...

to open search from anywhere

test-wisdom Skill

A Claude Code skill that indexes frontend testing documentation articles for AI-assisted development.

The test-wisdom skill is a Claude Code skill that indexes all frontend testing documentation articles in this site. It enables AI coding agents to quickly look up relevant testing patterns and techniques during development.

What It Does

The skill maintains a documentation index that maps testing concepts to their articles. When invoked, it finds and reads the relevant article, then applies the recommended patterns.

The documentation index is generated from all MDX articles under src/content/docs/ and src/content/docs-ja/ (for Japanese). Each .mdx file has YAML frontmatter with title and description fields that help identify the right article to read.

Installation

Run the setup script to create the skill and symlink it to your global Claude Code skills directory:

pnpm run setup:doc-skill

This creates the skill at .claude/skills/test-wisdom/ and symlinks it to ~/.claude/skills/test-wisdom.

Usage

Lookup Mode (default)

In any Claude Code session, invoke the skill with a topic keyword:

/test-wisdom vitest patterns
/test-wisdom playwright e2e
/test-wisdom testing level escalation

The skill will find the relevant article(s) from the documentation, read them, and apply the testing patterns when writing code.

Update Mode (-u / --update)

When you have new information about testing and want to add or update documentation in this repo, use the -u flag:

/test-wisdom -u vitest
/test-wisdom --update playwright patterns

In update mode, the skill guides Claude to:

  1. Ask what you learned or want to document
  2. Search existing docs to find related articles
  3. Create a new .mdx file or update an existing one
  4. Update the corresponding Japanese translation under docs-ja/
  5. Run pnpm format:md to format the new/changed files

Skill Structure

.claude/skills/test-wisdom/
  SKILL.md         # Generated skill definition
  docs/            # Symlink to src/content/docs/
  docs-ja/         # Symlink to src/content/docs-ja/

The SKILL.md file is generated by the setup script. It contains the skill metadata and instructions for how Claude Code should use the documentation.

How It Works

When you invoke /test-wisdom <topic>, Claude Code:

  1. Finds the relevant article(s) from the docs/ directory based on the topic
  2. Reads only the specific article(s) needed — it does not load all articles at once
  3. Applies the information from the article when answering your question
  4. Mentions the source article path so you can find it for further reading

Japanese documentation is available under docs-ja/. When working in Japanese or asking for Japanese content, the skill prefers articles from docs-ja/.

Revision History