Doc Detective Testing FAQs

Question 1

Can I use CSS selectors with this skill?

Accepted Answer

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.

Question 2

Why is validation mandatory before returning a spec?

Accepted Answer

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.

Question 3

How does Doc Detective differ from Playwright?

Accepted Answer

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.

Question 4

What types of actions can I test with this skill?

Accepted Answer

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

Question 5

Does this skill support injecting tests into my source files?

Accepted Answer

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

Key Features

Use Cases

Doc Detective Testing

Key Features

Use Cases