Menu
Python code style guidelines for HestAI MCP including type hints, imports, error handling, and docstrings
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | python-style |
| description | Python code style guidelines for HestAI MCP including type hints, imports, error handling, and docstrings |
| allowed-tools | ["Edit","Write","Read","Grep"] |
| triggers | ["python style","type hints","docstrings","python imports","ruff","black","mypy","PEP 8","python formatting"] |
===PYTHON_STYLE=== META: TYPE::SKILL VERSION::"1.0" STATUS::ACTIVE PURPOSE::"Python code style guidelines for HestAI MCP development" DOMAIN::HEPHAESTUS[craftsmanship]⊕ATHENA[precision]
§1::TYPE_HINTS REQUIREMENT::all_functions_require_type_hints[enforced_by_mypy] FORWARD_REFS::"from future import annotations" PREFER::[list,dict,set] AVOID::[List,Dict,Set][typing_module_deprecated] EXAMPLE::"def process(items: list[str]) -> dict[str, int]:"
§2::IMPORTS STYLE::absolute_imports_from_hestai_mcp ORDERING::ruff_handles_isort_style GROUPS::[ stdlib::first, third_party::second, local::third ] EXAMPLE::[ "from pathlib import Path", "from pydantic import BaseModel", "from hestai_mcp.schemas import SessionConfig" ]
§3::ERROR_HANDLING EXCEPTIONS::raise_specific[not_generic_Exception] DOCUMENTATION::document_exceptions_in_docstrings PATTERN::[ "try:", " result = risky_operation()", "except SpecificError as e:", " logger.error(f'Operation failed: {e}')", " raise" ]
§4::DOCSTRINGS STYLE::Google_style REQUIRED::public_functions_and_classes SECTIONS::[Args,Returns,Raises] EXAMPLE::[ """"Process items and return counts.", "", "Args:", " items: List of items to process.", " strict: If True, raise on invalid items.", "", "Returns:", " Dictionary mapping item names to counts.", "", "Raises:", " ValueError: If items is empty and strict is True.", """"" ]
§5::LINE_LENGTH MAX::100_characters ENFORCEMENT::[black,ruff]
§6::QUALITY_GATES COMMANDS::[ "python -m ruff check src tests scripts", "python -m black --check src tests scripts", "python -m mypy src" ] FIX_COMMANDS::[ "python -m black src tests scripts", "python -m ruff check --fix src tests scripts" ]
===END===
Supabase test harness patterns including local Supabase setup, test user creation via Auth Admin API, RLS testing, migration testing (db_reset), seed sequences, rate limiting, and environment detection. Use when setting up Supabase testing infrastructure, creating test users, troubleshooting Supabase test failures, or implementing RLS validation. Triggers on: supabase test setup, test user creation, supabase local testing, RLS testing, migration testing, supabase test harness, auth test helpers.
Supabase operational knowledge for migrations, RLS optimization, MCP tool benchmarks, and ADR-003 compliance. Use when validating database migrations, optimizing Row-Level Security policies, checking MCP tool performance, or ensuring Supabase operational standards. Triggers on: migration validation, RLS patterns, Supabase benchmarks, ADR-003, database state tracking, schema governance.
LLM-native structured communication format. Teaches OCTAVE syntax rules, canonical forms, and warning prevention for zero-error .oct.md authoring.
Advanced semantic vocabulary, holographic contracts, and structural patterns for OCTAVE. REQUIRES octave-literacy. Extends literacy with mythology, archetype annotation, v6 contracts, and anti-pattern rules.
Workflow for transforming prose into semantic OCTAVE structures. Covers tier selection, transformation phases, loss accounting, and decision rules. REQUIRES octave-literacy.
Strategic oversight mode for the Holistic Orchestrator. Episodic State Machine pattern with ho-liaison advisory (via pal_clink), run_debate escalation, and oa-router delegation. REPLACES holistic-orchestration when loaded.
