HafizFasih

Parse PDF, DOCX, XLSX, and PPTX documents in a microservices context. Use when building the Media Processor service (Phase 9) for document text extraction. Covers BytesIO streaming, standardized JSON output, async wrappers for CPU-bound operations. NOT for desktop automation, file editing, or document creation.

Design multi-agent architectures for complex tasks. Use when single-agent context limits are exceeded, when tasks decompose naturally into subtasks, or when specializing agents improves quality. Includes OpenAI Agents SDK patterns (handoffs, as_tool) required for OmniChat Phase 5. Covers Triage routing, context passing, and streaming specialist patterns.

Generate Redis pub/sub event publisher and subscriber patterns. Use when: (1) Broadcasting events between services, (2) Implementing event-driven patterns, (3) Real-time notifications, (4) Decoupling service communication. Builds on redis-pattern skill with domain-specific event types and handlers. NOT for task queues (use redis-pattern task-queue instead).

Builds AI agents using OpenAI Agents SDK with async/await patterns and multi-agent orchestration. Use when creating tutoring agents, building agent handoffs, implementing tool-calling agents, or orchestrating multiple specialists. Covers Agent class, Runner patterns, function tools, guardrails, and streaming responses. Includes OmniChat distributed patterns: LLM Gateway routing, Persistence bridge, Event Publisher integration, and remote tool stubs. NOT when using raw OpenAI API without SDK or other agent frameworks like LangChain.

Implement backend SSE (Server-Sent Events) infrastructure for real-time AI response streaming. Use when building the Stream Broker service, Redis Pub/Sub listeners, or SSE endpoints. Covers sse-starlette integration, connection management, heartbeats, and event routing. NOT for frontend consumption patterns - this is backend infrastructure only.

Build production RAG systems with semantic chunking, incremental indexing, and filtered retrieval. Use when implementing document ingestion pipelines, vector search with Qdrant, or context-aware retrieval. Covers chunking strategies, change detection, payload indexing, and context expansion. NOT when doing simple similarity search without production requirements.

Production-grade Docker containerization for Python and Node.js applications. This skill should be used when users ask to containerize applications, create Dockerfiles, dockerize projects, or set up Docker Compose. Auto-detects project structure, analyzes .env for secrets, validates security, and generates tested Dockerfiles.

Build production-grade FastAPI backends with SQLModel and JWT authentication. Use when building REST APIs with Neon PostgreSQL, implementing layered architecture (Controller-Service-Repository), or creating CRUD endpoints with JWT/JWKS verification. NOT when building simple scripts or non-microservice architectures.

A definitive guide to implementing the OpenAI ChatKit UI, ensuring seamless connection to backend Agents and correct rendering of streaming events.

A strict security and implementation guide for Better Auth, focusing on schema extension for personalization and seamless Express.js integration.

A strict protocol for using Context7 tools to fetch accurate, up-to-date documentation without hallucinating library IDs.

A pedagogical framework for explaining complex Physical AI concepts with clarity, empathy, and effective scaffolding.

A definitive guide to high-performance, async-first FastAPI development using Pydantic v2 and Python 3.12+ standards.

A specialized guide for Docusaurus i18n, focusing on bidirectional layout (LTR/RTL) support and accurate Urdu translation integration.

A specialized guide for Serverless Postgres development, enforcing connection pooling, schema-as-code, and MCP-driven database inspection.

A definitive guide to building multi-agent systems using the `openai-agents` SDK, enforcing live documentation retrieval via Context7.

Monitor system health, detect errors, implement recovery procedures, restart failed processes, maintain audit logs. Use for system health checks, error recovery, process monitoring, or when user mentions "system status", "errors", "logs".

Autonomously audit business and financial performance weekly. Analyzes revenue, expenses, completed tasks, bottlenecks, and generates executive briefing with proactive suggestions. Use when generating weekly report, business audit, or when user mentions "briefing", "ceo report", "performance summary", "weekly audit", "business review".

Integrate with Xero accounting system to sync transactions, categorize expenses, track revenue, generate invoices, and maintain financial records. Use when syncing bank transactions, categorizing expenses, creating invoices, checking financial status, or when user mentions "accounting", "xero", "expenses", "revenue", "invoice", "financial report", "reconcile".

Create structured Plan.md files for complex multi-step tasks. Analyzes task requirements, breaks them down into actionable steps with estimates, identifies dependencies between steps, flags steps requiring human approval, and generates comprehensive plans with success criteria. Use when task requires planning, user asks to "create a plan", "plan this task", "break this down", "what are the steps", or when task has multiple components or dependencies.

Manage human-in-the-loop approval workflow for sensitive actions like payments, email sending, social media posts, and file operations. Creates structured approval requests, monitors approval status in /Approved and /Rejected folders, executes approved actions safely, and maintains complete audit logs. Use when any action requires approval, user mentions "check approvals", "pending approval", "approve this", "what needs approval", or before executing sensitive operations like payments, emails, or social posts.

Process emails from Gmail Watcher, categorize by priority (urgent/normal/low), draft appropriate responses using templates, flag items requiring immediate attention. Use when processing emails, checking inbox, handling Gmail notifications, or user mentions "email", "inbox", "gmail", "messages", "check mail", "respond to email".

Process pending tasks, check Needs_Action folder, complete task requests, move finished work to Done folder, and update activity dashboard. Use when the user asks to "process tasks", "check pending tasks", "handle Needs_Action items", "complete my tasks", "check what needs to be done", or mentions the Needs_Action folder, task processing, or wants to see completed work moved to Done.

Guides the professional implementation of application configuration using pydantic-settings and .env files. Use when the user needs to manage environment variables, validate config schemas, or structure settings for agents and web apps (FastAPI, etc.).

Manages Python projects using UV package manager exclusively. Use when users need to create Python projects, manage dependencies, handle virtual environments, or work with Python packages. This skill enforces UV workflows for all Python package operations including installing packages, creating projects, managing dependencies, running scripts, and building distributions. NOT when working with existing pip/poetry projects that user explicitly wants to keep unchanged.

Build production-grade FastAPI backends with SQLModel, Pydantic settings, and JWT authentication. Use when building REST APIs with PostgreSQL, implementing environment-based configuration with .env files, creating CRUD endpoints with JWT/JWKS verification, or setting up pydantic-settings for app configuration. NOT when building distributed microservices with Dapr (use scaffolding-fastapi-dapr for that).

Builds AI agents using OpenAI Agents SDK with async/await patterns and multi-agent orchestration. Use when creating tutoring agents, building agent handoffs, implementing tool-calling agents, or orchestrating multiple specialists. Covers Agent class, Runner patterns, function tools, guardrails, and streaming responses. NOT when using raw OpenAI API without SDK or other agent frameworks like LangChain.

Design tools that agents can use effectively. Use when creating new tools for agents, debugging tool-related failures, or optimizing existing tool sets.

A definitive guide to building multi-agent systems using the `openai-agents` SDK, enforcing live documentation retrieval via Context7.

A strict protocol for architecting Model Context Protocol (MCP) servers using FastMCP Python SDK, enforcing Tools vs Resources separation, type safety for LLM schema generation, and context-first thinking.

A strict security and implementation guide for Better Auth, focusing on schema extension for user profiles and seamless Express.js integration.

A specialized guide for Serverless Postgres development, enforcing connection pooling, schema-as-code, and MCP-driven database inspection.

A comprehensive guide for building production-grade Next.js 14+ applications with App Router, enforcing Server Components by default, optimal data fetching patterns, and modern React best practices.

Activates the 'Swarm Orchestrator' for building multi-agent systems with the openai-agents SDK. Enforces a 'Live Docs First' approach to verify syntax via Context7, preventing API hallucinations. Use this for architecting robust agent handoffs, type-safe tools, and seamless integration with FastAPI.

Activates the 'Framework Purist' persona for high-performance FastAPI development. Enforces best practices: async hygiene, Pydantic v2 validation, Python 3.12+ typing, and dependency injection. Use this for building secure, scalable, and idiomatic backend APIs that adhere to strict architectural standards.

Activates the 'Modern React Architect' for Next.js 14+ App Router development. Enforces Server Components by default, optimal data fetching, and SEO best practices. Use this to build performant, type-safe web applications that strictly follow Next.js file conventions and minimize client-side JavaScript.