---
title: "waynesutton/builder-skills skills · skilld"
description: "Workflow, security, and writing skills for builders shipping Convex apps. npx builder-skills"
canonical_url: "https://skilld.dev/gh/waynesutton/builder-skills"
meta:
  "og:description": "Workflow, security, and writing skills for builders shipping Convex apps. npx builder-skills"
  "og:image": "https://skilld.dev/_og/d/a_~c2tpbGxkLCBhZ2VudCBza2lsbHMgd3JpdHRlbiBieSByZWFsIG1haW50YWluZXJz%2Cc_Page.takumi%2Cdescription_~Q3VyYXRlZCBhZ2VudCBza2lsbHMgYnkgaHVtYW5zLCB3cml0dGVuIGJ5IHJlYWwgbWFpbnRhaW5lcnMgaW4gdGhlaXIgb3duIEdpdEh1YiByZXBvcw%2Cp_Ii9naC93YXluZXN1dHRvbi9idWlsZGVyLXNraWxscyI%2Cs_UyvAOg9uJr0b2lDd.png"
  "og:image:alt": "skilld, agent skills written by real maintainers"
  "og:image:height": "600"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "waynesutton/builder-skills skills"
  "twitter:description": "Workflow, security, and writing skills for builders shipping Convex apps. npx builder-skills"
  "twitter:image": "https://skilld.dev/_og/d/a_~c2tpbGxkLCBhZ2VudCBza2lsbHMgd3JpdHRlbiBieSByZWFsIG1haW50YWluZXJz%2Cc_Page.takumi%2Cdescription_~Q3VyYXRlZCBhZ2VudCBza2lsbHMgYnkgaHVtYW5zLCB3cml0dGVuIGJ5IHJlYWwgbWFpbnRhaW5lcnMgaW4gdGhlaXIgb3duIEdpdEh1YiByZXBvcw%2Cp_Ii9naC93YXluZXN1dHRvbi9idWlsZGVyLXNraWxscyI%2Cs_UyvAOg9uJr0b2lDd.png"
  "twitter:image:alt": "skilld, agent skills written by real maintainers"
  "twitter:title": "waynesutton/builder-skills skills"
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

[All skills](https://skilld.dev/skills)

[![waynesutton avatar](https://skilld.dev/_img/avatar?url=https%3A%2F%2Fgithub.com%2Fwaynesutton.png)](https://skilld.dev/gh/waynesutton)

# **waynesutton/builder-skills**

Workflow, security, and writing skills for builders shipping Convex apps. npx builder-skills

main Updated last week [GitHub](https://github.com/waynesutton/builder-skills)

![README badge for waynesutton/builder-skills](https://skilld.dev/b/waynesutton/builder-skills?theme=light&label=0)

## Repository statistics

- Indexed skills

  **23**
- Skill groups

  **1**
- GitHub stars

  **404**
- Forks

  **33**

## Skills

23 total

Sort skills

[/sec-check](https://skilld.dev/gh/waynesutton/builder-skills/sec-check)

Security 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, status moves that skip steps, 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.

Updated7 days ago

[/state-machines](https://skilld.dev/gh/waynesutton/builder-skills/state-machines)

Finds the implicit state machines in an app: status, state, stage, phase, and step fields, groups of booleans that act like one status, and flows spread across UI, mutations, webhooks, and scheduled jobs. Reports every state, every function that moves it, who can trigger each move, and the problems, then proposes an explicit transition map. Report only by default. Use when the user says find the implicit state machines, audit status fields, map the order or onboarding flow, or when a status bug, a skipped step, or a double run refund, payout, or email shows up.

Updated7 days ago

[/dev](https://skilld.dev/gh/waynesutton/builder-skills/dev)

House 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.

Updated12 days ago

[/convex-agents](https://skilld.dev/gh/waynesutton/builder-skills/convex-agents)

Retired. 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.

Updated12 days ago

[/convex-best-practices](https://skilld.dev/gh/waynesutton/builder-skills/convex-best-practices)

Retired. 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.

Updated12 days ago

[/convex-component-authoring](https://skilld.dev/gh/waynesutton/builder-skills/convex-component-authoring)

Retired. 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.

Updated12 days ago

[/convex-cron-jobs](https://skilld.dev/gh/waynesutton/builder-skills/convex-cron-jobs)

Retired. 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.

Updated12 days ago

[/convex-file-storage](https://skilld.dev/gh/waynesutton/builder-skills/convex-file-storage)

Retired. 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.

Updated12 days ago

[/convex-functions](https://skilld.dev/gh/waynesutton/builder-skills/convex-functions)

Retired. 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.

Updated12 days ago

[/convex-http-actions](https://skilld.dev/gh/waynesutton/builder-skills/convex-http-actions)

Retired. 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.

Updated12 days ago

[/convex-migrations](https://skilld.dev/gh/waynesutton/builder-skills/convex-migrations)

Retired. 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.

Updated12 days ago

[/convex-realtime](https://skilld.dev/gh/waynesutton/builder-skills/convex-realtime)

Retired. 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.

Updated12 days ago

[/convex-schema-validator](https://skilld.dev/gh/waynesutton/builder-skills/convex-schema-validator)

Retired. 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.

Updated12 days ago

[/convex-security-audit](https://skilld.dev/gh/waynesutton/builder-skills/convex-security-audit)

Retired. 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.

Updated12 days ago

[/convex-security-check](https://skilld.dev/gh/waynesutton/builder-skills/convex-security-check)

Retired. 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.

Updated12 days ago

[/create-prd](https://skilld.dev/gh/waynesutton/builder-skills/create-prd)

Writes 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.

Updated12 days ago

[/think-first](https://skilld.dev/gh/waynesutton/builder-skills/think-first)

Reflection 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.

Updated12 days ago

[/update-project-docs](https://skilld.dev/gh/waynesutton/builder-skills/update-project-docs)

Brings 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.

Updated12 days ago

[/what-i-need-from-you](https://skilld.dev/gh/waynesutton/builder-skills/what-i-need-from-you)

Ends 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.

Updated12 days ago

[/workflow](https://skilld.dev/gh/waynesutton/builder-skills/workflow)

Runs 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.

Updated12 days ago

[/write](https://skilld.dev/gh/waynesutton/builder-skills/write)

Drafts, 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.

Updated12 days ago

[/avoid-feature-creep](https://skilld.dev/gh/waynesutton/builder-skills/avoid-feature-creep)

Keeps 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'.

Updated2 months ago

[/git-safety](https://skilld.dev/gh/waynesutton/builder-skills/git-safety)

Stops 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.

Updated2 months ago

## Add to your README

The badge links readers to this page. It shows the skilld mark and no counts, and it follows the reader's light or dark GitHub theme.

`<a href="https://skilld.dev/gh/waynesutton/builder-skills"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://skilld.dev/b/waynesutton/builder-skills?theme=dark"> <source media="(prefers-color-scheme: light)" srcset="https://skilld.dev/b/waynesutton/builder-skills?theme=light"> <img alt="Skill repository on skilld.dev" src="https://skilld.dev/b/waynesutton/builder-skills?theme=light"> </picture> </a>`

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://skilld.dev/#website","@type":"WebSite","description":"Curated agent skills by humans, written by real maintainers in their own GitHub repos","name":"skilld","url":"https://skilld.dev/"},{"@id":"https://skilld.dev/gh/waynesutton/builder-skills#webpage","@type":"WebPage","description":"Workflow, security, and writing skills for builders shipping Convex apps. npx builder-skills","name":"waynesutton/builder-skills skills","url":"https://skilld.dev/gh/waynesutton/builder-skills","isPartOf":{"@id":"https://skilld.dev/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://skilld.dev/gh/waynesutton/builder-skills"]}]}]}
```