Agent skill

Agentiqa ships a user-facing agent skill — a compact instruction set that teaches an AI coding agent (Claude Code and compatible agents) how to use Agentiqa across all four surfaces: the CLI, the web app, the desktop app, and the GitHub Action. It uses progressive disclosure: a short SKILL.md with the essentials, bundled reference files for the CLI, service keys, the JSON envelope, exit codes, and quickstarts, and a delegation to this site's /llms-full.txt for anything not bundled.

What it is (and what it isn't)

This is a Claude Code skill — a SKILL.md plus reference files. It teaches an agent how to drive Agentiqa: which surface to pick, the agentiqa explore / agentiqa run commands, the GitHub Action, the JSON envelope, and the exit-code contract.

It ships as part of the Agentiqa plugin (Agentiqa/agentiqa-plugin), which contains two skills:

• agentiqa-test — runs Agentiqa against your app from inside the coding agent (explore, report bugs with reproduction steps and media);
• agentiqa (this skill) — the usage reference: CLI commands and selectors, the GitHub Action, service keys, the JSON envelope, exit codes.

It is not:

• an MCP server — it exposes no tools and runs no process;
• the Agentiqa product — the skill contains only instructions. The actual testing is done by the tools it points at: the agentiqa CLI (published on npm) and the agentiqa/qa-action GitHub Action.

Install

Claude Code:

/plugin marketplace add Agentiqa/agentiqa-plugin
/plugin install agentiqa@agentiqa

Cursor: /add-plugin https://github.com/Agentiqa/agentiqa-plugin · Codex CLI: codex plugin marketplace add Agentiqa/agentiqa-plugin

The agent loads the skill on demand when you ask it to test an app with Agentiqa, run agentiqa in CI, or parse an Agentiqa result. No configuration is required.

What it covers

• Which surface to use — CLI/Action for automation, the apps for interactive QA.
• The two CLI commands — agentiqa explore (agent-led discovery) and agentiqa run (deterministic saved-plan replay), plus engine modes and plan selection.
• The CI contract — the 4-code exit model and the schemaVersion: 1 JSON envelope, so an agent can gate and parse results correctly.
• The GitHub Action — agentiqa/qa-action@v1 setup.

Consuming the docs directly

Any agent (with or without the skill) can read these docs as plain text:

• /llms.txt — a machine-readable index of every page.
• /llms-full.txt — the entire docs corpus as one document.
• Append .md to any docs URL for that page as markdown (e.g. /docs/ci.md).

Because the CLI and Action references are generated from the code and the prose is audited nightly, the skill delegates to /llms-full.txt for freshness — when the bundled references and the live docs disagree, the live docs win.