Wingman for AI assistants

Connect once

The download is an agent skill, not an automatically installed ChatGPT or Claude connector. Your chosen client must support skills, secure secrets and HTTP or script tools. An OpenAPI schema and plain-text documentation are available for tool integrations.

1. Create a Wingman key with the permissions your assistant needs.
2. Download the Wingman skill and add it to an agent that supports skills and running tools. The bundle includes a Python helper with no third-party dependencies.
3. Set WINGMAN_API_KEY in the agent’s secret environment. Set WINGMAN_API_BASE to https://api.wingmanmaths.com/v1. Keep the key out of ordinary chat.
4. Ask the assistant to check the connection, then describe what you want to practise.

Find the right practice

Give the assistant questions:read, papers:write and papers:read. It should discover available filters, inspect the questions, preserve returned version pins, save the selection and download both PDFs. If it cannot find enough suitable questions, it should explain the gap.

I’m struggling with complex numbers in Further Maths Core Pure. Find me six relevant Edexcel questions, build a practice paper with writing space, and return the paper and its mark scheme.

Use Wingman’s marking

This workflow needs marking:submit and marking:read and uses the account’s automated-marking allowance. The assistant should wait for the background work and distinguish confirmed marks from unresolved decisions.

I’ve attached my completed paper and the mark scheme. Submit them to Wingman for automated marking, wait for the results, and show me which marks need review.

Bring the assistant’s marking back

This workflow needs marking:import and usually marking:read. The assistant must use the import schema, include every allocation, validate the submission and submit it to the account. A score summary or a flattened image with ticks is not a complete import.

Only ask an assistant to do this if it can inspect the actual page images. If it cannot locate evidence reliably, it should explain the limitation rather than fabricate boxes or claim examiner accuracy.

Mark my attached scan against the supplied Edexcel scheme, allocation by allocation. Use precise evidence boxes on the original pages, flag uncertainty, and submit the marked paper and results to Wingman.

For an agent with a terminal

The helper also supports search, uploading and submitting automated marking, reading results, and validating or completing imports. Run it with --help for commands. It keeps resumable workflow IDs in the selected output directory and never writes the API key there.

python3 scripts/wingman.py check
python3 scripts/wingman.py build \
  --module core-pure --query "complex numbers" \
  --count 6 --title "Complex numbers practice" \
  --output ./practice