nathanvale

Web scraping, site crawling, search, structured data extraction, and AI-powered research with Firecrawl CLI. Use when you need full page content as markdown, JS-rendered pages, anti-bot bypass, crawling entire documentation sites, extracting structured data with schemas, or deep web research. Prefer WebFetch for quick questions about a known URL. Prefer WebSearch for finding links without full content.

Build production-grade MCP (Model Context Protocol) servers with observability, correlation ID tracing, and dual logging. Use when creating new MCP servers, adding tools to existing servers, implementing file logging, debugging MCP issues, wrapping CLI tools with spawnSyncCollect, or following Side Quest marketplace patterns. Covers @side-quest/core/mcp declarative API, @side-quest/core/spawn CLI wrapper patterns, Zod schemas, Bun runtime, and 9 gold standard patterns validated across Kit plugin (18 tools). Includes error handling, response format switching, MCP annotations, and graceful degradation.

Unified inbox processor - handles ALL content types (clippings, transcriptions, VTT files, attachments) with parallel subagents and single-table review. Routes to appropriate creator based on proposed_template.

Build production-grade CLI tools with Bun. Reference implementation covering argument parsing patterns (--flag value, --flag=value, --flag), dual markdown/JSON output, error handling, subcommands, and testing. Use when building CLIs, designing argument parsing, implementing command structures, reviewing CLI quality, or learning Bun CLI best practices.

Pure Bun-native filesystem utilities from @side-quest/core/fs. Use when you need command-injection-safe filesystem operations, prefer Bun over node:fs, or want token-efficient fs helpers. All functions use Bun.spawn, Bun.file(), or Bun.write() - no node:fs dependencies.

Expert guidance for building and maintaining the Para Obsidian inbox processing system - a security-hardened automation framework for processing PDFs and attachments with AI-powered metadata extraction. Use when building inbox processors, implementing security patterns (TOCTOU, command injection prevention, atomic writes), designing interactive CLIs with suggestion workflows, integrating LLM detection, implementing idempotency with SHA256 registries, or working with the para-obsidian inbox codebase. Covers engine/interface separation, suggestion-based architecture, confidence scoring, error taxonomy, structured logging, and testing patterns. Useful when user mentions inbox automation, PDF processing, document classification, security-hardened file processing, or interactive CLI design.

Best practices for structured logging, correlation IDs, performance metrics, and debugging in Bun applications using @side-quest/core/logging and LogTape. Use when implementing logging, setting up observability, debugging production issues, tracking performance metrics, adding correlation IDs, configuring subsystem loggers, or working with JSONL log analysis. Covers plugin logger factory, hierarchical categories, log levels, metrics collection, and operational debugging workflows.

Guide for implementing structured logging in SideQuest plugins using @side-quest/core. Use when adding logging to new plugins, debugging existing plugins, or setting up log analysis.

Knowledge bank for building Claude Code skills -- skill anatomy, SKILL.md authoring, frontmatter fields, progressive disclosure, design patterns, distribution, and troubleshooting. Triggers on: build a skill, create a skill, write a skill, SKILL.md, skill frontmatter, what goes in SKILL.md, skill not loading, my skill isn't working, skill not triggering, get started with skills, how do skills work, skill structure, skill folder, skill description, skill name, allowed-tools, disable-model-invocation, user-invocable, argument-hint, context fork, skill subagent, progressive disclosure, reference files, bundled resources, skill patterns, distribute skill, share skill, publish skill, install skill, personal skill, project skill, plugin skill, enterprise skill, skill-creator, skill conventions, skill best practices, what is a skill, local vs project skill, skill testing, skill debugging.

Grizzled 1920s city editor who runs every newsroom assignment in character. Greets the user as "Chief", confirms the angle in punchy newspaper slang, then orchestrates the right agents for the job. Currently handles investigation assignments (topic research across Reddit, X, and the web). Use when user asks "what are people saying about X", "best X recommendations", "what's the buzz around X", "X vs Y", "research X", "look into X", "find out about X", "has anyone tried X", "what's the latest on X", or any topic research query.

Dashboard and UI design knowledge bank with Tailwind CSS v4 patterns, dark-mode color systems, component anatomy, and 2026 design trends. Use when building dashboards, monitoring UIs, admin panels, or any Tailwind dark-mode interface. Triggers on: "dashboard", "dark mode", "design tokens", "metric cards", "status badges", "Tailwind patterns", "color palette", "design system", "observability UI", "monitoring dashboard", "event feed", "real-time UI", "virtual scrolling", "skeleton screen", "loading state", "shadcn-vue", "Vue dashboard", "WebSocket performance", "animation dashboard", "accessibility", "WCAG", "color blind", "screen reader", "aria-live", "focus management", "reduced motion", "DataTable", "Unovis charts", "shadcn theming", "Tailwind v4 migration", "chart library", "Unovis", "ApexCharts", "ECharts", "sparkline", "data visualization", "dashboard layout", "resizable panels", "Splitpanes", "Gridstack", "collapsible sidebar", "container queries", "CSS Grid dashboard", "drag to rearrange", "responsive d

Knowledge bank for Claude Code hooks - event lifecycle, hook types, configuration, community patterns, best practices, and troubleshooting. Triggers on: claude code hooks, hook events, PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, hook configuration, settings.json hooks, auto-format hook, command hook, prompt hook, agent hook, hook not working, hook debug, PermissionRequest, SubagentStart, SubagentStop, Stop hook, PreCompact, SessionEnd.

Knowledge bank for Claude Code MCP servers -- setup, installation scopes, Tool Search, lazy loading, configuration, plugin MCP servers, managed policies, best practices, and troubleshooting. Triggers on: MCP server, MCP tools, add MCP, install MCP, .mcp.json, mcp configuration, mcp scope, local vs project vs user MCP, Tool Search, lazy loading, ENABLE_TOOL_SEARCH, MCP output limits, MAX_MCP_OUTPUT_TOKENS, MCP timeout, MCP not working, MCP server not connecting, mcp permission, managed-mcp.json, allowedMcpServers, deniedMcpServers, MCP in plugin, plugin MCP server, MCP resources, MCP prompts, remote MCP, SSE, stdio, HTTP MCP, MCP vs skills, when to use MCP, MCP cost, MCP context, mcp-server, connect tool, external tool.

Interactive skill builder that scaffolds complete Claude Code skills end-to-end. Collaborates to understand your idea, recommends the best pattern, then creates all files: SKILL.md with frontmatter, references/, scripts/, assets/. Use when: build me a skill, scaffold a skill, create a new skill, make a skill, help me build a skill, new skill from scratch, skill setup, set up a skill, I have an idea for a skill, skill scaffolding, generate a skill.

Staff-engineer-level review of Claude Code skills with structured grading and actionable uplift recommendations. Reads a skill, grades it across 8 dimensions (structure, description, body, invocation, progressive disclosure, triggers, content strategy, plugin integration), then generates a comprehensive remediation prompt you can use to fix everything. Use when: review my skill, audit a skill, grade my skill, skill review, is my skill good, what's wrong with my skill, improve my skill, uplift skill, skill health check, skill quality check, critique my skill, rate my skill.

Functional smoke testing for Claude Code skills. Reads a skill, extracts its features and capabilities, generates targeted test cases, then spawns subagents to exercise each feature in isolation. Tests what the skill can DO, not whether it follows conventions. Use when: smoke test my skill, test my skill, does my skill work, run skill tests, test skill features, functional test, exercise my skill, skill smoke test, verify my skill works, can my skill actually do this, skill QA.

Fix Node.js certificate trust issues behind corporate SSL-inspecting proxies. Use when discussing: VPN, corporate VPN, corporate proxy, SSL inspection, MITM proxy, TLS interception, NODE_EXTRA_CA_CERTS, self-signed certificate error, UNABLE_TO_VERIFY_LEAF_SIGNATURE, certificate chain, proxy CA, corporate network, Claude Code on VPN, Gemini CLI on VPN, npm behind proxy, Node.js certificate error, CAFile.pem, proxy-on, proxy-off, HTTPS_PROXY, HTTP_PROXY, openssl s_client, certificate extraction, corporate root CA, forward trust CA, trust store gap.

Generate an engaging, deep-dive explanation document (FOR_[NAME].md) that explains a codebase or domain in plain language with analogies, lessons learned, and practical wisdom.

Add or remove inline plugins from the ccdev function in dotfiles .zshrc

Start, stop, or check status of the Side Quest observability event server. Use when asked to start the server, stop the server, check server status, or manage the observability dashboard lifecycle.

Patterns for building CLIs that serve both humans and AI agents. Covers tri-modal output (JSON/JSONL/human), typed exit codes, structured error contracts, zero-dependency arg parsing, topic-based help, service discovery, field projection, and auto agent-mode detection. Reference implementation: @side-quest/observability CLI. Use when: building a CLI, adding a command, CLI output format, agent-friendly CLI, machine-readable output, JSON CLI contract, exit codes, --json flag, NDJSON streaming, how should my CLI work with agents, CLI design patterns.

Create and manage VS Code Bookmarks extension labeled bookmarks in .vscode/bookmarks.json. Use when the user wants to add navigation bookmarks to a codebase, trace data flows through code, mark important code locations, or set up labeled waypoints for code walkthroughs. Also use when user says "bookmark", "label this code", "mark this flow", or "add waypoints".

Decide whether a workflow should use CLI skills, MCP, or a hybrid approach. Use when planning agentic tooling, writing ADRs, or evaluating migrations between CLI and MCP.

Adversarial research -- biased teams argue opposite sides, a judge delivers the verdict. Use for comparing technologies, evaluating trade-offs, or resolving debates with structured evidence from Reddit, X, and the web. Do not use for single-source research or quick questions -- use /cortex-engineering:research instead.

Authenticate to npmjs.com using credentials from 1Password via op CLI. Automates username/password login, then triggers passkey 2FA via 1Password browser extension (single human click to approve). Handles Cloudflare challenges.

Set up npm publishing for a bun-typescript-starter repo. Automates token creation, first publish, OIDC trusted publishing, and GitHub secrets via npm-browser-agent. Use when a new repo needs publishing configured.

Sync governed hardening changes from a template repo into downstream repositories. Use when uplifting repos after starter-template changes, propagating workflow/release hardening, or preparing a sync PR from a known template commit range.

Git domain expert. Knows about: - Status, Switch, Create Branch, Commit, Pull, Push, Log Use when: - User asks about git operations - Context needed before starting work - Reviewing git status - Managing git workflow

Planning and architecture decision domain expert. Knows about: - Creating ADRs (Architecture Decision Records) - Creating technical specifications - Listing and discovering planning artifacts - Transforming plans into executable VTM tasks - Integrating with research tools (thinking-partner) Use when: - User wants to document an architectural decision - User needs to create a technical specification - User wants to explore or list existing ADRs/specs - User is ready to convert planning docs into tasks - User needs research before making a decision

Virtual Task Manager domain expert. Knows about: - Next, Context, Task, Start, Complete, Stats, List operations Use when: - User asks about task management operations - Context needed before starting work - Reviewing task status - Managing task workflow

Reference documentation for the xero-cli tool. Covers all commands, flags, output contracts, error codes, and safety rules. Claude loads this automatically when working with Xero bank transactions, reconciliation, account codes, or invoices.

Reconcile Xero statement lines and extract accounting data via the Xero API Explorer browser + xero-cli hybrid flow when OAuth scope is constrained. Use when the user asks to pull Xero data, extract ledgers, reconcile transactions, check reconciliation progress, remaining unreconciled transactions, or work around the OAuth 403 block.

Pattern knowledge for agentic orchestration. Teaches all 19 patterns across 9 stages: dispatch loops, DAGs, wave computation, retry, HOP, builder-validator, iterative refinement, fast path, spec files, idempotency, topological sort, task decomposition, team profiles, plugin architecture, difficulty routing, spec hardening, HITL, hydration, parallel dispatch, worktree isolation, browser validation, and the Ralph Wiggum visual retry loop. Use when: the user asks about agentic patterns, orchestration concepts, dispatch loops, DAG execution, wave computation, retry logic, higher-order prompts, builder-validator, spec files, fast path, iterative refinement, parallel execution, browser validation, or visual retry loops. Also use when an agent queries for pattern guidance.

Recommends agentic orchestration patterns for a given plan or problem description. Scores patterns against plan characteristics and provides ranked recommendations with handoff commands to the /dojo skill. Use when: the user describes a plan, architecture, or problem and wants to know which orchestration patterns apply. Also use when an agent needs pattern selection guidance.