ai-agent-lint - SKILL.md Agent Skill

name: ai-agent-lint description: AI Agent code quality check - Use Ruff to check code standards for LangChain, AutoGen, and other AI Agent projects

AI Agent Lint Skill

📋 Overview

This skill uses Ruff (an extremely fast Python linter) to check AI Agent project code quality, specifically targeting:

LangChain applications
AutoGen multi-agent systems
CrewAI collaborative agents
General AI Agent development projects

🔧 Prerequisites

Tool	Min Version	Check Command	Installation
Python	3.10+	`python --version`	python.org
Ruff	0.1.0+	`ruff --version`	`pip install ruff`

Note: If Ruff is not installed, the script will provide a friendly prompt instead of failing.

🚀 Usage

Method 1: Use AI Assistant

Tell the AI directly:

"Use ai-agent-lint skill to check my project"

AI will automatically:

Read this SKILL.md to understand usage
Execute the check script
Report found issues

Method 2: Run Script Directly

Windows (PowerShell):

.\.agent\skills\ai-agent-lint\scripts\lint.ps1

Linux/Mac (Bash):

./.agent/skills/ai-agent-lint/scripts/lint.sh

Method 3: Specify Target Directory

# Windows
.\.agent\skills\ai-agent-lint\scripts\lint.ps1 -Path ".\src"

# Linux/Mac
./.agent/skills/ai-agent-lint/scripts/lint.sh src

🎯 What It Checks

Python Code Standards

✅ PEP 8 style compliance
✅ Type hint completeness
✅ Import statement ordering
✅ Unused variables and imports
✅ Code complexity check

AI Agent Specific Checks

✅ Prompt template string safety
✅ Hardcoded API key detection
✅ Async code patterns
✅ Error handling completeness
✅ Resource leak detection (unclosed LLM clients)

Security Checks

⚠️ eval() and exec() usage warnings
⚠️ SQL injection risks
⚠️ Sensitive data logging
⚠️ Unsafe deserialization

📊 Output Example

🔍 AI Agent Lint - Checking project...

📁 Scanning directory: C:\Users\WJ\Desktop\MyAgent
📦 Detected: LangChain project

✅ src/main.py - No issues
⚠️  src/agent.py:15:1 - F401 [unused-import] 'os' imported but unused
❌ src/config.py:23:5 - S105 [hardcoded-password-string] Possible hardcoded password

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 Check Results:
   ✅ Passed: 45 files
   ⚠️  Warnings: 3 issues
   ❌ Errors: 1 issue
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💡 Tip: Run 'ruff check --fix' to auto-fix some issues

⚙️ Configuration

Create pyproject.toml or ruff.toml in the project root to customize rules:

# pyproject.toml
[tool.ruff]
line-length = 88
target-version = "py310"

[tool.ruff.lint]
select = [
    "E",    # pycodestyle errors
    "W",    # pycodestyle warnings
    "F",    # pyflakes
    "I",    # isort
    "N",    # pep8-naming
    "S",    # flake8-bandit (security)
    "B",    # flake8-bugbear
    "C90",  # mccabe complexity
]
ignore = ["E501"]  # Ignore line length limit

[tool.ruff.lint.per-file-ignores]
"__init__.py" = ["F401"]  # Allow unused imports in __init__.py

🔗 Related Resources

🆘 FAQ

Q: What if Ruff is not installed?
A: The script will detect and prompt installation: pip install ruff

Q: Can it be integrated into CI/CD?
A: Yes! Add to GitHub Actions:

- name: Lint AI Agent Code
  run: |
    pip install ruff
    ruff check .

Q: How to auto-fix issues?
A: Run ruff check --fix or use the script's --fix parameter

Q: Does it support other AI frameworks?
A: Yes, it supports all Python-based AI Agent frameworks with universal rules