0xsimao-ai

Audits Solidity smart contracts by mapping protocol accounting and attacking it with twelve parallel lenses.

69|20|Updated Aug 6, 2026
One-click install
npx skills add https://github.com/0xsimao/0xsimao-ai --skill 0xsimao-ai-0xsimao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 0xsimao-ai
Source: https://github.com/0xsimao/0xsimao-ai
Command: npx skills add https://github.com/0xsimao/0xsimao-ai --skill 0xsimao-ai-0xsimao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Manual smart contract security review is slow and expensive, while most automated scanners only flag bad lines and miss accounting bugs where a tracked total drifts from the value it claims to represent. This Skill builds the protocol's money model first, then attacks it systematically to find who is left holding the loss. ## Core Features & Use Cases - Accounting-first analysis: Builds a money map of assets, tracked totals, invariants, lifecycles, and actor cohorts before hunting for bugs, targeting the desync class behind roughly a third of real High findings. - Twelve parallel attack lenses: Runs independent subagents covering accounting-desync, share-exchange-rate, temporal-cohort, liquidation-solvency, cross-chain-state, rounding, MEV, DoS, access control, integrations, edge states, and flow completeness. - Dedup, judging, and calibrated reporting: Merges duplicate findings with hard gates for function isolation and mechanism preservation, applies four severity gates, and emits a report with Description and Recommended Mitigation per finding. - Use Case: Point it at a DeFi vault repository before a paid audit to catch missing decrements, one-sided branch updates, and last-withdrawer insolvency bugs early. ## Quick Start Ask your agent to run 0xSimao AI on this repository to perform a full accounting-first security audit of the in-scope Solidity contracts.

Frequently Asked Questions about 0xsimao-ai

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a Solidity security audit with this skill?

Invoke it with "run 0xSimao AI" for a full repository scan or "run 0xSimao AI on Vault.sol" for specific files. The orchestrator builds a money map, spawns twelve parallel lens subagents, deduplicates findings, and prints a severity-calibrated report.

What kinds of smart contract bugs does an accounting-first audit find?

It targets tracked totals that drift from reality: missing decrements on withdrawals, one-sided branch updates, untracked balances, and reinitialized state. It also covers liquidation blocking, cross-chain state overwrite, oracle and token integration failures, and edge-state bugs at expiry or zero supply.

Does this audit skill work with agents that cannot spawn subagents?

Yes, it includes a sequential fallback that runs the twelve lenses one after another in a single context. This is slower and loses lens independence, but the method still applies; it never collapses the lenses into one pass.

Can this replace a manual smart contract audit?

No, the documentation explicitly states it does not replace a manual audit. It is designed to catch issues early so a codebase arrives at professional review cleaner, and its own benchmark notes that single runs are stochastic and can miss real issues.

What files are excluded from the audit scope?

The scan skips interfaces/, lib/, mocks/, test/, and script/ directories plus files matching *.t.sol, *Test*.sol, and *Mock*.sol. In-scope documentation and READMEs are included because documented invariants that code violates are high-yield finding sources.