Plugin

doc-detective-agent-tools

Name: doc-detective-agent-tools
Author: doc-detective

By doc-detective

Agents, skills, and plugins for intelligent documentation testing and quality assurance.

Component Overview

/doc-detective-generate, /doc-detective-init +4

Commands

doc-detective-specialist

Agents

doc-detective-doc-testing, doc-detective-generate +7

Skills

SessionStart

Hooks

MCP Servers

LSP Servers

Output Styles

Themes

Monitors

Install

npx claudepluginhub joshuarweaver/cascade-code-testing-misc --plugin doc-detective-agent-tools

Component Details

Commands (6)

Generate Tests Command

/doc-detective-generate

Interpret documentation procedures into Doc Detective test specifications without executing

Init Command

/doc-detective-init

Initialize Doc Detective in a repository with documentation detection, config generation, test creation, and iterative fix loop

Inject Inline Tests Command

/doc-detective-inject

Inject test specifications into documentation source files as inline comments

Install GitHub Action

/doc-detective-install-github-action

Install and configure the Doc Detective GitHub Action workflow for automated documentation testing in CI

Test Documentation Command

/doc-detective-test

Convert documentation procedures into Doc Detective test specifications, run them, and optionally fix failures

Validate Command

/doc-detective-validate

Validate Doc Detective test specifications or configuration files

Agents (1)

doc-detective-specialist

/doc-detective-specialist

Use this agent when the user needs help with Doc Detective configuration, doc testing strategies, Docs as Tests methodology, or any aspect of using Doc Detective tools, commands, and plugins. This includes setting up test configurations, writing doc tests, debugging test failures, understanding Docs as Tests concepts, or integrating Doc Detective into workflows. Examples: <example> Context: The user wants to set up Doc Detective for the first time in their project. user: "I want to start testing my documentation. How do I set up Doc Detective?" assistant: "Let me use the doc-detective-guide agent to walk you through setting up Doc Detective for your project." <commentary> Since the user is asking about Doc Detective setup and configuration, use the Task tool to launch the doc-detective-guide agent to provide detailed guidance. </commentary> </example> <example> Context: The user is writing documentation and wants to add inline tests. user: "How do I add a test to verify this API endpoint works in my docs?" assistant: "I'll use the doc-detective-guide agent to help you write an inline doc test for your API endpoint." <commentary> Since the user is asking about writing doc tests, use the Task tool to launch the doc-detective-guide agent to provide specific test authoring guidance. </commentary> </example> <example> Context: The user is confused about a Doc Detective concept or methodology. user: "What's the difference between runTests and runCoverage in Doc Detective?" assistant: "Let me use the doc-detective-guide agent to explain these Doc Detective commands and when to use each." <commentary> Since the user is asking about Doc Detective commands and concepts, use the Task tool to launch the doc-detective-guide agent. </commentary> </example> <example> Context: The user wants to understand the Docs as Tests philosophy. user: "Why should I test my documentation? What's the Docs as Tests approach?" assistant: "I'll use the doc-detective-guide agent to explain the Docs as Tests methodology and its benefits." <commentary> Since the user is asking about the Docs as Tests methodology, use the Task tool to launch the doc-detective-guide agent. </commentary> </example>

Skills (9)

doc-detective-doc-testing

/doc-detective-doc-testing

Verify documentation and procedures with Doc Detective test specifications. MANDATORY: Read SKILL.md first. Format: {"goTo":"url"} {"find":"text"} {"click":"text"} - action IS the key. NEVER {"action":"goTo"}. Keywords: test spec, Doc Detective, test JSON, test documentation, test docs, test procedure, verify procedures.

doc-detective-generate

/doc-detective-generate

Interpret documentation procedures into Doc Detective test specifications without executing

doc-detective-init

/doc-detective-init

Initialize Doc Detective in a repository with documentation detection, config generation, test creation, and iterative fix loop

doc-detective-inject

/doc-detective-inject

Inject test specifications into documentation source files as inline comments

doc-detective-inline-test-injection

/doc-detective-inline-test-injection

Inject Doc Detective test specs into documentation source files as inline comments

doc-detective-install-github-action

/doc-detective-install-github-action

Install and configure the Doc Detective GitHub Action workflow for automated documentation testing in CI

doc-detective-project-bootstrap

/doc-detective-project-bootstrap

Initialize Doc Detective in a repository by detecting documentation, generating minimal config, creating tests for procedures, and iteratively running/fixing them. Use when (1) setting up Doc Detective in a new project, (2) user asks to "init" or "bootstrap" doc testing, (3) creating initial test coverage for existing documentation, or (4) onboarding a project to Doc Detective workflows.

doc-detective-test

/doc-detective-test

Convert documentation procedures into Doc Detective test specifications, run them, and optionally fix failures

doc-detective-validate

/doc-detective-validate

Validate Doc Detective test specifications or configuration files

Hooks (1)

Review workflow modifications before installing

Event Hooks

1 hook across 1 event

README

Doc Detective Agent Tools

Agent tools for testing documentation procedures and validating that documented workflows match actual application behavior. Compatible with Gemini CLI, Claude Code, Cursor, Codex, OpenCode, GitHub Copilot, and other AI coding agents that support plugins, skills, or commands.

Set up Doc Detective for a project. Initialize Doc Detective in a project with automatic documentation detection, config generation, and test creation.
Generate tests. Convert documentation into executable test specifications.
Run tests. Execute tests against your application and report results.
Inject tests into your docs content. Embed test steps close to associated documentation content.
Install the Doc Detective GitHub Action. Add a Doc Detective GitHub Actions workflow for automated documentation testing in CI.

Installation

Claude Code

Open Claude Code:
```
claude
```

Add the Doc Detective marketplace and plugin:

/plugin marketplace add doc-detective/agent-tools
/plugin install doc-detective@doc-detective

Ask about Doc Detective, or use the init command to get started:
```
/doc-detective-init
```

Gemini CLI

Install the extension and open Gemini CLI:

gemini extensions install https://github.com/doc-detective/agent-tools.git --auto-update
gemini

Ask about Doc Detective, or use the init command to get started:
```
/doc-detective-init
```

Copilot CLI

Open Copilot CLI:
```
copilot
```

Install the Doc Detective plugin:

/plugin marketplace add doc-detective/agent-tools
/plugin install doc-detective@doc-detective

Ask about Doc Detective, or use the init command to get started:
```
/doc-detective-init
```

Qwen Code

Install the plugin and open Qwen Code:

qwen extensions install https://github.com/doc-detective/agent-tools
qwen extensions install doc-detective:doc-detective
qwen

Ask about Doc Detective, or use the init command to get started:
```
/doc-detective-init
```

<<<<<<< copilot/add-opencode-plugin

OpenCode

Clone the repository:

git clone https://github.com/doc-detective/agent-tools.git

Copy the plugin contents to your project's .opencode/ directory:

mkdir -p .opencode/plugins
cp agent-tools/plugins/doc-detective/opencode-plugin.mjs .opencode/plugins/
cp -r agent-tools/plugins/doc-detective/hooks .opencode/
cp -r agent-tools/plugins/doc-detective/skills .opencode/
cp -r agent-tools/plugins/doc-detective/agents .opencode/

Start OpenCode and ask about Doc Detective, or use the init command: =======

Codex

Clone the repo and copy the plugin and marketplace into your project:

git clone https://github.com/doc-detective/agent-tools.git
cp -r agent-tools/plugins/doc-detective ./plugins/doc-detective
mkdir -p .agents/plugins
cp agent-tools/.agents/plugins/marketplace.json .agents/plugins/marketplace.json

Open Codex and install the plugin from the marketplace:
```
codex
```
Ask about Doc Detective, or use the init command to get started:

main

/doc-detective-init

<<<<<<< copilot/add-opencode-plugin The plugin provides tool.execute.before and tool.execute.after hooks that automatically validate test specs, block common anti-patterns, suggest running tests after doc edits, and check for Doc Detective CLI availability.

Codex, Cursor, and other agents

=======

Cursor, OpenCode, and other agents

main

Option 1: Install with `npx skills`

[!WARNING] npx skills only installs skills, not agents, commands, or other tools. For full functionality, consider manual installation.

Install these skills with the skills package from Vercel. This works with Claude Code, Cursor, Codex, OpenCode, and other AI coding tools.

npx skills add doc-detective/agent-tools

Follow the prompts. The CLI auto-detects which AI tools you have installed and places the skills in the appropriate directories.

Option 2: Manual Installation

Copy to your project directory

git clone https://github.com/doc-detective/agent-tools.git

cp -r agent-tools/agents .{agent-dir}/agents      # Agents
cp -r agent-tools/commands .{agent-dir}/commands  # Commands
cp -r agent-tools/skills .{agent-dir}/skills      # Skills
cp -r agent-tools/hooks .{agent-dir}/hooks        # Hooks

[!IMPORTANT] Adjust the destination path based on your agent's expected skill/plugin directory. For example, .agents for Codex, .cursor for Cursor, etc.

Usage

Bootstrap Doc Detective for a Project

/doc-detective-init

View full README on GitHub

Similar Plugins

everything-claude-code

Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, rules, and legacy command shims evolved over 10+ months of intensive daily use

Stats

Version1.0.0

Stars11

Forks2

MaintenanceExcellent

AddedJan 22, 2026

Actions

View on GitHub View README Plugin Marketplace JSON

Available In

cascade-code-testing-misc

Safety Signals

Caution

Uses power tools

Uses Bash, Write, or Edit tools

Doc Detective Agent Tools

Set up Doc Detective for a project. Initialize Doc Detective in a project with automatic documentation detection, config generation, and test creation.
Generate tests. Convert documentation into executable test specifications.
Run tests. Execute tests against your application and report results.
Inject tests into your docs content. Embed test steps close to associated documentation content.
Install the Doc Detective GitHub Action. Add a Doc Detective GitHub Actions workflow for automated documentation testing in CI.

Installation

Claude Code

Open Claude Code:
```
claude
```

Add the Doc Detective marketplace and plugin:

/plugin marketplace add doc-detective/agent-tools
/plugin install doc-detective@doc-detective

Ask about Doc Detective, or use the init command to get started:
```
/doc-detective-init
```

Gemini CLI

Install the extension and open Gemini CLI:

gemini extensions install https://github.com/doc-detective/agent-tools.git --auto-update
gemini

Ask about Doc Detective, or use the init command to get started:
```
/doc-detective-init
```

Copilot CLI

Open Copilot CLI:
```
copilot
```

Install the Doc Detective plugin:

/plugin marketplace add doc-detective/agent-tools
/plugin install doc-detective@doc-detective

Ask about Doc Detective, or use the init command to get started:
```
/doc-detective-init
```

Qwen Code

Install the plugin and open Qwen Code:

qwen extensions install https://github.com/doc-detective/agent-tools
qwen extensions install doc-detective:doc-detective
qwen

Ask about Doc Detective, or use the init command to get started:
```
/doc-detective-init
```

<<<<<<< copilot/add-opencode-plugin

OpenCode

Clone the repository:

git clone https://github.com/doc-detective/agent-tools.git

Copy the plugin contents to your project's .opencode/ directory:

mkdir -p .opencode/plugins
cp agent-tools/plugins/doc-detective/opencode-plugin.mjs .opencode/plugins/
cp -r agent-tools/plugins/doc-detective/hooks .opencode/
cp -r agent-tools/plugins/doc-detective/skills .opencode/
cp -r agent-tools/plugins/doc-detective/agents .opencode/

Start OpenCode and ask about Doc Detective, or use the init command: =======

Codex

Clone the repo and copy the plugin and marketplace into your project:

git clone https://github.com/doc-detective/agent-tools.git
cp -r agent-tools/plugins/doc-detective ./plugins/doc-detective
mkdir -p .agents/plugins
cp agent-tools/.agents/plugins/marketplace.json .agents/plugins/marketplace.json

Open Codex and install the plugin from the marketplace:
```
codex
```
Ask about Doc Detective, or use the init command to get started:

main

/doc-detective-init

Codex, Cursor, and other agents

=======

Cursor, OpenCode, and other agents

main

Option 1: Install with `npx skills`

[!WARNING] npx skills only installs skills, not agents, commands, or other tools. For full functionality, consider manual installation.

Install these skills with the skills package from Vercel. This works with Claude Code, Cursor, Codex, OpenCode, and other AI coding tools.

npx skills add doc-detective/agent-tools

Follow the prompts. The CLI auto-detects which AI tools you have installed and places the skills in the appropriate directories.

Option 2: Manual Installation

Copy to your project directory

git clone https://github.com/doc-detective/agent-tools.git

cp -r agent-tools/agents .{agent-dir}/agents      # Agents
cp -r agent-tools/commands .{agent-dir}/commands  # Commands
cp -r agent-tools/skills .{agent-dir}/skills      # Skills
cp -r agent-tools/hooks .{agent-dir}/hooks        # Hooks

[!IMPORTANT] Adjust the destination path based on your agent's expected skill/plugin directory. For example, .agents for Codex, .cursor for Cursor, etc.

Usage

Bootstrap Doc Detective for a Project

/doc-detective-init

doc-detective-agent-tools

Component Overview

Install

Component Details

Commands (6)

Agents (1)

Skills (9)

Hooks (1)

README

Doc Detective Agent Tools

Installation

Claude Code

Gemini CLI

Copilot CLI

Qwen Code

OpenCode

Codex

Codex, Cursor, and other agents

Cursor, OpenCode, and other agents

Option 1: Install with npx skills

Option 2: Manual Installation

Copy to your project directory

Usage

Bootstrap Doc Detective for a Project

Similar Plugins

everything-claude-code

doc-detective-agent-tools

Component Overview

Install

Component Details

Commands (6)

Agents (1)

Skills (9)

Hooks (1)

README

Doc Detective Agent Tools

Installation

Claude Code

Gemini CLI

Copilot CLI

Qwen Code

OpenCode

Codex

Codex, Cursor, and other agents

Cursor, OpenCode, and other agents

Option 1: Install with npx skills

Option 2: Manual Installation

Copy to your project directory

Usage

Bootstrap Doc Detective for a Project

Similar Plugins

everything-claude-code

everything-claude-code

everything-claude-code

context7-plugin

dotnet-skills

unity-dev-toolkit

Option 1: Install with `npx skills`

Option 1: Install with `npx skills`