Can I use CSS selectors with this skill?

Yes. While text-based location is preferred to match documentation language, you can use selectors when elements lack visible text or when there are multiple identical labels on a page.

Why is validation mandatory before returning a spec?

Doc Detective requires a specific JSON structure where the action name is the key. Mandatory validation ensures the generated spec is structurally sound and ready for execution before it reaches the user.

How does Doc Detective differ from Playwright?

While Playwright is a general-purpose automation framework, Doc Detective is optimized for documentation testing, focusing on text-based matching and simpler JSON structures that mirror user-facing instructions.

What types of actions can I test with this skill?

Supported actions include navigating to URLs (goTo), clicking elements (click), finding text (find), typing, running shell commands, checking links, and making HTTP requests.

Does this skill support injecting tests into my source files?

Yes, if the test spec is generated from a local file, the skill can preview and apply inline test comments directly to your markdown source for easier future execution.

Doc Detective Testing

Name: Doc Detective Testing
Author: doc-detective

bydoc-detective

•

セキュリティとテスト

Verifies documentation procedures by converting them into executable Doc Detective test specifications and validating them automatically.

Doc Detective Testing is a specialized skill designed to ensure your documentation remains accurate and functional. It transforms written tutorials, how-tos, and getting-started guides into executable test specifications, allowing Claude to verify UI workflows directly from your documentation content. By prioritizing text-based element location and enforcing a strict validation gate, it provides a robust alternative to manual testing or complex automation frameworks for documentation-centric projects. It even supports inline test injection, seamlessly bridging the gap between static content and live verification.

主な機能

01Converts natural language documentation into executable JSON test specifications

026 GitHub stars

03Text-based element matching to align test steps with documentation terminology

04Automated execution of browser workflows, API calls, and shell commands

05Inline test injection to embed executable steps directly into source markdown files

06Mandatory structural validation to ensure test specs meet Doc Detective requirements

ユースケース

01Validating documentation procedures during CI/CD to prevent doc-rot

02Automating screenshot capture and link checking within technical manuals

03Verifying that 'Getting Started' guides and tutorials work on the current UI

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add doc-detective/agent-tools doc-testing

For use in Claude.ai and ChatGPT

Download Skill