Skip to content
Skillpedia
Misc48k · #2702

darkmoon-pentest

Allows your agent to start and monitor automated security tests (pentests).

What it does

This tool starts automated security tests on systems you own or have permission to test. It checks for vulnerabilities and reports its findings.

When to use it

  • ✓When you want to test the security of a website or server you control.
  • ✓To check if a system is protected against common attacks.
  • ✓To understand what security flaws a system might have.

Example of what to ask your AI

“Start a security test on my website 'mysite.com', I have authorization for it.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/darkmoon-pentest/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/darkmoon-pentest/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The tool connects to a system called Darkmoon Pro that you set up. It sends commands to start the test, checks the progress, and then collects the results to show you.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add sickn33/agentic-awesome-skills --skill darkmoon-pentest

Or download just the file:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/darkmoon-pentest/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

⚠️ AUTHORIZED USE ONLY This skill is for educational purposes or authorized security assessments only. You must have explicit, written permission from the system owner before using this tool. Misuse of this tool is illegal and strictly prohibited.

Mandatory confirmation gate Before running any command that probes, exploits, changes, persists on, extracts data from, or attempts credential access against a target:

  1. Ask the user to state the exact target URL, IP, account, or resource.
  2. Ask the user to confirm written authorization and the permitted scope.
  3. Show the exact command(s) and explain their expected effect.
  4. Wait for explicit confirmation in the current conversation.

Without that confirmation, remain read-only and provide defensive guidance only. Prefer a sandbox, disposable VM, or controlled lab.

AUTHORIZED USE ONLY: Use this skill only for authorized security assessments, defensive validation, or controlled educational environments.

Darkmoon Pentest Runs

Overview

Darkmoon is an autonomous AI penetration testing platform: an LLM orchestrates specialist agents and offensive tools and proves each finding with a real exploit. The Darkmoon engine and CLI are open source (GPL-3.0). This skill drives a self-hosted Darkmoon Pro instance through the @darkmoon_ai/mcp-server MCP server, which talks to the Pro Dashboard API (DARKMOON_BASE_URL). The MCP server does not work against the open source CLI alone.

The skill covers the four MCP tools the server exposes: run_pentest, get_run_status, list_campaigns and get_findings.

When to Use This Skill

  • Use when the user wants to start an autonomous penetration test against a target they own or are authorized in writing to test, using their own Darkmoon Pro instance.
  • Use when the user asks for the status of a Darkmoon run.
  • Use when the user wants to list Darkmoon campaigns.
  • Use when the user wants to read, group and triage the findings of a Darkmoon campaign.
  • Do not use if no Darkmoon Pro instance is available or the darkmoon MCP server is not configured.

How It Works

Step 0: Confirm authorization and setup

Only start a run against a host, URL or scope that the user owns or is explicitly authorized in writing to test. If authorization is not stated, ask before calling run_pentest. Never widen the target beyond what the user named.

The MCP server reads DARKMOON_BASE_URL, DARKMOON_USERNAME and DARKMOON_PASSWORD from its environment. Never ask the user to paste credentials into the conversation.

Step 1: Start a run

Call run_pentest with target and, optionally, program, focus and severity. It returns a run_id; the run continues in the background and can take a long time.

Step 2: Follow the run

Call get_run_status with the run_id. It returns running, completed, error or unknown, plus the five most recent events. Poll sparingly and do not loop tightly.

Step 3: Find the campaign

Call list_campaigns to find the campaign id once the run has produced one.

Step 4: Read and triage findings

Call get_findings with the campaign_id. Each finding carries a title, severity, CVSS score, category, status (exploited, confirmed or unconfirmed), endpoint and remediation guidance, plus severity statistics.

Examples

Example 1: Install the MCP server

{
  "mcpServers": {
    "darkmoon": {
      "command": "npx",
      "args": ["-y", "@darkmoon_ai/mcp-server"],
      "env": {
        "DARKMOON_BASE_URL": "${DARKMOON_BASE_URL}",
        "DARKMOON_USERNAME": "${DARKMOON_USERNAME}",
        "DARKMOON_PASSWORD": "${DARKMOON_PASSWORD}"
      }
    }
  }
}

Example 2: A typical request

User: "Run a pentest on staging.example.com, which we own, and summarize what was exploited."

  1. Confirm that staging.example.com is in scope and authorized.
  2. run_pentest with target: "staging.example.com", keep the returned run_id.
  3. Poll get_run_status until the status is completed.
  4. list_campaigns, then get_findings for the new campaign.
  5. Report exploited and confirmed findings first, grouped by severity.

Best Practices

  • Report findings grouped by severity and status; call out exploited and confirmed first.
  • Treat unconfirmed findings as leads, and say that findings can include false positives and must be reviewed by a qualified human before anyone acts on them.

…

FAQ

Do I need permission to use this tool?

Yes, you can only use this tool on systems you own or have written permission to test. Testing without permission is illegal.

What is Darkmoon Pro?

It's a platform that uses artificial intelligence to perform automated security tests. This tool connects to a specific version called Darkmoon Pro.

Can I test any website?

No, only websites or systems for which you have explicit, written authorization. Testing systems without permission is prohibited and illegal.

Details

Original description by the author

Start, follow and triage authorized autonomous AI pentest runs on a self-hosted Darkmoon Pro instance through its MCP server.

repo: sickn33/agentic-awesome-skills

Popularity

GitHub stars
48k
Ranking position
#2702
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills