dev

A full-stack development guide for Convex applications built with React, Vite, TypeScript, authentication, and related services.

In plain words
What is it for?
Use it when building features, writing Convex queries or mutations, adding authentication or file storage, and documenting changes in this project.
Why use it?
It provides project-specific rules for making type-safe changes while preserving existing behavior and following Convex database and function patterns.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/waynesutton/markdown-site/dev
Any agent
npx skills add waynesutton/markdown-site --skill dev
Clone the repo
git clone --depth 1 https://github.com/waynesutton/markdown-site

Made for: Claude Code, Codex.

Per session 46 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 771 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00046 $0.00771
Opus 5 $0.00023 $0.00385
Sonnet 5 $0.00009 $0.00154
Haiku 4.5 $0.00005 $0.00077

Measured yesterday against content hash 516dfaf3a016, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

dev scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/dev/SKILL.md · 89 lines

How it starts

The opening of the file, as written. The whole thing — 89 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Convex Full-Stack Development Skill

Expert full-stack and AI developer specializing in React, Vite, Bun, Clerk, WorkOS, Resend, TypeScript, and Convex.dev.

Core principles

  • Open with let's cook when that repo convention is active
  • Always create type-safe code
  • Be terse and casual unless specified otherwise
  • No emojis unless instructed
  • Treat user as a new developer
  • Suggest solutions and anticipate needs
  • Never break existing functionality
  • Don't over-engineer

Convex best practices

Mutations

  • Patch directly without reading first
  • Use indexed queries for ownership checks (not ctx.db.get())
  • Make mutations idempotent with early returns
  • Use timestamp-based ordering for new items
  • Use Promise.all() for parallel independent operations

Resources

Authentication

React guidelines

Design system

  • Follow Vercel Web Interface Guidelines: https://vercel.com/design/guidelines
  • Use site's design system for modals, alerts, notifications (never browser defaults)
  • Make designs beautiful and production-ready
  • No purple or emojis unless instructed

Read the full file on GitHub · 89 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 89 lines · 46 tokens per session scan A 516dfaf3a016

Subscribe to this mod's changes

dev is a skill published in the GitHub repository waynesutton/markdown-site (631 stars, last pushed 3mo ago), licensed MIT. It adds 46 tokens to every session and 771 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

shieldcn-badges

Create polished shieldcn README badges, badge groups, charts, headers, sponsors grids, and full README hero sections. Use when a user wants shadcn/ui-styled badges, Shields.io replacement, npm/GitHub/CI/status badges, download charts, README header banners, contributor/sponsor images, or README Studio guidance.…

jal-co/shieldcn · 145 tokens

infisical-sync-skill

Expert knowledge for the Infisical Sync Hand — Infisical API reference, vault operations, error patterns, security guidance.

RightNow-AI/openfang · 31 tokens

soul-grader

Use when grading, reviewing, rewriting, or approving a Hermes Agent SOUL.md. Uses the SOUL.md field-guide research artifacts as the only normative source for what makes a good SOUL.md.

cobibean/soul-grader-skill · 45 tokens

mb-ads

Create and review ads, and prepare provider-safe launch plans/checks. Flexible entry points: full pipeline (copy + images), copy only, images only, creative variations (hook library), video scripts, long-form video ads/VSL-style paid creative, video repurpose, compliance review, launch-plan, instrumentation, check, or…

noontide-co/mainbranch · 136 tokens

mb-think

Combined research, decision, and codification workflow. Use when: (1) Exploring a question before committing (2) Making a decision that needs documentation (3) User says research, decide, figure out, explore, codify, enrich, retire stale source, sharpen this offer, improve the offer, add context, keyword gate, analyze…

noontide-co/mainbranch · 141 tokens

anakinscraper

Scrape any website into clean markdown or structured JSON. Anti-detect browser, smart proxy rotation, AI-powered data extraction.

Anakin-Inc/anakin · 30 tokens