🎯

opencv

🎯Skill
g1joshi/agent-skills1 InstallsAdded Feb 10, 2026

Installation

$npx skills add g1joshi/agent-skills --skill opencv

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/opencv
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/opencv/
  • All projects ~/.claude/skills/opencv/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

Expert OpenCV assistance covering computer vision, image filtering, edge detection, contour analysis, and real-time video processing. Use when processing visual data, building camera pipelines, or object detection.

OpenCV

OpenCV (Open Source Computer Vision Library) is the standard library for real-time computer vision, image processing, camera calibration, and deep learning model inference.

When to Use

  • Real-Time Computer Vision & Video Processing: Frame-by-frame analysis of camera feeds, robotics, and industrial automation.
  • Image Preprocessing for Deep Learning: Resizing, normalizing, thresholding, and color-space conversions.
  • Edge, Contour & Shape Detection: Canny edge detection, Hough transforms, and bounding box polygon calculations.
  • Feature Matching & Homography: Aligning perspectives and matching keypoints with ORB and SIFT.

Quick Start

import cv2

# Load image, convert to grayscale, apply Gaussian blur and Canny edge detection
img = cv2.imread("input.jpg")
gray = cv2.cvtColor(img, cv2.COLOR_BGR2GRAY)
blurred = cv2.GaussianBlur(gray, (5, 5), 0)
edges = cv2.Canny(blurred, threshold1=50, threshold2=150)

cv2.imwrite("edges.jpg", edges)

Core Concepts

Image Preprocessing, Thresholding & Contours

Detecting object shapes and drawing bounding boxes:

import cv2
import numpy as np

# Load image in grayscale
image = cv2.imread('circuit_board.jpg')
gray = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY)

# Apply Gaussian blur to reduce high-frequency noise
blurred = cv2.GaussianBlur(gray, (5, 5), 0)

# Canny edge detection
edges = cv2.Canny(blurred, threshold1=50, threshold2=150)

# Find contours in the binary edge image
contours, _ = cv2.findContours(edges, cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)

output = image.copy()
for cnt in contours:
    area = cv2.contourArea(cnt)
    if area > 100: # Filter small noise specks
        x, y, w, h = cv2.boundingRect(cnt)
        cv2.rectangle(output, (x, y), (x + w, y + h), (0, 255, 0), 2)
        cv2.putText(output, f"Area: {int(area)}", (x, y - 5), cv2.FONT_HERSHEY_SIMPLEX, 0.5, (0, 255, 0), 1)

cv2.imwrite('detected_components.jpg', output)

Color Space Filtering with HSV Masking

Isolating colored objects independent of scene brightness:

# Convert to Hue-Saturation-Value (HSV)
hsv = cv2.cvtColor(image, cv2.COLOR_BGR2HSV)

# Define range for blue color in HSV
lower_blue = np.array([100, 150, 50])
upper_blue = np.array([140, 255, 255])

# Threshold image to obtain binary mask
mask = cv2.inRange(hsv, lower_blue, upper_blue)

# Bitwise-AND mask and original image
blue_segmented = cv2.bitwise_and(image, image, mask=mask)
cv2.imwrite('blue_segmented.jpg', blue_segmented)

Video Stream Processing Loop

Reading frames continuously from a camera feed or video file:

cap = cv2.VideoCapture(0) # 0 = default webcam

while cap.isOpened():
    ret, frame = cap.read()
    if not ret:
        break

    # Process frame
    gray_frame = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)

    cv2.imshow('Live Monitor', gray_frame)
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()
cv2.destroyAllWindows()

Common Patterns

Real-Time Video Stream Processing with FPS Throttling

Problem: Processing high-resolution webcam frames in Python causes frame buffering lag.

Solution: Process frames in a tight loop with resolution resizing:

cap = cv2.VideoCapture(0)
# Set capture resolution
cap.set(cv2.CAP_PROP_FRAME_WIDTH, 640)
cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 480)

while cap.isOpened():
    ret, frame = cap.read()
    if not ret: break

    # Process frame
    gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
    cv2.imshow('Live Stream', gray)

    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()
cv2.destroyAllWindows()

Best Practices

Do:

  • Remember OpenCV stores images in BGR format by default; convert with cv2.COLOR_BGR2RGB before Matplotlib/PyTorch.
  • Always release hardware resources (cap.release()) and destroy windows (cv2.destroyAllWindows()).
  • Use HSV or LAB color spaces rather than RGB when performing color-based segmentation under varying lighting.
  • Apply Gaussian or bilateral blurring prior to edge detection to suppress noise.

Don't:

  • Perform heavy deep learning inferences sequentially inside the video capture loop; use background threads.
  • Hardcode kernel sizes with even numbers; blurring and morphological kernels should be odd (e.g. 3x3, 5x5).
  • Assume cv2.imread() succeeded without checking if the returned array is not None.

Troubleshooting

ErrorCauseSolution
cv2.error: (-215:Assertion failed) !ssize.empty()cv2.imread() returned None because file path was wrong.Verify image file exists at specified path and is non-empty.
OpenCV: FFMPEG: tag 0x... is not supported with codecIncompatible video codec FourCC code during VideoWriter initialization.Use cv2.VideoWriter_fourcc(*'mp4v') for MP4 video output.
Color distortion in exported imageDisplaying or saving BGR image as RGB (OpenCV default is BGR).Convert color space with cv2.cvtColor(img, cv2.COLOR_BGR2RGB).

References

More from this repository10