JoshuaShepherd
- 405 skills
- 0 followers
- 1 repo stars
- 2 weeks ago last updated
- ▌ Article Corpus · joshuashepherdLook up passages, themes, and arguments from Alan Hirsch's book corpus — both from the local markdown files and the Supabase database. Use when researching what Alan actually says about a topic before writing an article. Returns quoted passages with proper citations.
- ▌ Author Content · joshuashepherdWrite course content for a specific element (M.N.X) of a transformational course — readings, video scripts, reflection questions, exercises, discussion prompts, and more. Use when authoring or generating course content for a specific week and element code.
- ▌ Content Ingest · joshuashepherdIngest, organize, and structure raw content (book chapters, transcripts, articles, research notes) into the repository's canonical format. Use when bringing new source material into the content library.
- ▌ Course Section · joshuashepherdCreate a new course section component following the existing section pattern. Use when adding new content types to courses.
- ▌ Dialogue Craft · joshuashepherdDialogue craft for fiction and conversational AI agents — subtext, character voice differentiation, pacing, exposition handling, conflict in conversation, and the art of what people don't say. Use when writing dialogue, designing agent conversation patterns, or auditing dialogue quality.
- ▌ Editorial Lens · joshuashepherdMulti-level editorial review — from developmental editing (structure, argument, arc) through line editing (prose quality, voice) to copy editing (grammar, consistency, fact-checking). Use when reviewing any written work or auditing an agent's output quality.
- ▌ Ingest Content · joshuashepherdIngest course content from markdown files or a content directory into the database — parsing, validating, and upserting weeks, lessons, reflection questions, discussion prompts, and exercises. Use when loading or re-loading course content into the platform database.
- ▌ Paratext Audit · joshuashepherdAudit paratext (supporting content) across all platform surfaces — courses, books, articles, exercises, field experiments, and reflection questions. Reports presence, voice quality, rendering gaps, and SEO/GEO readiness. Use before publishing content or to find what needs authoring.
- ▌ Pathway Author · joshuashepherdWrite or update content for a pathway page — any single section or a full pathway. Follows the canonical 12-section architecture, Alan Hirsch's voice, and SEO/GEO best practices. Use when writing new pathways, filling missing sections, or improving existing content.
- ▌ Zenwrite Design · joshuashepherd bundleDesign and build new UI for ZenWrite — the light-primary, distraction-free scholarly-writing app — the best possible way within its own design chain (Tokens → Primitives → Components → Built → Patterns). Newsreader serif + Manrope, brand-violet content sphere, sky/emerald/rose community sphere, React 19 + Tailwind v4 (CSS-first). Use whenever CREATING or EXTENDING a ZenWrite component, panel, screen, tile, overlay, wizard, or page — including "build a component," "add a panel," "make a new screen," "design a tile," "make this in our style," or "extend the editor." For reviewing/aligning existing UI, use the zenwrite-ui-audit skill instead.
- ▌ Tam Profile · joshuashepherdScore a movement leader's fit with the Movemental platform — a consulting deliverable (Fit Score 1–10, NOTs assessment, opportunity ladder). Distinct from the substrate. For the canonical research artifact, use `movement-leader-substrate`.
- ▌ Brainstorming · joshuashepherd bundleYou MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
- ▌ Review Scrape · joshuashepherdScrape book reviews from Goodreads and Amazon — fetches actual review text, ratings, dates, and reviewer metadata. Organizes by book, extracts quotable lines, analyzes sentiment patterns, and outputs structured markdown for copy strategy and social proof.
- ▌ Visual Scrape · joshuashepherd bundleExtract visuals (charts, diagrams, illustrations) from a PDF book and generate contextual markdown — each image paired with what it communicates and why it matters in context. Use when scraping book visuals.
- ▌ Stitch Download · joshuashepherdBrowse Stitch projects, download all screens (HTML + screenshots), and generate an organized local gallery with an index.html for browser viewing. Use when reviewing designs before conversion, comparing screens, or sharing with stakeholders.
- ▌ Stitch Variants · joshuashepherdGenerate design variants of existing Stitch screens to explore alternative approaches. Controls creative range, aspects to vary, and number of variants.
- ▌ Movement Leader Themes · joshuashepherd bundleDerives a movement leader's core themes from their book corpus and research, then authors docs/themes/CORE_THEMES.md (pathway taxonomy) and per-theme deep-dives (12-section pathway content, grounded and cited). Use when standing up or refreshing theme docs, generating docs/themes, running movement-leader-themes, or building pathway content for a movement leader. Requires voice guide for deep-dives — run movement-leader-voice first if missing.
- ▌ Video Researcher · joshuashepherdResearch real-world statistics, insights, and compelling data about online courses, completion rates, learning effectiveness, and transformative education — then organize findings into suggested video components, script lines, and data visualizations for course explainer videos. Use before scripting or updating video content.
- ▌ Storybook Setup · joshuashepherdSet up Storybook 8 for Next.js 15 or Vite + React — component dev environment, story scaffolding, shadcn/ui integration, dark mode toggle, accessibility checks (a11y addon), and visual regression snapshot configuration. Use when setting up a component library or design system workflow.
- ▌ Author Research · joshuashepherdDeep research for book authors — searches Google Scholar, Internet Archive, JSTOR, Google Books/Ngram, Library of Congress, HathiTrust, OECD/World Bank data, historic newspapers, and news archives. Produces an organized research dossier with primary sources, data, historical context, and full citations.
- ▌ Content Creator · joshuashepherdCreates engaging content for blogs, social media, and marketing materials with audience focus. Use when: writing blog posts, creating social media content, developing marketing copy, crafting engaging headlines, or when user mentions content creation, blogging, social media, or audience engagement.
- ▌ Course Scaffold · joshuashepherdScaffold a new 8-week course with all canonical section types, database rows, and optional markdown file structure. Use when creating a new course from scratch.
- ▌ Course Validate · joshuashepherdValidate a course against the Transformational Course Charter — checks Four Necessities, section completeness, word counts, and structure. Use before publishing or after authoring.
- ▌ Paratext Author · joshuashepherdWrite missing or stub paratext for any platform surface — books, courses, podcast episodes — in Alan Hirsch's voice. Queries the database for gaps, writes content, and updates via SQL. Use after running /paratext-audit to fill what it found.
- ▌ Pathway Builder · joshuashepherdBuild type-safe React pathway pages from pathway_sections database content — generates types, hooks, section components, and page composition. Triggers on: pathway page, pathway builder, build pathway, pathway components. NOT for: pathway content editing, seed scripts, schema changes, or Stitch conversions.
- ▌ Scaffold Course · joshuashepherdScaffold a new 8-week transformational course — creating the database rows, ingestion script, and optional markdown content directory. Use when starting a new course from scratch with a slug and title.
- ▌ Story Architect · joshuashepherdNarrative structure skill for fiction and creative non-fiction — plot architecture, character arcs, scene construction, tension/release, theme, and pacing. Use when planning, outlining, diagnosing, or restructuring a narrative. Also use when building agents that generate structured stories.
- ▌ Validate Course · joshuashepherdValidate a course against the Transformational Course Charter — checking 8-week structure, Four Necessities compliance, section completeness, content quality, and exclusions. Use when reviewing a course before publishing or after authoring to ensure it meets Charter requirements.
- ▌ Add Section Type · joshuashepherdCreate a new course section component and register it in the section router. Use when adding a new section type to the course learn experience (e.g., "add a quiz section type" or "add a new section component").
- ▌ Frontend Cleanup · joshuashepherdAudit a React/Next.js codebase for unused components, -v2 naming debt, and folder disorganization. Archives dead code and renames/restructures live components.
- ▌ Tailwind Cleanup · joshuashepherdScan and fix Tailwind anti-patterns for movemental — hardcoded colors, arbitrary values, raw HTML bypassing shadcn/primitives, border violations, and non-semantic tokens. Enforces DESIGN.md token-first design.
- ▌ Docs Design System · joshuashepherdAudit and update design documentation in _docs/_build/design/ to match the actual UI stack (tokens, Tailwind, shadcn primitives, domain components, pages). Keeps DESIGN_SYSTEM_SSOT.md and the design chain aligned with src/.
- ▌ CI Setup · joshuashepherdSet up GitHub Actions CI/CD pipeline for Next.js 15 or Vite + Express — lint, typecheck, unit tests, e2e tests, build validation, and Vercel preview deployment. Writes workflow YAML files and configures branch protection. Use when setting up CI on any new project.
- ▌ Type Fix · joshuashepherdRun type safety checks across all 6 layers, regenerate any failing layers, and loop until all layers pass with zero errors. Follows the lock-before-proceed protocol from _docs/type/.
- ▌ Home Consult · joshuashepherdStrategic consultation for a movement leader home page — mandatory sections rubric, scroll-stop strategy (Spline/NB2/GSAP), copy evaluation, and conversion architecture. Designed for thought leaders in the missional/formation niche.
- ▌ Tam Discover · joshuashepherdDiscover new movement leader candidates for the Movemental TAM using network-based and content-based search strategies
- ▌ Stitch UI Design · joshuashepherd bundleExpert guidance for crafting effective prompts in Google Stitch, the AI-powered UI design tool by Google Labs. This skill helps create precise, actionable prompts that generate high-quality UI designs for web and mobile applications.
- ▌ Configure Handoff · joshuashepherdConfigure agent handoffs — use when asked to set up multi-agent routing, delegate conversations between specialist agents, configure handoff rules, or wire agents together via an agent registry.
- ▌ Asset Brand Check · joshuashepherdAudit generated image assets against the platform's brand guidelines. Use before publishing to verify color palette, typography, tone, and visual consistency.
- ▌ Authoring Skills · joshuashepherdHow to create and maintain agent skills in .agents/skills/. Use when creating a new SKILL.md, writing skill descriptions, choosing frontmatter fields, or deciding what content belongs in a skill vs AGENTS.md. Covers the supported spec fields, description writing, naming conventions, and the relationship between always-loaded AGENTS.md and on-demand skills.
- ▌ Book Frontmatter · joshuashepherdPhase 02 of the books pipeline — generate, repair, or recompute YAML frontmatter for every chapter in a book and validate against the Zod schema at `scripts/lib/frontmatter-schema.ts`. Recomputes `content_sha256`, `word_count`, `char_count`, `estimated_reading_time`, and `Opening excerpt` to match the current body. Validates `book.json` against `BookManifest` and every chapter against `ChapterFrontmatter`. Use after `/book-convert` + `/book-validate` pass, before `/book-ingest`. Trigger phrases: "fix the frontmatter", "regenerate frontmatter", "validate book.json", "phase 02", "schema-validate the corpus".
- ▌ Corpus Ingestion · joshuashepherd bundleConvert heterogeneous source files (PDFs, EPUBs, DOCX, PPTX, HTML, audio, images, ZIPs, web pages) into normalized markdown using MarkItDown, then prepare them for Movemental-style corpus pipelines. Use this skill whenever ingesting an author's books, sermons, transcripts, slide decks, or archive materials for downstream theme/voice/concept analysis, RAG pipeline preparation, course content generation, or vector store upload. Also trigger on: "ingest this book", "convert and add to corpus", "prepare source material", "add to the knowledge base", "batch convert documents for analysis", or any time raw heterogeneous files need to become clean, curated markdown assets.
- ▌ Nonfiction Craft · joshuashepherdNon-fiction writing craft — argument construction, evidence handling, essay structure, chapter architecture, research integration, and the art of making ideas vivid. Use when writing, planning, or reviewing non-fiction of any kind (books, essays, articles, thought leadership).
- ▌ Frontend Patterns · joshuashepherdFrontend development patterns for React, Next.js, state management, performance optimization, and UI best practices.
- ▌ Typography Polish · joshuashepherdAudit and fix typography across movemental — heading hierarchy, Inter font compliance, display tracking, eyebrow conventions, prose width, and content readability across all page surfaces.
- ▌ Zenwrite UI Audit · joshuashepherd bundleAudit and improve existing ZenWrite UI — React 19 + Tailwind v4 quality plus the ZenWrite design chain (light-primary, dual-sphere; Newsreader serif + Manrope; brand-violet content, sky/emerald/rose community). Finds and fixes design drift (hardcoded hex, dynamic color strings, wrong sphere accents, missing focus rings, ad-hoc badges, dark-mode hijacks, token misuse) AND React/Tailwind/a11y/perf issues, ranked by severity, then applies the fixes. Use whenever REVIEWING, ALIGNING, CLEANING UP, or IMPROVING existing ZenWrite components/screens — "audit this page," "flush drift," "make this match our style," "clean up the styling," "check design consistency," "improve this component's react/tailwind." For building NEW UI from scratch, use zenwrite-design instead.
- ▌ Ga4 Setup · joshuashepherdSet up Google Analytics 4 for this Next.js 15 multi-tenant platform — org-wide property, per-tenant custom dimensions, typed event utilities, server-side Measurement Protocol, and GA4 Admin API for programmatic tenant provisioning.
- ▌ SEO Setup · joshuashepherdSet up SEO infrastructure for Next.js 15 — Metadata API (title, description, OG, Twitter), dynamic sitemap.xml, robots.txt, structured data (JSON-LD), canonical URLs, and OG image generation via Next.js ImageResponse. Use when launching any public-facing page or site.
- ▌ Domain Finder · joshuashepherdAnalyzes a project's docs and code to generate domain name candidates, check availability, compare registrar pricing, and recommend the best domain to register. Use when naming an app or finding a URL.
- ▌ Cache Components · joshuashepherd bundleExpert guidance for Next.js Cache Components and Partial Prerendering (PPR). Use when implementing 'use cache' directive, configuring cache lifetimes, tagging cached data, invalidating caches, or optimizing static vs dynamic content boundaries.
- ▌ Agent Instructions · joshuashepherdAuthor or refine agent system prompts using composable instruction layers (identity, theme, mode, style, context). Use when writing or tuning agent behavior.
- ▌ Asset Author Style · joshuashepherdDefine and maintain a consistent visual identity for an author/thought leader across all image assets. Creates a style guide document that all other asset-* skills reference for consistency. Use once to establish the look, then all headshots, heroes, and portraits will match.
- ▌ Asset Product Shot · joshuashepherdGenerate clean product/object photography prompts using Nano Banana 2. Use for book mockups, course materials, merchandise, or any object that needs a professional studio-quality shot on white or contextual background.
- ▌ Asset Text Overlay · joshuashepherdGenerate images with precise text rendering using Nano Banana 2. Use for social cards, OG images, course certificates, marketing banners, and any asset that needs legible text.
- ▌ Asset Video Prompt · joshuashepherdGenerate video transition prompts for AI video models (Runway, Kling, Pika, Higgsfield). Creates start/end frame descriptions, transition choreography, and model-agnostic instructions. Use for scroll-stopping social content, product reveals, course trailers, or any motion asset.
- ▌ Designer Dashboard · joshuashepherdApply the Stitch → tokens → primitives → components → layouts design chain to React/Tailwind dashboard UI for cohesive, on-brand surfaces. Use when building or refactoring dashboard routes, course/lesson editors, metadata pages, shell chrome, or running an agentic UI pass that must stay token-aligned.
- ▌ Puck Visual Editor · joshuashepherdBuild, extend, and persist Puck visual editors with React/Next.js and Supabase. Use whenever the user mentions Puck, @puckeditor/core, visual editor, site pages, puck_data, drag-and-drop CMS, block registry, Render vs Puck, RSC, per-page component palettes, richtext, plugin rail, slots, permissions, or data migration — even if they do not say "Puck" by name.
- ▌ Auth Setup · joshuashepherdSet up Supabase Auth for Next.js 15 (App Router) or Vite + React — sign-up, sign-in, OAuth providers, session middleware, protected routes, RLS user scoping, and auth UI components. Handles both frameworks with SSR-safe cookie patterns. Use when bootstrapping auth on any new project.
- ▌ Vite Audit · joshuashepherdAudit Vite configuration for correctness and optimization — build performance, plugins, resolve config, dev server, environment variables, and production output. Use before deploying or after config changes.
- ▌ Context7 MCP · joshuashepherdThis skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.
- ▌ Movement Leader Substrate · joshuashepherdAuthor the machine-readable substrate document for a movement leader — identity resolution, relational traversal, conceptual indexing, voice fidelity. Produces a single `{SLUG}_RESEARCH_COLLATED.md` matching the canonical substrate schema. Use when creating or refreshing the primary research artifact for a movement leader. NOT a consulting deliverable — no fit scores, gap analyses, or marketing playbooks.
- ▌ Movemental Welcome Letter · joshuashepherd bundleDraft the Movemental dashboard welcome letter for a specific movement leader from their fragmentation-story dossier. Use whenever the operator says "write the welcome letter for <author>", "draft the dashboard welcome for <leader>", "generate the fragmentation welcome letter", "do a welcome letter for <slug>", or any phrasing that pairs a movement-leader name with the words welcome, letter, or dashboard intro. Reads the leader's research dossier under docs/movement_leader_research/<slug>/ and emits a 1,000–1,050-word, seven-move letter dense with the leader's actual proper nouns — book titles, podcast appearances, partner publications, and the named city of a future practitioner. Save-to-disk is on by default. Pair with movemental-welcome-letter-publish to ship the finished letter to the database.
- ▌ Visual Storytelling Audit · joshuashepherdCross-platform audit of visual storytelling components — cards, grids, stats, comparisons, numbered steps, section rhythm, and narrative flow. Ensures every visual element tells the story with the best design possible. Use when auditing pages for narrative clarity, visual hierarchy, and design token compliance.
- ▌ Openai Vector Store · joshuashepherdExpert guidance for managing OpenAI vector stores — health checks, completeness audits, upload safeguards, junk/duplicate detection, surgical repair vs full re-upload decisions, API key/project scoping, and .mdx→.md workarounds. Use this skill whenever the user mentions vector store uploads, vector store health, missing files in a vector store, OpenAI file search setup, or asks about OPENAI_VECTOR_STORE_ID configuration. Also trigger when diagnosing "store looks wrong", "files missing", "temp files in store", or "upload script broke". Covers both Node.js and Python upload patterns.
- ▌ Asset Exploded View · joshuashepherdGenerate deconstructed/exploded view prompts using Nano Banana 2. Use for scroll-stop content, framework visualizations, concept illustrations, or any object elegantly taken apart into its components.
- ▌ Asset Hero Portrait · joshuashepherdCreate wide-format hero images featuring an author/thought leader from existing photos using Nano Banana 2. Handles background extension, atmospheric contexts, split compositions, and cinematic treatments for page heroes, landing pages, and featured sections.
- ▌ Write Instructions · joshuashepherdAuthor or refine agent instructions — use when asked to write a system prompt, create or update agent instructions, compose instruction layers (identity, theme, mode, style, dynamic context), or tune agent voice and behavior.
- ▌ Author Style Guide · joshuashepherdCreate or update the author visual style guide that ensures consistent lighting, color grade, and composition across all author imagery — trigger phrases include "author style guide", "visual style for author", "create style guide", "update style guide", or "ensure image consistency".
- ▌ Email Setup · joshuashepherdSet up transactional email via Resend for Next.js 15 or Vite + Express — React Email templates, send helpers, welcome/magic-link/notification emails, and local dev preview. Use when adding email to any project in this stack.
- ▌ React Audit · joshuashepherdAudit React 19 configuration and usage patterns for correctness and optimization — hooks, components, error boundaries, routing, state management, performance, and best practices. Use to check React health before shipping.
- ▌ Write Tests · joshuashepherdWrite agent tests — use when asked to add unit tests, smoke tests, or E2E tests for agents, including tool tests, instruction composition tests, retrieval router tests, citation tests, and guardrail tests.
- ▌ Stakeholder Map · joshuashepherdDeep-research Youthfront stakeholders and map their full connection networks for donor cultivation
- ▌ Tam Blind Spots · joshuashepherdSearch the structural blind spots that network mapping misses — domain practitioners, justice/reconciliation voices, worship/liturgy, academic theologians, and marketplace leaders who embody movemental DNA without participating in the explicit Forge/5Q/Exponential network
- ▌ Tam Network Map · joshuashepherdMap relationships, co-authorships, endorsements, and organizational connections between movement leaders in the TAM
- ▌ Academic Research · joshuashepherdDeep academic research using free open-access sources — Semantic Scholar, OpenAlex, arXiv, PubMed Central, and CORE. Searches across databases, retrieves papers, extracts key findings, and produces a well-organized research report with full citations.
- ▌ AI Model Insights · joshuashepherdAnalyze AI model research (from ai-model-research) and generate strategic insights — capability comparisons, cost projections for real workloads, use case routing recommendations, and provider selection guidance. Run ai-model-research first to generate fresh data, then use this skill to interpret it.
- ▌ AI Model Research · joshuashepherdLive browser research on all major AI models — OpenAI, Gemini, Claude, and Grok. Extracts authoritative model profiles, capability breakdowns, benchmark data, use case guidance, and full pricing for every model tier. Produces a dated snapshot report with source index for future reference. Run this before ai-model-insights.
- ▌ Asset Prompt Library · joshuashepherdManage reusable NB2 prompt templates for recurring asset types. Use to store, retrieve, list, or customize prompt templates for consistent asset generation.
- ▌ Fullstack Developer · joshuashepherdModern web development expertise covering React, Node.js, databases, and full-stack architecture. Use when: building web applications, developing APIs, creating frontends, setting up databases, deploying web apps, or when user mentions React, Next.js, Express, REST API, GraphQL, MongoDB, PostgreSQL, or full-stack development.
- ▌ Oatmeal Editorial UI · joshuashepherdFront-end UI design expert for the movemental-html-template "Oatmeal" static marketing template. Use when building or restyling any HTML page, hero, section, card, nav, CTA band, or footer to match the existing visual language. Anchors to css/tokens.css (the token SSOT), css/components.css (ml-* primitives), the design-chain/design-chain.html charter, and _reference/style-spec.json. Keywords: oatmeal, cream paper, Playfair Display, Inter, pill CTA, surface tiers, hairlines, terminal period, ml- components, design chain, static HTML, reveal-on-scroll, data-theme oatmeal.
- ▌ Repo Cleanup · joshuashepherdHolistic single-repo hygiene pass for context-coded React + Next.js/Vite + Tailwind + Supabase + Vercel + OpenAI/Anthropic/Gemini stacks. Use when a repo needs its docs triaged, dead code archived, stale HTML/templates removed, unused deps flagged, and its CLAUDE.md / AGENTS.md / .claude skill surface re-tightened so Cursor and Claude Code have a clean working context. Always archives (does not delete) under `_archive/<YYYY-MM-DD>/`. Defers component- and style-level work to $frontend-cleanup and $tailwind-cleanup; defers type-chain repair to $validate.
- ▌ Sentry Setup · joshuashepherdSet up Sentry error monitoring for a Vite + React 19 SPA with Express API — client SDK, server SDK, error boundaries, source maps, and Vercel serverless support.
- ▌ Stripe Setup · joshuashepherdSet up Stripe payments for Next.js 15 or Vite + Express — subscriptions, one-time payments, webhooks, customer portal, billing middleware, and Supabase subscription sync. Use when adding payments to any project in this stack.
- ▌ Tenant Check · joshuashepherdAudit components for hardcoded tenant strings, non-semantic colors, or missing feature flags. Use before PR review or to check tenant isolation readiness.
- ▌ Vercel Audit · joshuashepherdAudit Vercel deployment configuration for correctness and optimization — vercel.json, serverless functions, environment variables, headers, rewrites, and regions. Use before deploying or after config changes.
- ▌ Movemental Prose · joshuashepherdAudit and fix line-level prose in Movemental articles, book chapters, field guides, paratext, emails, and site copy. Catches fuzzy openings, bare cross-references, unanchored abstractions, drift vocabulary, and AI-shaped cadence — so the piece reads like a thoughtful human guide writing for senior leaders, not like AI-polished content. Use before publishing any Movemental prose.
- ▌ Movemental Voice · joshuashepherd bundleThe Movemental company voice — write new copy, prompt agents, or audit drafts so anything carrying the Movemental name sounds like us. Use whenever drafting or reviewing reader-facing Movemental copy (web pages, emails, landing pages, decks, donor and board communication, church and seminary copy, ad copy, product microcopy), whenever building a Claude skill or agent prompt that must produce Movemental copy, and whenever someone asks whether a draft "sounds like Movemental," is on-brand, on-voice, hyped, salesy, or too corporate. Use it even when the user does not say the words "voice" or "brand" — if the text will carry the Movemental name and a reader will judge whether to trust us by how it reads, this is the standard. This is the COMPANY voice; it is distinct from an individual leader's voice (see [[alan-voice]]) and from line-level prose cleanup (see [[plain-prose]] and [[movemental-prose]]), though all share the plain-prose discipline, the refusals, and authorship care.
- ▌ Stitch Page Port · joshuashepherd bundlePhase B/03–09 of the Movemental tenant migration — the repeatable workhorse that converts a cached Google Stitch wireframe into production React for one route or one route cluster (global chrome, home/marketing, pathways, content library, courses, AI/ chat/auth/account, utility/legal/tenant-unique). Replaces PlaceholderPage scaffolds with Server Component pages composing L4 section components, applies the token bridge, wires Layer-5 hooks when they exist, and SYNTHESIZES missing sections from the reference repo when a Stitch screen is incomplete. Use when the user says "port the homepage", "convert the courses pages", "build the content cluster from stitch", "migrate this route", or runs the playbook per-cluster. Underlying per-screen mechanic is the stitch-react skill. Tenant-agnostic: copy slots, pathways, and design come from TENANT_MANIFEST.md. See references/clusters.md for per-cluster section orders.
- ▌ Tam Reflected Understanding · joshuashepherdGenerate a reflected understanding document for a movement leader — a second-person mirror of their calling, audience, content, constraints, and credibility
- ▌ React Best Practices · joshuashepherd bundleReact performance optimization guidelines from Mastra Engineering. This skill should be used when writing, reviewing, or refactoring React code to ensure optimal performance patterns. Triggers on tasks involving React components, data fetching, bundle optimization, or performance improvements.
- ▌ Visualization Expert · joshuashepherdChart selection and data visualization guidance for effective data communication. Use when: creating visualizations, choosing chart types, designing dashboards, or when user mentions data visualization, charts, graphs, or needs help presenting data visually.
- ▌ Visualization Repair · joshuashepherdAudit React/Next.js components for broken charts and diagrams (Stitch exports, invalid SVG, collapsed Recharts, wrong motion.svg props). Propose a replacement using Recharts, Mermaid, D3, GSAP, or plain React/SVG, then implement. Use when visualizations are missing, clipped, zero-height, off-center, or non-interactive when they should work; keywords: broken chart, stitch visualization, ResponsiveContainer, radar, network graph, SVG motion.
- ▌ Zenwrite Design Chain · joshuashepherd bundleBuild new UI or audit/align existing UI for the ZenWrite scholarly-writing app — its light-primary, dual-sphere design system (Newsreader serif + Manrope, brand-violet content sphere, sky/emerald/rose community sphere) plus React 19 + Tailwind v4 and general web/a11y/responsive best practice. Use whenever creating, editing, reviewing, or "bringing into alignment" any ZenWrite component, panel, screen, or page — even when the user only says "build a component," "make this match our style," "audit this page," "clean up the styling," "check design consistency," or "flush drift." Both an auditor and a builder for the ZenWrite design chain (Tokens → Primitives → Components → Built → Patterns).
- ▌ Posthog Setup · joshuashepherdSet up PostHog product analytics for this Next.js 15 + Supabase multi-tenant platform — person identification, group analytics (org + tenant), session replay, feature flags, funnels, and server-side event capture.
- ▌ Project Setup · joshuashepherdBootstrap a production-ready React + Tailwind + Supabase + Sentry app — either Next.js 15 (App Router) or Vite + React Router. Installs all core libraries, writes every config file, sets up shadcn/ui, Supabase auth clients, Sentry three-config, Zod env validation, React Query, dark mode, and the full token system. Asks Vite vs Next.js upfront. Use when starting any new project in this stack.
- ▌ Testing Setup · joshuashepherdBootstrap Vitest (unit + integration) and Playwright (e2e) test infrastructure for Next.js 15 or Vite + React — config files, test utilities, fixture factories, database test helpers, and CI integration. Use when adding tests to a new or existing project.
- ▌ Logo Strip Author · joshuashepherdAuthor a complete social proof / logo strip section for an author or leader — copy, grouping strategy, TypeScript content definition, React component spec, CSS/Tailwind implementation, and logo download checklist. Run after affiliation-scrape and affiliation-audit.
- ▌ Tam International · joshuashepherdDiscover and research international movement leaders outside US/anglophone networks — mapping the global TAM
- ▌ Writing Agent Builder · joshuashepherdArchitect AI agents that write well — system prompt design, voice integration, tool selection, RAG for source material, guardrails for quality, and multi-agent writing pipelines. Use when building any agent whose primary output is prose (stories, articles, copy, dialogue, scripts).
- ▌ HTML To React Tailwind · joshuashepherdConvert HTML/CSS/JS files into production-ready React components with Tailwind CSS. Handles CSS-to-utility mapping, JS-to-React state/effects, component decomposition, and TypeScript types. Triggers on "HTML to React", "convert HTML", "migrate to React", "React conversion".