solidity-agent-kit

A comprehensive agent skills toolkit for Solidity smart contract development with Foundry.

Equip your AI coding agent with battle-tested Solidity development practices — from coding standards to DeFi security.

Install

Quick Install (all agents)

# Interactive — choose which skills to install
npx skills add 0xlayerghost/solidity-agent-kit

# Install all 8 skills at once
npx skills add 0xlayerghost/solidity-agent-kit -y

This auto-detects all AI agents on your machine and installs for each one. It may create multiple folders (.agents/, .claude/, .cursor/, .windsurf/, etc.) — this is normal. The .agents/ folder holds the actual files; others are just symlinks.

Install for a Specific Agent

If you only use one agent, specify it with --agent:

# Claude Code only
npx skills add 0xlayerghost/solidity-agent-kit -y --agent claude-code

# Cursor only
npx skills add 0xlayerghost/solidity-agent-kit -y --agent cursor

# Windsurf only
npx skills add 0xlayerghost/solidity-agent-kit -y --agent windsurf

After Install

Copy the CLAUDE.md template to your project root so skills are auto-invoked:

# Download the template to your project root
curl -sL https://raw.githubusercontent.com/0xlayerghost/solidity-agent-kit/main/CLAUDE.md.template -o CLAUDE.md

Or manually: copy CLAUDE.md.template to your project root and rename it to CLAUDE.md.

CLAUDE.md is loaded automatically at the start of every Claude Code conversation. It tells Claude when to invoke each skill — no manual /slash-commands needed.

The CLI auto-detects all agents on your machine and creates folders for each (.agents/, .claude/, .cursor/, etc.). The .agents/ folder holds the actual files; others are just symlinks (no extra disk space).

Add these to your project's .gitignore to keep your repo clean:

# Agent skills (installed locally, not committed)
.agents/
.claude/
.cursor/
.trae/
.windsurf/

Uninstall

npx skills remove 0xlayerghost/solidity-agent-kit

Supported Agents

Claude Code, Cursor, Windsurf, Trae, Codex, Gemini CLI, OpenCode, and more.

Skills Included

Skill	Description	skills.sh
solidity-coding	Coding standards, naming conventions, project structure for Foundry	View
solidity-debug	Failed tx debugging, gas diagnosis, calldata decoding, revert analysis using cast	View
solidity-security	Private key protection, gas control, security best practices	View
solidity-deploy	Pre-deployment checks, deployment rules, post-deployment workflow	View
solidity-testing	Test organization, coverage requirements, fuzz testing with Foundry	View
defi-security	Anti-whale, anti-flash-loan, launch checklist, emergency response	View
git-workflow	Conventional commits, PR requirements, code review for Solidity projects	View
claude-code-usage	Context management, task strategies, prompt techniques	View

Who Is This For

• Solidity developers using Foundry (forge, cast, anvil)
• Teams building DeFi protocols and smart contracts
• Developers using AI coding agents for Solidity development

Tech Stack

• Solidity ^0.8.20
• Foundry (forge, cast, anvil)
• OpenZeppelin Contracts 4.9.x

Project Structure

solidity-agent-kit/
├── CLAUDE.md.template          # Copy to project root as CLAUDE.md
├── skills/
│   ├── solidity-coding/      # Coding standards
│   │   └── SKILL.md
│   ├── solidity-debug/       # On-chain tx debugging
│   │   └── SKILL.md
│   ├── solidity-security/    # Security practices
│   │   └── SKILL.md
│   ├── solidity-deploy/      # Deployment workflow
│   │   └── SKILL.md
│   ├── solidity-testing/     # Testing standards
│   │   └── SKILL.md
│   ├── defi-security/        # DeFi-specific security
│   │   └── SKILL.md
│   ├── git-workflow/         # Git collaboration
│   │   └── SKILL.md
│   └── claude-code-usage/    # AI agent best practices
│       └── SKILL.md
└── README.md

License

MIT

Author

0xlayerghost — Blockchain & Solidity Engineer

• GitHub: @0xlayerghost