From 53d363ab61bcc2c180b827892fd8b57fc4f56d8c Mon Sep 17 00:00:00 2001 From: Gabor Torok Date: Mon, 9 Feb 2026 10:26:28 -0800 Subject: [PATCH] added some claude skills to aid with agentic development --- .claude/skills/check/SKILL.md | 20 ++++++++++++++++++++ .claude/skills/check/check.sh | 5 +++++ .claude/skills/dev/SKILL.md | 20 ++++++++++++++++++++ .claude/skills/dev/dev.sh | 5 +++++ .claude/skills/lint/SKILL.md | 24 ++++++++++++++++++++++++ .claude/skills/lint/lint.sh | 5 +++++ .claude/skills/logs/SKILL.md | 21 +++++++++++++++++++++ .claude/skills/logs/logs.sh | 5 +++++ .claude/skills/security/SKILL.md | 20 ++++++++++++++++++++ .claude/skills/security/security.sh | 5 +++++ 10 files changed, 130 insertions(+) create mode 100644 .claude/skills/check/SKILL.md create mode 100755 .claude/skills/check/check.sh create mode 100644 .claude/skills/dev/SKILL.md create mode 100755 .claude/skills/dev/dev.sh create mode 100644 .claude/skills/lint/SKILL.md create mode 100755 .claude/skills/lint/lint.sh create mode 100644 .claude/skills/logs/SKILL.md create mode 100755 .claude/skills/logs/logs.sh create mode 100644 .claude/skills/security/SKILL.md create mode 100755 .claude/skills/security/security.sh diff --git a/.claude/skills/check/SKILL.md b/.claude/skills/check/SKILL.md new file mode 100644 index 0000000..1b49065 --- /dev/null +++ b/.claude/skills/check/SKILL.md @@ -0,0 +1,20 @@ +# Check Skill + +Quick format and ruff linting check + +## Description + +This skill runs a quick validation check on the codebase by formatting code and running ruff linter. + +## Usage + +```bash +/check +``` + +## What it does + +- Runs `make format` to format code +- Runs `make ruff` for linting checks + +This is a fast validation step useful before committing changes. diff --git a/.claude/skills/check/check.sh b/.claude/skills/check/check.sh new file mode 100755 index 0000000..6e9dd88 --- /dev/null +++ b/.claude/skills/check/check.sh @@ -0,0 +1,5 @@ +#!/bin/bash +# name: check +# description: Quick format and ruff linting check + +make format && make ruff diff --git a/.claude/skills/dev/SKILL.md b/.claude/skills/dev/SKILL.md new file mode 100644 index 0000000..15a1507 --- /dev/null +++ b/.claude/skills/dev/SKILL.md @@ -0,0 +1,20 @@ +# Dev Skill + +Start the FastAPI development server with demo adapters + +## Description + +This skill starts the development server for the IRI Facility API, enabling local testing and development. + +## Usage + +```bash +/dev +``` + +## What it does + +- Runs `make dev` to start the FastAPI development server +- Loads demo adapters for testing + +Use this when you want to run the API locally for development or testing purposes. diff --git a/.claude/skills/dev/dev.sh b/.claude/skills/dev/dev.sh new file mode 100755 index 0000000..6261ba8 --- /dev/null +++ b/.claude/skills/dev/dev.sh @@ -0,0 +1,5 @@ +#!/bin/bash +# name: dev +# description: Start the FastAPI development server with demo adapters + +make dev diff --git a/.claude/skills/lint/SKILL.md b/.claude/skills/lint/SKILL.md new file mode 100644 index 0000000..bd7da13 --- /dev/null +++ b/.claude/skills/lint/SKILL.md @@ -0,0 +1,24 @@ +# Lint Skill + +Run full validation suite (format, ruff, pylint, audit, bandit) + +## Description + +This skill runs a comprehensive validation suite on the codebase, including formatting, linting, and security checks. + +## Usage + +```bash +/lint +``` + +## What it does + +- Runs `make lint` which executes: + - Code formatting checks + - Ruff linting + - Pylint analysis + - Pip-audit for dependency vulnerabilities + - Bandit security scanning + +This is the full pre-commit validation suite to ensure code quality and security before merging changes. diff --git a/.claude/skills/lint/lint.sh b/.claude/skills/lint/lint.sh new file mode 100755 index 0000000..00a913f --- /dev/null +++ b/.claude/skills/lint/lint.sh @@ -0,0 +1,5 @@ +#!/bin/bash +# name: lint +# description: Run full validation suite (format, ruff, pylint, audit, bandit) + +make lint diff --git a/.claude/skills/logs/SKILL.md b/.claude/skills/logs/SKILL.md new file mode 100644 index 0000000..67b706a --- /dev/null +++ b/.claude/skills/logs/SKILL.md @@ -0,0 +1,21 @@ +# Logs Skill + +Run dev server and capture logs to api.log + +## Description + +This skill starts the development server and captures all output (stdout and stderr) to a log file for review. + +## Usage + +```bash +/logs +``` + +## What it does + +- Runs `make dev` to start the development server +- Captures all output to `api.log` file +- Displays output in real-time while also saving to file + +Useful for debugging issues by having a persistent log file to review after the server runs. diff --git a/.claude/skills/logs/logs.sh b/.claude/skills/logs/logs.sh new file mode 100755 index 0000000..c405ece --- /dev/null +++ b/.claude/skills/logs/logs.sh @@ -0,0 +1,5 @@ +#!/bin/bash +# name: logs +# description: Run dev server and capture logs to api.log + +make dev 2>&1 | tee api.log diff --git a/.claude/skills/security/SKILL.md b/.claude/skills/security/SKILL.md new file mode 100644 index 0000000..d029815 --- /dev/null +++ b/.claude/skills/security/SKILL.md @@ -0,0 +1,20 @@ +# Security Skill + +Run security scans (pip-audit and bandit) + +## Description + +This skill performs security scanning on the codebase and dependencies to identify potential vulnerabilities. + +## Usage + +```bash +/security +``` + +## What it does + +- Runs `make audit` to check for known vulnerabilities in Python dependencies using pip-audit +- Runs `make bandit` to scan code for common security issues + +Use this regularly to ensure the codebase doesn't have known security vulnerabilities or insecure code patterns. diff --git a/.claude/skills/security/security.sh b/.claude/skills/security/security.sh new file mode 100755 index 0000000..bba2e86 --- /dev/null +++ b/.claude/skills/security/security.sh @@ -0,0 +1,5 @@ +#!/bin/bash +# name: security +# description: Run security scans (pip-audit and bandit) + +make audit && make bandit