JoshuaShepherd
- 405 skills
- 0 followers
- 1 repo stars
- 2 weeks ago last updated
- ▌ Scholarly Authority UI · joshuashepherdFront-end UI design expert for movemental-visual-editor-main's "Warm Scholarly Authority" dashboard design system. Use when building or restyling any dashboard page, content/course card, editor surface, list/detail view, shell chrome, or component to match the existing visual language. Anchors to src/app/globals.css (@theme tokens), the src/components/ui/* primitives, and golden pages like src/app/(dashboard)/content/page.tsx. Keywords: warm scholarly authority, cream paper, deep navy, amethyst sidebar, Newsreader, Inter, Manrope, Material Symbols, StatusChip, no-line rule, Tailwind v4, shadcn, Radix, design tokens, designer-dashboard.
- ▌ Scholarly Editorial UI · joshuashepherdFront-end UI design expert for the alan-hirsch app's "Scholarly Editorial / Plum & Parchment" design system. Use when building or restyling any page, section, hero, card, nav, or component in this repo — to match the existing visual language. Anchors to src/app/globals.css tokens, tailwind.config.ts, and _docs/_build/design/SCHOLARLY_EDITORIAL.md. Keywords: plum, parchment, Newsreader, Manrope, scholarly, editorial, tonal surfaces, no-line rule, shadcn, Radix, motion/react, design tokens, theming.
- ▌ Tailwind Design System · joshuashepherdBuild scalable design systems with Tailwind CSS v4, design tokens, component libraries, and responsive patterns. Use when creating component libraries, implementing design systems, or standardizing UI patterns.
- ▌ Security Setup · joshuashepherdHarden a Next.js 15 or Vite + Express app for production — Content Security Policy headers, rate limiting (Upstash Redis), CORS policy, API input validation, secret scanning, and security checklist. Use before launching any project or when auditing security posture.
- ▌ Tenant Migrate · joshuashepherdAudit and execute multi-tenant platform migration — determines what's needed when cloning a fully-built Movemental tenant (e.g. alan-hirsch) to bootstrap a new one (e.g. brad-brisco). Inspects Supabase via MCP, audits tenant config, env vars, feature flags, storage buckets, database org row, codebase leaks, middleware, and Vercel deployment. Does NOT handle visual theming (globals.css) or image assets — those are separate concerns. Use when onboarding a new thought leader onto the platform.
- ▌ Awesome Postgres · joshuashepherd bundleA curated list of awesome PostgreSQL software, libraries, tools and resources, inspired by awesome-m awesome postgres, python, database, postgres, postgresql. Use when you need awesome postgres capabilities. Triggers on: awesome postgres.
- ▌ Persisted Content Remediation · joshuashepherd bundleSafely audit and remediate persisted text/content fields in Supabase or Postgres when bodies are in the wrong format (HTML, Markdown, MDX, plain text, hybrid, JSON, empty). Use for content format drift, ingest bypass, wrong-field storage, leaked markup, or batch normalization — always audit-first, backup, dry-run, deterministic transforms, never AI-rewrite in place.
- ▌ Remotion Best Practices · joshuashepherd bundleBest practices for Remotion - Video creation in React
- ▌ Create Agent · joshuashepherdScaffold and develop AI agents using OpenAI Agents SDK patterns, covering agent definition, tools, guardrails, handoffs, context, RAG pipelines, streaming, API routes, testing, and debugging.
- ▌ Asset Series · joshuashepherdGenerate a visually consistent set of image assets using Nano Banana 2 for course covers, book headers, video thumbnails, and more.
- ▌ Fal AI Media · joshuashepherdGenerates images, videos, and audio using fal.ai models via MCP, covering text-to-image, text/image-to-video, text-to-speech, and video-to-audio.
- ▌ Book Ingest · joshuashepherdUpserts a validated MDX book corpus into Supabase via Drizzle, hydrating books, chapters, sections, and chunks tables while preserving stable bookmark anchors and only re-embedding changed content.
- ▌ Plain Prose · joshuashepherd bundleWrite clear, plain prose and strip register-jargon from text, using a costume-or-term-of-art test to preserve genuine technical terms.
- ▌ Prose Craft · joshuashepherdImproves or generates prose with sentence-level craft: rhythm, voice, sensory detail, pacing, and line-level revision across genres and styles.
- ▌ Week Author · joshuashepherdDrafts a complete course week in Alan Hirsch's voice, grounded in corpus material and following a canonical transformation-loop structure.
- ▌ Design Chain · joshuashepherdAudits and enforces a five-layer design chain (tokens, Tailwind, primitives, sections, pages) across components and pages, detecting hardcoded values, layer violations, dark mode parity issues, and missing primitives.
- ▌ Github · joshuashepherdInteract with GitHub using the `gh` CLI to check PR status, manage issues, review code, and query the API.
- ▌ Markitdown · joshuashepherd bundleConverts files and office documents to Markdown, supporting PDF, DOCX, PPTX, XLSX, images with OCR, audio with transcription, HTML, CSV, JSON, XML, ZIP, YouTube URLs, and EPubs.
- ▌ Stitch Build · joshuashepherdBuilds Google Stitch UI projects and generates screens from feature descriptions or export files by calling Stitch MCP tools directly, following Stitch prompting best practices.
- ▌ Stitch React · joshuashepherdConverts Stitch screen designs into production React components, fetching and caching assets locally, extracting design tokens, and archiving existing pages before replacement.
- ▌ Studio Style · joshuashepherdGenerates a focused style foundation prompt for AI Studio, building exactly three exemplary sections—hero, typography, and card grid—to establish a reusable visual language for any subsequent development.
- ▌ Fragmentation Story · joshuashepherdMaps where a movement leader's content and relationships live, producing a fragmentation report from existing research files.
- ▌ Madden Youtube Meta · joshuashepherd bundleTurns strategy-first Madden NFL YouTube videos into structured, game-ready notes covering meta snapshot, formations, plays, adjustments, and provenance, using transcripts and a curated source list.
- ▌ Tam Headshot Source · joshuashepherdAcquires a single verified headshot per named leader from official sources, with identity checks and a provenance manifest, avoiding bulk scraping.
- ▌ Add Guardrail · joshuashepherdAdds input and output guardrails to an agent, including validation, content filtering, domain scoping, and rate limiting, with TypeScript examples and wiring instructions.
- ▌ Career · joshuashepherdManages career workflows: resume review and scoring, job evaluation with apply recommendations, rubric development, content extraction from conversations, and pipeline quality audits.
- ▌ Typeset · joshuashepherdImproves typography by fixing font choices, hierarchy, sizing, weight consistency, and readability, making text feel intentional and polished.
- ▌ Article Author · joshuashepherdWrites a complete evergreen pillar article in the author's voice, including source research, SEO/GEO architecture, and citations.
- ▌ Book Citations · joshuashepherd bundleRestores and normalizes footnotes/endnotes in books by extracting from PDF/EPUB, matching anchors, staging markers, and compiling to HTML with assertions.
- ▌ Movemental PDF · joshuashepherd bundleCollates a movement leader's voice and theme documents into a professionally styled PDF using WeasyPrint.
- ▌ Ssot Dashboard · joshuashepherd bundleDesigns and structures the Movemental living SSOT dashboard (HTML/CSS/JS), aligning docs into a docs-first, token-based, agent-friendly dashboard.
- ▌ Voice Designer · joshuashepherdBuilds detailed voice profiles for characters, narrators, brands, or AI agents, covering diction, syntax, rhythm, worldview, signature patterns, and failure modes, and can reverse-engineer profiles from writing samples or audit existing ones.
- ▌ Youtube Scrape · joshuashepherdScrapes YouTube channel or video metadata via the YouTube Data API, downloads transcripts with yt-dlp, chunks them for search, and upserts results into a database.
- ▌ Add Tool · joshuashepherdCreates or modifies agent tools for OpenAI Agents SDK, covering search, analysis, API integration, and database query patterns with caching and metrics.
- ▌ Remotion · joshuashepherd bundleCreates programmatic videos with React using Remotion, covering compositions, animations, motion graphics, and MP4 rendering, plus walkthrough and content-to-animation workflows.
- ▌ New Page · joshuashepherdScaffold a new public page under the (public) route group, following project conventions for server components, tenant config, and shadcn/ui styling.
- ▌ Docs Setup · joshuashepherdBootstraps a two-part _docs directory (_build/ for technical docs, _public/ for research and proposals) with a CONSTITUTION.md governing the split, and can audit or migrate an existing structure.
- ▌ Doc Coauthoring · joshuashepherdGuides users through a structured three-stage workflow for co-authoring documents, from context gathering to reader testing.
- ▌ Stitch To React · joshuashepherd bundleMigrates a Stitch screen to production React: fetches and caches wireframes, archives existing pages, converts to shadcn/ui components with semantic tokens, and documents the design system layers.
- ▌ React Components · joshuashepherd bundleConverts Stitch designs into modular Vite and React components, using MCP networking and AST-based validation to ensure code quality.
- ▌ Agent RAG · joshuashepherdBuild or modify a RAG retrieval pipeline with vector store search, corpus routing, citation rendering, and book fidelity enforcement.
- ▌ Build RAG · joshuashepherdBuilds or modifies a RAG pipeline with intent-based routing, vector store search, citation rendering, and book fidelity enforcement.
- ▌ PDF Ebook · joshuashepherdConverts markdown, text, or HTML files into a styled PDF e-book using WeasyPrint, with support for directories, custom styling, and metadata.
- ▌ Generate · joshuashepherdRegenerates a specific code layer (schemas, services, routes, hooks, ui) or all layers, then runs the corresponding validation checks.
- ▌ Book Fix · joshuashepherdGenerates or executes a remediation prompt for a book flagged YELLOW or RED by /book-audit, writing a fix-<book-slug>.md that enumerates defects with verbatim PDF source text and verification commands, then optionally executes the fixes to bring the book to GREEN.
- ▌ Animation · joshuashepherdAdd scroll animations, micro-interactions, or page transitions to a component using GSAP, with reduced-motion support and performance best practices.
- ▌ API Data Sources · joshuashepherdResearches authoritative APIs and data sources for a project, producing per-API docs, a data catalog, and an integration blueprint for a React + Supabase + Vercel + AI stack.
- ▌ Audit Experience · joshuashepherdAudits the course learn experience for section coverage, sidebar rendering, layout, design token compliance, tenant isolation, accessibility, data flow, and component quality. Use when reviewing course UI code quality or diagnosing learn experience issues. Pass a course slug or "all".
- ▌ Coding Standards · joshuashepherdApplies universal TypeScript, JavaScript, React, and Node.js quality conventions for this repo. Use when reviewing or writing TS/TSX, refactoring for clarity, or enforcing naming, immutability, and error-handling patterns.
- ▌ Docs Type Safety · joshuashepherdAudits type-safety documentation against the live codebase, checking for drift from validators and folder layout.
- ▌ Pathway Supabase · joshuashepherdPulls pathway, book, course, article, and content item records from a Supabase database for the alan-hirsch tenant, organizes them by portal, and exports the results as markdown files into a local docs repository.
- ▌ Responsive Audit · joshuashepherdAudits and fixes responsive design issues across specified pages or sections, covering breakpoint coverage, layout collapse, touch targets, typography scaling, overflow, and navigation, with mobile-first enforcement for Next.js and Tailwind projects.
- ▌ Agent Test · joshuashepherdWrites unit, smoke, and e2e tests for AI agents, covering tools, instructions, routing, citations, and guardrails.
- ▌ Agent Tool · joshuashepherdCreates or modifies OpenAI Agents SDK tools with Zod parameters, caching, metrics, and agent registration, following established patterns and best practices.
- ▌ Asset Edit · joshuashepherdRefine existing images through conversational edits using Nano Banana 2, covering color grading, composition, element changes, style transfer, and cleanup with iterative refinement.
- ▌ Add Table · joshuashepherdAdds a new database table and generates all six layers of the platform codebase, from schema to UI, with validation at each step.
- ▌ Course UX · joshuashepherdAudits and improves course player UX against LMS best practices, covering layout proportions, progressive disclosure, progress psychology, sidebar hierarchy, video sizing, light/dark harmony, sidebar naming, cohort pacing, and AI integration points.
- ▌ Affiliation Audit · joshuashepherdAudits scraped affiliation data against logo strip and social proof best practices, evaluating logo quality, grouping, copy framing, prominence ordering, and strip readiness.
- ▌ Data Storytelling · joshuashepherdTransform raw data into compelling narratives with structured story frameworks, visualization techniques, and presentation templates for executive audiences.
- ▌ Pathway Collector · joshuashepherdScans local repositories and a Supabase database to inventory all pathway, portal, and theme content, producing a categorized report organized by portal.
- ▌ Pathway Organizer · joshuashepherdOrganizes discovered pathway, portal, and theme content into a docs repository by copying new files, resolving duplicates, updating the README, and generating per-portal indexes.
- ▌ Type Safety Chain · joshuashepherdImplements or verifies the six-layer type safety chain from Drizzle schema through Zod, services, API routes, and React hooks, including regeneration after DB changes and bootstrapping in new folders.
- ▌ Wsl Cursor Health · joshuashepherd bundleDiagnoses WSL2 and Cursor/Claude performance issues on Windows, including memory, swap, disk, caches, and configuration, then recommends safe fixes.
- ▌ Agent Trace · joshuashepherdDebug agent execution by querying trace and metric tables, analyzing tool calls, durations, errors, and performance trends.
- ▌ Asset Audit · joshuashepherdAudits image assets across a project to find missing, broken, or mismatched images, and generates prompts for missing assets.
- ▌ Alan Voice · joshuashepherdWrite, edit, or audit content in Alan Hirsch's exact voice using five voice markers, argument patterns, rhetorical posture, and failure mode guards.
- ▌ Book Audit · joshuashepherdRuns a deterministic, sample-based quality audit comparing original PDF/EPUB source against converted Markdown, flagging discrepancies and producing a GREEN/YELLOW/RED status report.
- ▌ Book Chunk · joshuashepherdChunks a book into canonical retrieval units with heading-aware structure splitting, recursive token targets, and contextual prefixes for downstream RAG ingestion.
- ▌ Icon System · joshuashepherdEstablishes or validates a canonical Icon wrapper component, size token scale, stroke weight conventions, and illustration usage standards for a project, creating src/components/ui/icon.tsx and documenting the system.
- ▌ Stitch Loop · joshuashepherdIteratively builds websites with Stitch by reading a baton file, generating pages, integrating them, and passing the next task.
- ▌ Affiliation Scrape · joshuashepherdResearches a leader's organizational affiliations and fetches logos, producing a JSON record for logo strips and social-proof sections.
- ▌ Design Chain Audit · joshuashepherdAudits a codebase against a multi-layer design system, checking token, primitive, component, and layout drift with automated grep checks and severity ratings.
- ▌ Transcript To Docs · joshuashepherdTransforms video or audio transcripts into structured markdown documentation, organizing content by topic with configurable styles and source attribution.
- ▌ Youtube Transcript · joshuashepherdExtracts a YouTube transcript with yt-dlp, cleans it while preserving all substantive speech, and saves a structured markdown file with metadata, overview, and optional timestamps.
- ▌ Agent Create · joshuashepherdScaffolds a new OpenAI Agents SDK agent with instructions, tools, API route, and bridge wiring, following existing project conventions.
- ▌ Agent Stream · joshuashepherdDebug and modify agent streaming behavior, covering SSE and plain-text transports, ChatKit events, and session continuity.
- ▌ Debug Traces · joshuashepherdInvestigates slow responses, tool failures, and guardrail rejections by querying agent trace logs and performance metrics.
- ▌ Asset Mockup · joshuashepherdPlaces generated images into realistic device and print mockups such as laptops, phones, books, posters, and billboards for marketing previews and presentations.
- ▌ Validate · joshuashepherdRuns bottom-up type-chain validation across database, hooks, and UI layers, then fixes errors at the failing layer for project health checks before large changes.
- ▌ Env Setup · joshuashepherdScaffolds or audits Zod-validated environment variables for a Next.js service, including src/lib/env.ts, .env.example, scripts/check-env.ts, and pnpm check:env. Use when adding env vars, auditing process.env usage, or aligning with deployment secrets.
- ▌ Summarize · joshuashepherdSummarizes, condenses, or extracts text, transcripts, and key points from URLs, articles, web pages, PDFs, podcasts, YouTube videos, and local files. Acts as a fallback transcription tool when the user asks to transcribe, digest, recap, or get the gist of a link, video, or document.
- ▌ Art · joshuashepherd bundleGenerates illustrations, diagrams, flowcharts, infographics, thumbnails, comics, and icons using multiple rendering backends, with workflows for various visual content types.
- ▌ Audit Docs · joshuashepherdAudits type safety documentation against the live codebase and fixes errors, gaps, or stale information to keep docs authoritative.
- ▌ Claude API · joshuashepherdBuilds or debugs Anthropic Claude integrations using @anthropic-ai/sdk, covering messages, tool use, extended thinking, prompt caching, and streaming.
- ▌ Gemini API · joshuashepherdBuilds or debugs Google Gemini features using @google/generative-ai, covering generateContent, function calling, grounding, multimodal input, and streaming, with guidance for editing src/lib/ai/clients/google.ts.
- ▌ Gpt Export · joshuashepherdGenerates a complete Custom GPT knowledge package from the current workspace project, producing 20 markdown documentation files plus optimized custom instructions for a strategic consultant.
- ▌ Icon Audit · joshuashepherdAudits icon usage in a codebase, enforcing lucide-react as the single icon library, correct sizes, semantic colors, and accessibility standards, then applies fixes.
- ▌ Openai API · joshuashepherdBuilds or debugs OpenAI Chat Completions, Responses API, and OpenAI Agents SDK patterns, including function calling, structured output, streaming, and handoffs.
- ▌ Page Audit · joshuashepherdAudits any movemental.com page across UI, content, architecture, UX, and conversion, then writes a markdown report and a standalone fix prompt.
- ▌ Find Skills · joshuashepherdDiscovers and installs agent skills from the open ecosystem using the Skills CLI, helping users find capabilities for tasks like web development, testing, and design.
- ▌ Alan Course · joshuashepherdWrites Alan Hirsch's 8-week transformational course content, including video scripts, readings, case studies, reflection questions, and field experiments, in his voice with formation-over-information pedagogy.
- ▌ Color Audit · joshuashepherdAudits a color palette for semantic token completeness, WCAG contrast compliance, 60-30-10 distribution, and tonal stacking correctness, with a focus on a light-primary site.
- ▌ Network Map · joshuashepherdReads existing per-leader research files to map co-authorships, endorsements, and organizational ties across movement leaders, producing a cross-leader network graph with clusters, bridges, and isolates.
- ▌ Trigger Dev · joshuashepherdBuild and manage Trigger.dev v4 background jobs: durable TypeScript tasks, scheduled/cron jobs, waits, Realtime, React hooks, and the Management API, with live docs fetched first.
- ▌ Alan Article · joshuashepherdWrites cornerstone articles in Alan Hirsch's voice with SEO/GEO architecture, corpus research, and citations to drive organic discovery.
- ▌ Alan Pathway · joshuashepherdWrites or updates pathway pages for Alan Hirsch's platform, following a 12-section architecture that grounds frameworks in Scripture and story, offers practices, and invites course-based formation.
- ▌ Article Plan · joshuashepherdPlan an evergreen article with pillar assignment, keyword strategy, section outline, source references, internal links, and CTA.
- ▌ Audio Scrape · joshuashepherdDiscovers podcasts via the iTunes Search API, parses RSS feeds, downloads audio, transcribes with OpenAI Whisper, chunks transcripts, and upserts results into a database table.
- ▌ Design Audit · joshuashepherdAudits a page or component against the Digital Curator design spec and movemental conventions, checking visual quality, accessibility, token compliance, and consistency before shipping.
- ▌ Resume Coach · joshuashepherdReviews resumes for formatting, design, content, and job-specific fit; scores job postings for fit and interview odds; develops rubrics; extracts content from conversations; and audits the resume generation pipeline.