Guide · Agent skill
How to use the CTF Sandbox Entry agent skill (ctf-sandbox)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The ctf-sandbox skill is a routing entry point that tells an AI agent how to start work on capture-the-flag (CTF) competitions, attack-defense (AWD) games and practice ranges (靶场). It is for students, players and security teams using authorised lab environments. After this guide you will know how to install the skill, how to trigger it with a natural request, and what it does before any work begins.
Quick start
- 1Download the ZIP. Download the ctf-sandbox ZIP from this page. The ZIP contains SKILL.md.
- 2Unzip into a skills folder. Unzip into ~/.claude/skills/ for all projects, or into a project's .claude/skills/ for one project.
- 3Add the required companions. Make sure the CTF-Sandbox-Orchestrator folder and routing.json from the wider repository are available at the paths the skill references.
- 4Confirm PowerShell is available. The skill runs ../scripts/case-init.ps1, so PowerShell must be installed.
- 5Make a natural request. Ask for help with a CTF, AWD or 靶场 task and state the network environment, such as lab or offline.
- 6Let case-init run first. The agent runs the case-init script to set scope before any external network action, then hands off to the orchestrator.
What the ctf-sandbox skill makes the agent do
An agent skill is a folder with a SKILL.md file that tells an agent how to handle a certain kind of task. This one is a thin entry gate, not a full exploit toolkit. Its description says it is a PRIMARY for CTF, AWD and 靶场 multi-type orchestration that hands off to a sidecar skill called CTF-Sandbox-Orchestrator.
When triggered, the skill first tells the agent to run a case-initialisation script that sets an authorisation scope and a network profile. It then points the agent to the sidecar orchestrator, which chooses a specific competition sub-skill. Tasks that are clearly pwn, Android APK or IDA reverse engineering are meant to be taken by more specific skills, not this one.
- Sets an authorisation scope and a lab or offline network profile before work starts
- Hands the job to the CTF-Sandbox-Orchestrator sidecar skill
- Leaves pwn, APK and IDA tasks to more specific skills that already match them
Install the ctf-sandbox skill
Download the ZIP from the skill page on this site. To use it with Claude Code, unzip it into ~/.claude/skills/ to make it available everywhere, or into a project's .claude/skills/ folder to limit it to that project.
In the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills. Either way, the skill also depends on files that are not in this ZIP: the referenced ../scripts/case-init.ps1 script, the CTF-Sandbox-Orchestrator skill folder found by relative path, and a routing.json configuration from the wider repository.
- Download the ZIP from this page
- Unzip to ~/.claude/skills/ (all projects) or your project's .claude/skills/ (one project)
- Or upload it in the Claude apps under Settings → Capabilities → Skills
- Check that the required sidecar folder and routing.json are also available
Check the requirements before you start
The skill needs PowerShell to run the case-init script. It also needs the sidecar CTF-Sandbox-Orchestrator skill folder and a routing.json file from the wider repository. The ZIP alone does not contain these, so the skill will not work as a standalone tool.
The skill runs scripts and uses the network, so review what it will do on your machine before you enable it.
- PowerShell, to run ../scripts/case-init.ps1
- The CTF-Sandbox-Orchestrator sidecar skill folder, referenced by relative path
- A routing.json configuration from the wider repository
Trigger the skill with natural requests
The skill activates when your request mentions CTF, AWD, 靶场 or 比赛题 and no more specific pwn, APK or IDA route has already matched. Write the request as you would to a colleague, and say which network setting applies, such as a lab range or offline environment.
Before any external network action, the skill requires the authorisation status to be granted. If you ask for work against a real internet target, the agent should stop until that authorisation exists.
- Example: 'I have a CTF challenge from my class, help me organise the work in a lab range'
- Example: 'We are running an AWD training round on our offline lab network'
- Example: '比赛题 靶场 练习, set up the scope first'
- For clearly pwn or APK tasks, ask for that specific work directly so the more specific skill can take it
../scripts/case-init.ps1 -NetworkProfile labSafety notes: scripts, network and authorisation
The first step runs a script, and the skill is designed around scope control. Use the lab or offline network profile for competitions and ranges. The skill's own self-check asks the agent to confirm that it followed case-init and scope first, rather than treating 'the user said CTF' as permission to act on external networks.
The CTF-Sandbox-Orchestrator folder is described as a GPL side package, and its default authorisation is inside the sandbox. The core routing package is MIT and uses a scope.md gate.
- Only run against real external targets after written authorisation is in place
- Use -NetworkProfile lab or offline for competitions and practice ranges
- Do not copy the 40+ competition sub-skills into routing.json; this entry is only a PRIMARY gate
- Review the scripts before running them on your machine
Tips for getting good results
Keep the scope clear in your first message: say whether the target is a lab, an offline range or a training network. Name the challenge type if you know it, so the router can pick the right specialist. If the skill does not trigger, check that the description keywords appear in your request and that the sidecar folder is installed in the expected relative location.
- State the network environment early
- Name the challenge type when you know it (pwn, APK, IDA)
- Confirm the sidecar and routing.json are present if routing fails
What people use it for
- Organising a class CTF challenge set up in a lab range
- Running an authorised AWD training round on an offline network
- Teaching how a multi-skill routing layer is structured
Frequently asked questions
How do I install the ctf-sandbox agent skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for all projects or into a project's .claude/skills/ folder for one project. You can also upload it in the Claude apps under Settings → Capabilities → Skills.
What does the ctf-sandbox skill require?
It requires PowerShell to run ../scripts/case-init.ps1, the CTF-Sandbox-Orchestrator sidecar skill folder referenced by relative path, and a routing.json configuration from the wider repository. The ZIP does not include the sidecar or routing.json.
Is the ctf-sandbox skill free to use?
The entry skill is listed under the MIT licence. The CTF-Sandbox-Orchestrator sidecar folder is described in its source as a GPL side package, so check its licence separately before reuse.
Can I use this skill to attack a real website?
No, not without written authorisation. The skill says real external network actions must wait until the authorisation status is granted, and it is meant for lab, offline or competition environments.
What is the alternative for pwn, APK or IDA tasks?
The skill says clearly pwn, Android APK and IDA work should go to more specific skills that already match them in routing.json. Ask for that specific work directly and the more targeted skill should take it.
Why does ctf-sandbox not trigger for my request?
It triggers on the words CTF, AWD, 靶场 or 比赛题 when no more specific route has matched. Check that your request includes one of those terms and that the sidecar folder and routing.json are installed where the skill expects them.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you are a student, player or security team running CTF or lab-range exercises and want an agent to organise the work with scope controls first. Pick something else if you need a standalone exploit toolkit, because this file is only a routing gate that depends on folders not included here.
Download the skill