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 gives AI coding agents direct, live access to this site's frontend testing documentation. It enables AI coding agents to quickly look up relevant testing patterns and techniques during development.

What It Does

The skill directory symlinks the live docs/ and docs-ja/ content directories from this repo, and its SKILL.md embeds only the top-level documentation categories -- a directory tree, not a per-article index. Article discovery happens at lookup time: Claude browses the symlinked directories and reads each .mdx file's frontmatter (title, description) to find the right article.

New articles are available immediately without re-running setup, since they live behind the same symlink. Re-run pnpm setup:doc-skill only after adding or renaming a top-level category, so the category list embedded in SKILL.md picks it up.

Installation

Run the setup script to generate the skill and symlink it -- along with this repo's other tracked skills (verify-ui, verify-ui-ai, headless-browser) -- into your global skills directory:

pnpm run setup:doc-skill

This creates the skill at .claude/skills/test-wisdom/, then symlinks every skill under .claude/skills/ to ~/.claude/skills/. It auto-detects your setup: if ~/.codex also exists, it links the Codex equivalents under ~/.codex/skills/ too (use --target claude, --target codex, or --target both to override). Pass --no-link-tracked-skills to skip the tracked skills and symlink only the generated test-wisdom skill.

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

6. Run pnpm build to verify the site builds correctly

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/.