my-skill

name	my-skill
description	One line on what this playbook does, then a "Use when ..." clause so the agent knows when to load it (e.g. "Use when the target exposes X / you see Y in requests"). Max 1024 chars. This description is the ONLY thing the model sees until it loads the skill — make the trigger conditions explicit, since there is no separate `triggers` list.
allowed-tools	["http","shell","file_write"]

my-skill playbook

State the goal in one or two sentences — what the operator is trying to achieve — and the scope rules (authorized targets only).

1. First step

Concrete, copy-pasteable commands. Default to curl + the http tool; only reach for specialised scanners when the user asks.

curl -ksS "https://TARGET/..."

Reference bundled files (e.g. a wordlist under payloads/) with read_payloads(skill="my-skill", file="list.txt"), or shell scripts via the ${SKILL_DIR} placeholder:

${SKILL_DIR}/scripts/check.sh https://TARGET

2. Next step

...

Reporting

What proves the bug, the concrete impact in one sentence, and remediation. When you have a reproduced finding with a real request/response, call confirm_finding.