Protect Your AI Agent

Quick Start for your AI Agents

Option A - skills CLI (ecosystem standard)

Start here for the smoothest setup:

npx skills add mode-io/mode-io-skills

Target a specific client if needed:

npx skills add mode-io/mode-io-skills -a claude-code
npx skills add mode-io/mode-io-skills -a codex
npx skills add mode-io/mode-io-skills -a opencode
npx skills add mode-io/mode-io-skills -a cursor

Option B - alternative installer

npx ai-agent-skills install mode-io/mode-io-skills

Install From Source

If you prefer manual installation, use these skill directories.

Client	Project-level path	Global path
Claude Code	.claude/skills/mode-io-skills	~/.claude/skills/mode-io-skills
Codex CLI	.agents/skills/mode-io-skills	~/.agents/skills/mode-io-skills
OpenCode	.agents/skills/mode-io-skills or .opencode/skills/mode-io-skills	~/.config/opencode/skills/mode-io-skills
Cursor	.agents/skills/mode-io-skills or .cursor/skills/mode-io-skills	~/.cursor/skills/mode-io-skills

Example (global install, pick the client you use):

# Claude Code
git clone https://github.com/mode-io/mode-io-skills.git ~/.claude/skills/mode-io-skills

# Codex CLI
git clone https://github.com/mode-io/mode-io-skills.git ~/.agents/skills/mode-io-skills

# OpenCode
git clone https://github.com/mode-io/mode-io-skills.git ~/.config/opencode/skills/mode-io-skills

# Cursor
git clone https://github.com/mode-io/mode-io-skills.git ~/.cursor/skills/mode-io-skills

Safety skills:

# Basic usage
python scripts/safety.py -i "Delete all log files"
# With context and target
python scripts/safety.py -i "Modify database permissions" -c "Production environment" -t "/var/lib/mysql"
# When the content is in a file
python scripts/safety.py -i "$(cat instruction.txt)"

Privacy skills:

# Output only masked text (default)
python scripts/detect_local.py --input "Phone 138xxx45678 Email test@example.com"
# Output full JSON (originalText, sanitizedText, items, riskScore, riskLevel)
python scripts/detect_local.py --input "Phone 138xxx45678 Email test@example.com" --json
# Name detection is built in (field-anchored)
python scripts/detect_local.py --input "Name: John Doe Phone 138xxx45678" --json
# Read from file
python scripts/detect_local.py --input "$(cat draft.txt)" --json

Install dependencies:

python -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt