waynesutton
- 90 skills
- 0 followers
- 629 repo stars
- 5 days ago last updated
- ▌ Update Project Docs 7 · waynesutton bundleBrings task.md, changelog.md, and files.md back in sync with what the code says shipped, then prints a commit message as plain text. Reads git history and the working tree, never memory, and refuses to log features it cannot see in source. Use when a feature or fix lands, when the user says /update, @update, update project docs, sync changelog, or update files.md, or when task.md and the code disagree.
- ▌ What I Need From You · waynesutton bundleEnds every agent turn with a clear "What I need from you" section listing concrete actions the user must take, or says "Nothing needed from you right now", and logs every ask by id and session in prds/what-i-need-from-you.md. Use on every turn, especially when blocked on the user, when the next step needs a login, dashboard, key rotation, decision, file, or approval, or when finishing a task, audit, or fix.
- ▌ Convex Best Practices · waynesutton bundleRetired. Points to the skill that replaced convex-best-practices in builder-skills 3.0. Use when /convex-best-practices is invoked by name or the user asks where convex-best-practices went.
- ▌ Convex Security Audit · waynesutton bundleRetired. Points to the skill that replaced convex-security-audit in builder-skills 3.0. Use when /convex-security-audit is invoked by name or the user asks where convex-security-audit went.
- ▌ Convex Security Check · waynesutton bundleRetired. Points to the skill that replaced convex-security-check in builder-skills 3.0. Use when /convex-security-check is invoked by name or the user asks where convex-security-check went.
- ▌ Convex Schema Validator · waynesutton bundleRetired. Points to the skill that replaced convex-schema-validator in builder-skills 3.0. Use when /convex-schema-validator is invoked by name or the user asks where convex-schema-validator went.
- ▌ Convex Component Authoring · waynesutton bundleRetired. Points to the skill that replaced convex-component-authoring in builder-skills 3.0. Use when /convex-component-authoring is invoked by name or the user asks where convex-component-authoring went.
- ▌ Dev 3 · waynesutton bundleHouse style for full stack Convex work: React, Vite, TypeScript, Convex mutations, Convex Auth, Resend, design system over browser defaults, and the files.md, changelog.md, task.md habit. Edit it to match your project after installing. Use when building features, writing Convex functions, or making code changes in a project that uses this style.
- ▌ Write 2 · waynesutton bundleDrafts, proofs, and audits prose in the author's voice, matched to the reader and destination. Covers social posts, articles, emails, docs, READMEs, commit messages, and feature announcements, with evidence rules that forbid invented facts, quotes, or experiences, and a draft only default that never publishes or sends. Use when drafting, rewriting, proofreading, or auditing social posts, articles, emails, docs, READMEs, or commit messages, or when the user says write:, proof this, or make this sound less like AI.
- ▌ Workflow 2 · waynesutton bundleRuns multi step work the way a careful senior engineer would: triage before code, a PRD in prds/, task.md kept current, docs synced after, and lessons recorded when a mistake repeats. Hands PRD writing to create-prd and the docs sync to update-project-docs. Use when a task spans several files or steps, changes architecture, needs a plan the user can review, or when the user says plan this, track this in task.md, or what did we learn.
- ▌ Sec Check 2 · waynesutton bundleSecurity check and audit for Convex apps and any app with a React, Vite, Next.js, or Expo frontend, built from real incidents across shipped repos. Runs a secret scanner plus a per function surface ledger, then gates every candidate finding on a real attacker path before it gets a severity. Covers leaked keys, client prefixed secrets, public functions with no auth, caller identity taken from args, paid AI and AI Gateway spend, unsigned webhooks, open uploads, unsafe HTML, prompt injection into agent tools, component boundaries, derived data that outlives its source, unbounded reads, and CI deploy keys. Use before any deploy, before making a repo public, when adding AI, webhooks, uploads, env vars, admin features, or agent tools, when reviewing AI generated code or a PR, when checking whether a security fix worked, or when the user says sec check, security check, security audit, pen test, find vulnerabilities, verify the fix, or is this safe to ship.
- ▌ Create Prd 3 · waynesutton bundleWrites a short PRD in prds/<slug>.md before non trivial work: problem, root cause for bugs, proposed solution, files to change, edge cases, verification steps, and a completion log, with UTC metadata. Then queues the work in task.md. Use before any multi file feature, schema change, architectural decision, or bug that took real investigation, or when the user says write a PRD, @create-prd, or plan this.
- ▌ Git Safety · waynesutton bundleStops an agent from destroying uncommitted work with git. Requires git status and git diff before any command that discards changes, treats "revert" and "undo" as manual edits, and never runs reset, checkout, clean, stash drop, or force push without explicit approval. Use when a task involves reverting, undoing, resetting, cleaning, rebasing, or force pushing, or before any git command in a repo with uncommitted changes.
- ▌ Think First · waynesutton bundleReflection first problem solving for Convex projects: root cause before code, two candidate fixes, a 98 percent confidence bar, and changes limited to the files the request needs. Use before implementing any fix or feature, when a bug report comes in, when a previous fix did not work, or when the request is vague.
- ▌ Convex Agents · waynesutton bundleRetired. Points to the skill that replaced convex-agents in builder-skills 3.0. Use when /convex-agents is invoked by name or the user asks where convex-agents went.
- ▌ Convex Realtime · waynesutton bundleRetired. Points to the skill that replaced convex-realtime in builder-skills 3.0. Use when /convex-realtime is invoked by name or the user asks where convex-realtime went.
- ▌ Convex Cron Jobs · waynesutton bundleRetired. Points to the skill that replaced convex-cron-jobs in builder-skills 3.0. Use when /convex-cron-jobs is invoked by name or the user asks where convex-cron-jobs went.
- ▌ Convex Functions · waynesutton bundleRetired. Points to the skill that replaced convex-functions in builder-skills 3.0. Use when /convex-functions is invoked by name or the user asks where convex-functions went.
- ▌ Convex Migrations · waynesutton bundleRetired. Points to the skill that replaced convex-migrations in builder-skills 3.0. Use when /convex-migrations is invoked by name or the user asks where convex-migrations went.
- ▌ Avoid Feature Creep · waynesutton bundleKeeps a change scoped to what was asked. Flags extra features, refactors, and 'while we are here' edits, and moves them to a suggestions list instead of the diff. Use when a request is small and the agent is about to expand it, when a PRD grows beyond its problem statement, or when the user says 'just do what I asked'.
- ▌ Convex File Storage · waynesutton bundleRetired. Points to the skill that replaced convex-file-storage in builder-skills 3.0. Use when /convex-file-storage is invoked by name or the user asks where convex-file-storage went.
- ▌ Convex HTTP Actions · waynesutton bundleRetired. Points to the skill that replaced convex-http-actions in builder-skills 3.0. Use when /convex-http-actions is invoked by name or the user asks where convex-http-actions went.
- ▌ Robel Auth 4 · waynesutton bundleIntegrate and maintain Robelest Convex Auth in apps by always checking upstream before implementation. Use when adding auth setup, updating auth wiring, migrating between upstream patterns, or troubleshooting @robelest/convex-auth behavior across projects.
- ▌ Update Project Docs 6 · waynesuttonUse when the user says /update, @update, update project docs, or asks to sync task.md, changelog.md, and files.md after completing work.
- ▌ Convex Static Hosting Deploy 3 · waynesuttonUse when deploying this teleprompt app with get-convex/static-hosting, especially when the user says /deploydev, /deployprod, deploy dev, deploy prod, deploy production, upload static hosting, or asks which Convex static-hosting command to run. Keeps dev uploads on fearless-dolphin-422 and production uploads on befitting-dodo-95.
- ▌
- ▌
- ▌ Robel Auth 3 · waynesutton bundleIntegrate and maintain Robelest Convex Auth in apps by always checking upstream before implementation. Use when adding auth setup, updating auth wiring, migrating between upstream patterns, or troubleshooting @robelest/convex-auth behavior across projects.
- ▌
- ▌ Clarify 2 · waynesuttonImprove unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing.
- ▌ Convex Return Validators 2 · waynesutton bundleGuide for when to use and when not to use return validators in Convex functions. Use this skill whenever the user is writing Convex queries, mutations, or actions and needs guidance on return value validation. Also trigger when the user asks about Convex type safety, runtime validation, AI-generated Convex code, Convex AI rules, Convex security best practices, or when they're debugging return type issues in Convex functions. Trigger this skill when users mention "validators", "returns", "return type", or "exact types" in the context of Convex development. Also trigger when writing or reviewing Convex AI rules or prompts that instruct LLMs how to write Convex code.
- ▌ Codex Sites Convex 2 · waynesutton bundleBuild, extend, validate, and publish a ChatGPT Sites application whose durable database and backend functions run on Convex. Use when a user invokes $codex-sites-convex, selects this skill from the skill picker, asks for a ChatGPT Site backed by Convex, or asks to add Convex data, realtime queries, mutations, authentication, files, schedules, or actions to an existing ChatGPT Sites project.
- ▌ Convex Schema 2 · waynesuttonBrowse and visualize Convex database schemas. Use when exploring Convex tables, viewing document structure, understanding database relationships, or creating dashboards.
- ▌ Convex Self Hosting 2 · waynesutton bundleIntegrate Convex static self hosting into existing apps using the latest upstream instructions from get-convex/self-hosting every time. Use when setting up upload APIs, HTTP routes, deployment scripts, migration from external hosting, or troubleshooting static deploy issues across React, Vite, Next.js, and other frontends.
- ▌ Sync Agent Skills 2 · waynesuttonUse when the user says /syncskills, sync agent skills, update .agents skills from .codex, .cursor, or .claude, or asks to make .agents/skills include skills from other agent folders.
- ▌ Convex Auth Expert 2 · waynesuttonExpert Convex Auth setup, production, OAuth, security, and debugging guidance. Use when adding or auditing Convex Auth, configuring GitHub/Google/Apple OAuth, setting auth env vars, protecting Convex functions with getAuthUserId, debugging callback URLs, preparing production auth, rotating keys, or reviewing auth security.
- ▌ Convex Static Hosting Deploy 2 · waynesuttonRouter for Convex static-hosting deploy requests. Prefer deploydev for /deploydev and deployprod for /deployprod.
- ▌ Dev 2 · waynesuttonFull-stack Convex development guidelines covering React, Vite, TypeScript, mutations, auth, design system, and documentation practices. Use when building features, writing Convex functions, or making code changes in this project.
- ▌ Deploydev 2 · waynesuttonUse when the user says /deploydev, deploy dev, upload dev static hosting, or asks to deploy the current app to its development Convex static-hosting target.
- ▌ Localstop 2 · waynesuttonUse when the user says /localstop, localstop, stop localhost for this app, /localstopall, localstopall, or asks to stop local development servers for this Teleprompt app.
- ▌ Deployprod 2 · waynesuttonUse when the user says /deployprod, deploy prod, deploy production, upload production static hosting, or asks to deploy the current app to its production Convex static-hosting target.
- ▌ Impeccable 2 · waynesutton bundleUse when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
- ▌ Convex Quickstart 2 · waynesuttonInitialize a new Convex project from scratch or add Convex to an existing app. Use when starting a new project with Convex, scaffolding a Convex app, or integrating Convex into an existing frontend.
- ▌ Convex Doctor 2 · waynesuttonStatic analysis checklist for Convex backends covering 72 rules across security, performance, correctness, schema, architecture, configuration, and client-side patterns. Use when writing, reviewing, or auditing Convex code. Trigger on mentions of "convex-doctor", "health score", "static analysis", "anti-patterns", "audit convex", or before shipping backend changes.
- ▌
- ▌
- ▌ Update Project Docs 4 · waynesuttonUse when the user says /update, @update, update project docs, or asks to sync task.md, changelog.md, and files.md after completing work.
- ▌ Codex Sites Convex · waynesutton bundleBuild, extend, validate, and publish a ChatGPT Sites application whose durable database and backend functions run on Convex. Use when a user invokes $codex-sites-convex, selects this skill from the skill picker, asks for a ChatGPT Site backed by Convex, or asks to add Convex data, realtime queries, mutations, authentication, files, schedules, or actions to an existing ChatGPT Sites project.
- ▌ Update Project Docs 2 · waynesuttonUse when the user says /update, @update, update project docs, or asks to sync task.md, changelog.md, and files.md after completing work.
- ▌ Robel Auth 2 · waynesutton bundleIntegrate and maintain Robelest Convex Auth in apps by always checking upstream before implementation. Use when adding auth setup, updating auth wiring, migrating between upstream patterns, or troubleshooting @robelest/convex-auth behavior across projects.
- ▌ Convex Schema · waynesuttonBrowse and visualize Convex database schemas. Use when exploring Convex tables, viewing document structure, understanding database relationships, or creating dashboards.
- ▌ Cargo Cult · waynesutton bundleReview code for cargo-cult programming and report whether the repository uses Convex: copied rituals, arbitrary delays, unexplained workarounds, disabled safeguards, swallowed errors, speculative patterns, and code nobody can justify. Use when reviewing AI-generated or pasted code, suspicious hacks, pull requests, prototypes becoming production, flaky fixes, architecture changes, or requests to simplify and explain unfamiliar code. Do not use as a generic style linter or accuse code without reading its context.
- ▌ Sync Agent Skills · waynesuttonUse when the user says /syncskills, sync agent skills, update .agents skills from .codex, .cursor, or .claude, or asks to make .agents/skills include skills from other agent folders.
- ▌ Convex Write Conflicts · waynesuttonDiagnose and permanently fix Convex OCC "Retried due to write conflicts in table X" errors. Use when an Insight or log shows a mutation retrying on the same hot document, especially heartbeat/last-active/counter style writes.
- ▌ Deploydev · waynesuttonUse when the user says /deploydev, deploy dev, upload dev static hosting, or asks to deploy the current app to its development Convex static-hosting target.
- ▌ Deployprod · waynesuttonUse when the user says /deployprod, deploy prod, deploy production, upload production static hosting, or asks to deploy the current app to its production Convex static-hosting target.
- ▌ Signaldesk Setup · waynesuttonSet up and run the SignalDesk Convex starter from a fresh clone. Use when an attendee wants to fork, install, run locally, add their OpenAI key, or deploy SignalDesk to Convex static hosting.
- ▌ Convex Auth Expert · waynesuttonExpert Convex Auth setup, production, OAuth, security, and debugging guidance. Use when adding or auditing Convex Auth, configuring GitHub/Google/Apple OAuth, setting auth env vars, protecting Convex functions with getAuthUserId, debugging callback URLs, preparing production auth, rotating keys, or reviewing auth security.
- ▌ Convex Self Hosting · waynesutton bundleIntegrate Convex static self hosting into existing apps using the latest upstream instructions from get-convex/self-hosting every time. Use when setting up upload APIs, HTTP routes, deployment scripts, migration from external hosting, or troubleshooting static deploy issues across React, Vite, Next.js, and other frontends.
- ▌ Signaldesk Enable Auth · waynesuttonTurn on Convex Auth in the SignalDesk starter. Use when an attendee wants login, sign up, user accounts, or protected functions added to their forked SignalDesk app.
- ▌ Convex Static Hosting Deploy · waynesuttonRouter for Convex static-hosting deploy requests. Prefer deploydev for /deploydev and deployprod for /deployprod.
- ▌ Localstop · waynesuttonUse when the user says /localstop, localstop, stop localhost for this app, /localstopall, localstopall, or asks to stop local development servers for this Teleprompt app.
- ▌
- ▌ Convex Design System · waynesutton bundleConvex UI component patterns from the live Storybook preview. Use when building React components, forms, modals, navigation, feedback states, or app layouts that should match the current Convex design system. Applies to both shared primitives and dashboard style product UI.
- ▌ Agent Ready Interface · waynesutton bundleAgent Ready project design context for navigation, docs links, and interface tone. Use when building or reviewing UI in this repo so patterns match the documented product feel.
- ▌ Convex Scale Optimization · waynesuttonPatterns for scaling read-heavy Convex apps to millions of users. Use when optimizing bandwidth, reducing query costs, fixing slow queries, creating digest tables, replacing reactive subscriptions with one-shot fetches, adding compound indexes, debouncing writes, rate-controlling backfills, or running npx convex insights. Trigger when users mention "scale", "bandwidth", "performance", "optimize", "slow queries", "expensive queries", "digest table", "denormalize", or "thundering herd" in the context of Convex.
- ▌ Blog Post · waynesuttonSubmit a blog draft to waynesutton.ai. Use when the user says "blog this", "blog to wsai", "send to wsai", "write to wsai", "post this to my blog", "write this up for the blog", "turn this session into a blog post", "turn this session into a blog post wsai", "draft a post about", "wsai draft a post about", or asks to file session notes to waynesutton.ai. Drafts go to a review inbox and are never published without approval.
- ▌ Clarify · waynesuttonImprove unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing.
- ▌ Impeccable · waynesutton bundleUse when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
- ▌
- ▌ Workos Convex Auth · waynesuttonSet up and configure WorkOS AuthKit authentication with Convex backend. Use when integrating AuthKit, configuring JWT providers, setting up environment variables, or implementing sign in and sign out flows with React and Vite. Supports Netlify deployment.
- ▌ Workos Convex Debug · waynesuttonDebug and troubleshoot WorkOS AuthKit authentication issues with Convex. Use when authentication fails, JWT validation errors occur, user identity returns null, email claims are missing, admin access checks fail, or sign in button does not work. Supports Netlify deployment.
- ▌ Dev · waynesuttonFull-stack Convex development guidelines covering React, Vite, TypeScript, mutations, auth, design system, and documentation practices. Use when building features, writing Convex functions, or making code changes in this project.
- ▌ Help · waynesuttonReflection-first problem solving methodology for Convex development. Use before implementing any solution to ensure proper root cause analysis, 98% code confidence, and minimal change scope.
- ▌ Write · waynesuttonWriting style guide for technical content, social media, blog posts, READMEs, git commits, and developer documentation. Optimized to avoid AI detection patterns. Use when writing any content beyond code.
- ▌ Gitrules · waynesuttonCritical Git safety rules to prevent destructive operations. Use whenever performing git operations, reverting changes, or managing commits. Prevents accidental loss of work.
- ▌ Workflow · waynesuttonProject workflow for PRDs, task tracking, changelog sync, and documentation updates. Use for any non-trivial task that spans multiple steps, touches several files, changes architecture, or needs project tracking updates. Also activates with @update to sync task.md, changelog.md, and files.md after completing work.
- ▌ Sec Check · waynesuttonSecurity review checklist for Convex functions, auth logic, public queries, admin routes, webhooks, uploads, and AI-generated code. Use when reviewing code that touches user data, PII, or access control.
- ▌ Schema Builder · waynesuttonDesign and generate Convex database schemas with proper validation, indexes, and relationships. Use when creating schema.ts or modifying table definitions.
- ▌ Function Creator · waynesuttonCreate Convex queries, mutations, and actions with proper validation, authentication, and error handling. Use when implementing new API endpoints.
- ▌ Migration Helper · waynesuttonPlan and execute Convex schema migrations safely, including adding fields, creating tables, and data transformations. Use when schema changes affect existing data.
- ▌ Convex Quickstart · waynesuttonInitialize a new Convex project from scratch or add Convex to an existing app. Use when starting a new project with Convex, scaffolding a Convex app, or integrating Convex into an existing frontend.
- ▌ Convex Setup Auth · waynesuttonSet up Convex authentication with proper user management, identity mapping, and access control patterns. Use when implementing auth flows, setting up OAuth providers, or adding role-based access control.
- ▌ Real Time Backend · waynesuttonBuild reactive, type-safe, production-grade backends. ALWAYS use this skill when the user asks to build, plan, design, or implement backend features, APIs, data models, server logic, database schemas, web apps, full stack apps, or mobile apps. This includes planning and architecture discussions.
- ▌
- ▌ Robel Auth · waynesutton bundleIntegrate and maintain Robelest Convex Auth in apps by always checking upstream before implementation. Use when adding auth setup, updating auth wiring, migrating between upstream patterns, or troubleshooting @robelest/convex-auth behavior across projects.
- ▌ Convex Doctor · waynesuttonRun convex-doctor static analysis, interpret findings, and fix issues across security, performance, correctness, schema, and architecture categories. Use when running convex-doctor, fixing convex-doctor warnings or errors, improving the convex-doctor score, or when asked about Convex code quality, static analysis, or linting Convex functions.
- ▌ React Effect Decision · waynesuttonCombine React's official "You Might Not Need an Effect" guidance with this project's stricter no direct useEffect stance. Use when writing, reviewing, or refactoring React components that might reach for useEffect, derived state, event relays, reset logic, subscriptions, or client fetching.
- ▌
- ▌ Convex Return Validators · waynesutton bundleGuide for when to use and when not to use return validators in Convex functions. Use this skill whenever the user is writing Convex queries, mutations, or actions and needs guidance on return value validation. Also trigger when the user asks about Convex type safety, runtime validation, AI-generated Convex code, Convex AI rules, Convex security best practices, or when they're debugging return type issues in Convex functions. Trigger this skill when users mention "validators", "returns", "return type", or "exact types" in the context of Convex development. Also trigger when writing or reviewing Convex AI rules or prompts that instruct LLMs how to write Convex code.