Portable security-review Agent Skills with reference orchestration harness · Experimental demonstration project with substantial documented workflows

google/mantis

Apache-2.0 portable Agent Skills and a Python/Google ADK reference harness for staged defensive security review, covering architecture and threat modeling through vulnerability research, deduplication, validation, sandboxed reproduction, exploit chaining, patch verification, calibration, reflection, reporting, and secure-development advice; Claude Code is not explicitly documented, so applicability is inferred for skill-compatible coding agents rather than established as a native Claude extension.

Application securitySecure code reviewThreat modelingVulnerability researchStatic analysisDynamic reproductionExploit analysisSecurity patchingDevSecOpsHardware and firmware securityInfrastructure as Code securitySecure software development
Routing score
80.0
Readiness
Use only with expert supervision in isolated, restricted environments; not production-ready by its own documentation
License
Apache-2.0
Maintenance
active
Components
20
Revision
0

Selection

Select when

  • You need a staged defensive review workflow rather than one-pass vulnerability generation.
  • You can run generated code only inside a dedicated isolated VM, container, microVM, or hardened cloud sandbox.
  • Security experts will manually verify findings, exploitability, and patches.
  • You want to adapt review skills to organization-specific architecture, standards, build systems, and risk tolerance.
  • You need both static analysis and sandboxed reproduction or patch re-attack workflows.
  • You want snapshot provenance and conservative handling of code drift across repeated passes.
  • You need a reference multi-agent harness built on Google ADK.
  • You need support for source, binary, firmware, hardware, or infrastructure targets.
  • You want accumulated threat models and prior remediation evidence available during development.
  • You accept substantial setup and operational governance for safer execution.

Boundaries

Avoid when

  • You need an officially supported or production-certified Google security product.
  • You require a documented native Claude Code plugin or guaranteed Claude Code compatibility.
  • You cannot isolate generated payload execution from production systems, secrets, and internal networks.
  • You need deterministic findings with low false-positive rates and no expert review.
  • You intend to mass-file automatically generated vulnerability reports.
  • You need a turnkey setup with no Docker, virtualization, cloud, model, or sandbox configuration.
  • You require native Windows execution of the supplied reference harness outside WSL2.
  • You cannot permit an agent to read proprietary source or send context to configured model providers.
  • You require an independent security audit or validated sandbox-escape analysis.
  • You need automatically applied production patches rather than reviewed patch artifacts.

Strengths

Capabilities

Provides portable SKILL.md workflows exposed as slash-style Mantis stages.Defines a sequential campaign from repository history and architecture analysis through final reporting.Supports optional immutable snapshot-per-pass provenance and conservative drift handling.Builds Markdown and SQLite-backed knowledge about architecture, threats, findings, patches, and learnings.Plans exhaustive first-pass coverage and targeted later investigations with dependency and structural-index hints.Targets source code, compiled binaries, firmware blobs, and live development or staging endpoints.Separates candidate research, deduplication, validation, production viability, reproduction, and criticism into distinct stages.Generates proof-of-concept reproducers and directs dynamic execution into networkless isolated environments.Combines validated findings into exploit chains while preserving constituent provenance.Creates minimal source patches in transactional shadow copies and verifies unpatched, benign, attack, and re-attack controls.Produces pass- and snapshot-tagged Markdown review packets with provenance and redaction requirements.Includes a proactive advisor that queries SQLite knowledge for threat boundaries, lineages, patches, and false-positive context.Ships a Python Google ADK reference implementation with a configurable 16-agent workflow graph.Provides typed Pydantic domain tools and SQLite persistence generated from a canonical schema.Offers static-only, gVisor, MicroSandbox, and hardened GCE sandbox backends in the reference harness.Uses hashed Python requirements in the supplied reference installer.Documents optional continuous review with non-destructive synchronization only at pass boundaries.Allows skill adaptation for hardware/RTL, Infrastructure as Code, ML pipelines, and compiled firmware.Supports manual human-in-the-loop execution and a more autonomous meta-agent or reference-harness path.Documents model-tier selection and skill evaluation as efficiency and optimization concerns.

Risk profile

Risks and limitations

  • Uncertainty: only selected first-party files were supplied, so the full skill inventory, schema, reference-harness implementation, tests, dependency lock contents, sandbox code, meta-agent, and security controls were not directly inspected.
  • Uncertainty: repository metadata is dated in 2026 relative to this analysis context, so activity, adoption, issue counts, and maturity cannot be independently reconciled.
  • Uncertainty: Claude Code is not named in the supplied first-party files, so native compatibility, skill discovery, slash-command behavior, and installation location are unverified.
  • The repository explicitly says it is a demonstration, not intended for production, and not an officially supported Google product.
  • AI findings, reproducers, exploitability conclusions, and patches are non-deterministic and require manual security-expert verification.
  • Generated code may be unstable or dangerous, and skill instructions cannot guarantee that an agent will honor sandbox boundaries.
  • Dynamic reproduction and patch testing can require Docker or Podman, gVisor, KVM-based MicroSandbox, or a hardened GCP environment.
  • The supplied reference installer rejects native Windows, while macOS lacks the documented KVM microVM path.
  • Unattended operation creates prompt-injection and high-impact execution risks even with documented hardening.
  • Static-only mode skips dynamic exploit execution and patch testing, limiting confidence in findings and fixes.
  • The reference setup depends on external models, Google ADK, cloud credentials or services depending on configuration, and stack-specific build tools.
  • No independent security audit, measured detection benchmark, false-positive benchmark, sandbox-escape assessment, privacy policy, telemetry statement, or Claude compatibility matrix was supplied.

The repository repeatedly requires isolated, restricted environments and warns against production systems, sensitive data, and internal networks. Reproducer and patch stages direct execution into networkless gVisor containers, MicroSandbox microVMs, or hardened ephemeral GCE VMs; a static-only backend avoids dynamic execution. Pinned snapshots are treated as read-only, patch work occurs in private shadows, and VERIFIED_SECURE requires an unpatched trigger, patched compile, benign sink-reaching control, attack failure, and at least three unsuccessful re-attack variants. These are documented controls rather than independently verified guarantees, and the authors explicitly warn that agents may bypass intended isolation.

Component inventory

20 documented components

installation command

Mantis skill installation

Adds the portable Mantis skill collection to a compatible coding-agent environment; Claude Code-specific behavior is not documented.

README.md
skill command

mantis-history

Extracts VCS history, churn hotspots, developer activity, and past vulnerability signals.

mantis-history/SKILL.md
skill command

mantis-structural-index

Builds a content-addressed semantic-unit index with a manifest, catalog, and query helper.

mantis-structural-index/SKILL.md
skill command

mantis-summarize

Generates directory-level mantis-summary.md maps describing codebase structure and functionality.

mantis-summarize/SKILL.md
skill command

mantis-architecture

Synthesizes code structure and historical learning into the workspace Markdown knowledge base.

mantis-architecture/SKILL.md
skill command

mantis-threat-model

Develops the living threat model, including actors, entry points, assets, and trust boundaries.

mantis-threat-model/SKILL.md
skill command

mantis-plan

Creates workspace/plan.json with prioritized, context-linked security investigations and retry decisions.

mantis-plan/SKILL.md
skill command

mantis-researcher

Runs deep static-analysis sweeps over planned targets and records candidate security findings.

mantis-researcher/SKILL.md
skill command

mantis-dedupe

Consolidates overlapping findings, preserves cross-pass lineage, and stages duplicates in trash.

mantis-dedupe/SKILL.md
skill command

mantis-review

Checks finding validity, reachability, and negative filters to remove false positives.

mantis-review/SKILL.md
skill command

mantis-critic

Assesses whether validated findings remain triggerable in production or release configurations.

mantis-critic/SKILL.md
skill command

mantis-reproduce

Generates proof-of-concept reproducers and runs dynamic checks in an isolated, networkless sandbox.

mantis-reproduce/SKILL.md
skill command

mantis-chain

Combines validated findings into higher-impact, multi-step exploit-chain findings.

mantis-chain/SKILL.md
skill command

mantis-patch

Creates minimal fixes in transactional shadows and verifies them against reproducers and re-attacks.

mantis-patch/SKILL.md
skill command

mantis-calibrate

Calculates final 0–100 risk ratings and appends rationale to individual findings.

mantis-calibrate/SKILL.md
skill command

mantis-reflect

Extracts trajectory insights and rotates feedback into the learning store and knowledge base.

mantis-reflect/SKILL.md
skill command

mantis-report

Produces a redacted, campaign-wide Markdown review packet with findings, evidence, patches, and provenance.

mantis-report/SKILL.md
orchestration command

mantis-meta-agent

Runs the review pipeline autonomously and can opt into snapshot-per-pass synchronization.

README.md
workflow and CLI

ADK reference campaign harness

Reference Google ADK implementation that configures and launches the 16-stage review graph with selectable sandboxes.

reference/README.md
skill and CLI

mantis-advise

Queries knowledge.db for threat context, vulnerability lineages, verified patches, false positives, and secure-development guidance.

mantis-advise/SKILL.md

Technical profile

Requirements and configuration

Repository
google/mantis
License
Apache-2.0
Primary Language
Python
Repository Status
Public, unarchived repository; metadata reports 983 stars and 99 forks, with dates that cannot be independently reconciled.
Artifact Format
Markdown SKILL.md directories plus Python scripts, JSON workflow and schema contracts, SQLite state, and shell setup tooling.
Claude Code Relation
Inference: portable Agent Skills may be consumable by a skill-compatible Claude Code setup, but no Claude-specific path, plugin manifest, marketplace, hook, MCP integration, or minimum version is supplied.
Documented Installation
The root README documents adding google/mantis with the skills CLI after cloning or asking a coding agent for help; the separate ADK reference harness has its own install script.
Pipeline
The reference workflow orchestrates 16 canonical stages from history and structural indexing through reporting.
Orchestration
Google ADK graph nodes load skill directories through SkillToolset and attach typed tools to the configured sandbox environment.
State
Workspace JSON and Markdown artifacts plus SQLite knowledge persistence, with Pydantic models generated from a canonical schema.
Sandbox Backends
Static-only, gVisor, MicroSandbox, and hardened GCE environments are documented.
Reference Dependencies
Python virtual environment with hash-required requirements; exact Python version and dependency versions were not supplied.
Operating Systems
Reference installer gates Linux and WSL2, warns on macOS limitations, and rejects native Windows.
Networking
Dynamic sandbox designs are documented as networkless, while hardened GCE uses a private VPC, no external IP, no service account, DNS blocking, and IAP tunneling.
Execution Modes
Manual human-in-the-loop slash-stage execution, optional snapshot-aware continuous passes, and an autonomous ADK reference campaign.
Outputs
Finding JSON, knowledge-base Markdown, SQLite knowledge, reproducers, patch diffs, risk records, and pass-tagged Markdown review packets.
Contribution Model
External pull requests and code contributions are not accepted; users are encouraged to fork and remix.
Setup Scope
Skill-only consumption is relatively light, but reliable dynamic campaigns require models, stack tools, sandbox infrastructure, and security hardening.

Classification

How it enters the stack

Context InjectionOrchestrationInfrastructure

Evidence: SKILL.md files inject staged security procedures, while the ADK reference harness orchestrates 16 agents and sandbox infrastructure. Inference: Claude Code could consume portable skills, but no Claude-specific plugin or path is documented; copy_paste best reflects cloning or generic skills-CLI use. End-to-end safe setup is high effort.

Copy Paste · high setup effort · medium confidence · automated

Evidence and risk

Primary sources

first_party_fileREADME.mdhttps://github.com/google/mantis/blob/main/README.md
first_party_filereference/README.mdhttps://github.com/google/mantis/blob/main/reference/README.md
first_party_fileAGENTS.mdhttps://github.com/google/mantis/blob/main/AGENTS.md
first_party_fileCONTRIBUTING.mdhttps://github.com/google/mantis/blob/main/CONTRIBUTING.md

Routing context

Conflicts, complements, and synergies

similar_to

gh_dzhng_skills

Catalog inference: both provide portable SKILL.md workflows and multi-stage software-agent orchestration, while Mantis is specialized for defensive security campaigns.

medium confidence
similar_to

gh_orchestra_research_ai_research_skills

Catalog inference: both route work across reusable domain skills, but Mantis focuses on vulnerability review and includes a dedicated sandboxed reference harness.

low confidence
alternative_to

gh_mengto_skills

Catalog inference: both are portable skill collections usable across coding agents, but their domains differ substantially and no direct project relationship is documented.

low confidence