Local Testing
lobehub/lobe-ui
Local browser verification for the lobe-ui component library and documentation site.
Full-stack Convex development guidelines covering React, Vite, TypeScript, mutations, auth, design system, and documentation practices.
Install Dev
$ npx skills add waynesutton/markdown-site --skill dev -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install waynesutton/markdown-site dev --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/waynesutton/markdown-site.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/dev .claude/skills/dev && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "dev" agent skill from https://github.com/waynesutton/markdown-site/tree/main/.claude/dev into .claude/skills/dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dev", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/waynesutton/markdown-site/tree/main/.claude/devType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add waynesutton/markdown-site --skill dev -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install waynesutton/markdown-site dev --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/waynesutton/markdown-site.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/dev .agents/skills/dev && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "dev" agent skill from https://github.com/waynesutton/markdown-site/tree/main/.claude/dev into .agents/skills/dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dev", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add waynesutton/markdown-site --skill dev -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install waynesutton/markdown-site dev --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/waynesutton/markdown-site.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/dev .cursor/skills/dev && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "dev" agent skill from https://github.com/waynesutton/markdown-site/tree/main/.claude/dev into .cursor/skills/dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dev", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/waynesutton/markdown-site.git --path .claude/dev--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add waynesutton/markdown-site --skill dev -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install waynesutton/markdown-site dev --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/waynesutton/markdown-site.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/dev .gemini/skills/dev && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "dev" agent skill from https://github.com/waynesutton/markdown-site/tree/main/.claude/dev into .gemini/skills/dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dev", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install waynesutton/markdown-site devInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add waynesutton/markdown-site --skill dev -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/waynesutton/markdown-site.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/dev .github/skills/dev && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "dev" agent skill from https://github.com/waynesutton/markdown-site/tree/main/.claude/dev into .github/skills/dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dev", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add waynesutton/markdown-site --skill dev -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install waynesutton/markdown-site dev --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/waynesutton/markdown-site.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/dev .opencode/skills/dev && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "dev" agent skill from https://github.com/waynesutton/markdown-site/tree/main/.claude/dev into .opencode/skills/dev/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dev", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
dev- GitHub stars
- 628
- Token cost
- ~854 tokens
- SKILL.md length
- 331 words
- Files
- 1
- Skills in repo
- 17
- Repo updated
- First seen
- Licence
- MIT
At a glance
Full-stack Convex development guidelines covering React, Vite, TypeScript, mutations, auth, design system, and documentation practices.
- Building features
- SKILL.md covers Core principles, Convex best practices, Authentication and React guidelines, plus 4 more sections
- Calls git
- Writing Convex functions
What it does
Dev is an agent skill from waynesutton/markdown-site. Full-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.
Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Frontend & Design, covering Design systems. It works with React, TypeScript, Vite and WorkOS. The repository describes itself as: An open-source publishing framework built for AI agents and developers to ship websites, docs, or blogs. Write markdown, sync from the terminal. Your content is instantly… The licence is MIT.
When your agent uses it
- Building features
- Writing Convex functions
- Making code changes in this project
Example prompts
- “/dev”
Requirements
- Node.js
What it can do on your machine
Read from SKILL.md and the folder at commit 3872c59. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
git
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
docs.convex.devreact.devfrontmatter.codesworkos.comclerk.comvercel.comkeepachangelog.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Dev loads about 854 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 331 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from waynesutton/markdown-site at commit 3872c59, republished under its MIT licence (© waynesutton). 331 words, ~854 tokens.
Download SKILL.mdSave it as
.claude/skills/dev/SKILL.md (or your agent's skills folder).- name
- dev
- description
- Full-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.
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 cookwhen 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
- Follow Convex TypeScript best practices: https://docs.convex.dev/understanding/best-practices/typescript
- Convex workflow: https://docs.convex.dev/understanding/workflow
- Query functions: https://docs.convex.dev/functions/query-functions
- Mutation functions: https://docs.convex.dev/functions/mutation-functions
- Auth functions: https://docs.convex.dev/auth/functions-auth
- File storage: https://docs.convex.dev/file-storage/upload-files
- Vector search: https://docs.convex.dev/search/vector-search
- frontmatter: https://frontmatter.codes/docs
Authentication
- Expert in WorkOS AuthKit: https://workos.com/docs/authkit/vanilla/nodejs
- Convex + WorkOS setup: https://docs.convex.dev/auth/authkit/
- Clerk integration: https://clerk.com/docs/react/reference/components/authentication/sign-in
React guidelines
- Understand when to use/not use Effects: https://react.dev/learn/you-might-not-need-an-effect
- Follow React docs: https://react.dev/learn
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
Code practices
- Add brief comments explaining what sections do
- Respect prettier preferences
- Keep answers brief: show only changed lines with context
- Split long responses into multiple messages
- Never use placeholder text or images (everything syncs with Convex)
- Minimal, focused changes only
Documentation
- Keep
files.mdwith brief file descriptions - Maintain
changelog.mdfollowing https://keepachangelog.com/en/1.0.0/ - Keep
task.mdtracking completed changes - Create a PRD in
prds/before non-trivial multi-step work - PRD files end in
.mdand go inprds/folder - Include UTC timestamps in PRDs and completed task entries
- Run
git log --date=short -n 10before changelog updates so dates match repo history - Do NOT create README, CONTRIBUTING, SUMMARY, or USAGE_GUIDELINES unless explicitly asked
Communication
- Give answers immediately, explain after
- Value good arguments over authorities
- Consider new/contrarian ideas
- High speculation is ok (flag it)
- No moral lectures
- Cite sources at the end, not inline
- No need to mention knowledge cutoff or AI disclosure
© waynesutton, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .claude/dev of waynesutton/markdown-site.
Open the folder on GitHubat commit 3872c59
Compare with similar skills
Dev next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Dev this skillwaynesutton/markdown-site | 628 | — | ~854 | Automated safety check: Pass | MIT | |
| Local Testinglobehub/lobe-ui | 2.2k | — | ~2.1k | Automated safety check: Pass | MIT | |
| Using Docs Kitlobehub/lobe-ui | 2.2k | — | ~2.8k | Automated safety check: Pass | MIT | |
| Redesign My Landingpageinstructa/agent-skills | 139 | — | ~1.8k | Automated safety check: Pass | None | |
| Vite Shadcn Tailwind4IgorWarzocha/Opencode-Workflows | 122 | — | ~1.3k | Automated safety check: Pass | None | |
| Web Artifacts Builderanthropics/skills | 180k | 40 repos | ~769 | Automated safety check: Pass | Apache-2.0 |
Similar skills
Using Docs Kit
lobehub/lobe-ui
Set up and author a documentation site with @lobehub/docs-kit (the lobedocs CLI, React Router + Vite static docs used by ui.lobehub.com).
Redesign My Landingpage
instructa/agent-skills
Build, critique, and iterate high-converting marketing or product landing pages using React + Vite + TypeScript + Tailwind and shadcn/ui components, with all icons sourced from Iconify.
Vite Shadcn Tailwind4
IgorWarzocha/Opencode-Workflows
Initialize shadcn/ui + Tailwind CSS v4 in Vite projects (Vite-specific, not Next.js/Remix).
- Official
Web Artifacts Builder
anthropics/skills
Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.
Creative Tim UI Blocks
creativetimofficial/ui
Helps install, generate and review Creative Tim UI blocks: shadcn/ui-based React and Tailwind sections that follow a restrained, production-minded design philosophy.
More from waynesutton/markdown-site
All 17 skills in this repoConvex Self Hosting
waynesutton/markdown-site
Integrate Convex static self hosting into existing apps using the latest upstream instructions from get-convex/self-hosting every time.
Robel Auth
waynesutton/markdown-site
Integrate and maintain Robelest Convex Auth in apps by always checking upstream before implementation.
Migration Helper
waynesutton/markdown-site
Plan and execute Convex schema migrations safely, including adding fields, creating tables, and data transformations.
Convex Return Validators
waynesutton/markdown-site
Guide for when to use and when not to use return validators in Convex functions.
Convex Doctor
waynesutton/markdown-site
Run convex-doctor static analysis, interpret findings, and fix issues across security, performance, correctness, schema, and architecture categories.
Convex Quickstart
waynesutton/markdown-site
Initialize a new Convex project from scratch or add Convex to an existing app.
Related
Works with
Categories
Questions about Dev
What does Dev do?
Full-stack Convex development guidelines covering React, Vite, TypeScript, mutations, auth, design system, and documentation practices. Dev is an agent skill from waynesutton/markdown-site. Full-stack Convex development guidelines covering React, Vite, TypeScript, mutations, auth, design system, and documentation practices.
When should I use Dev?
Dev fits situations like: building features; writing Convex functions; making code changes in this project.
How do I install Dev in Claude Code?
Run `npx skills add waynesutton/markdown-site --skill dev -a claude-code`. Or copy the skill folder (.claude/dev in waynesutton/markdown-site) into .claude/skills/dev in your project. Claude Code loads it when a task matches its description.
How do I install Dev in Codex?
Run `npx skills add waynesutton/markdown-site --skill dev -a codex`. Or copy the skill folder (.claude/dev in waynesutton/markdown-site) into .agents/skills/dev in your project. Codex loads it when a task matches its description.
Can I use Dev in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add waynesutton/markdown-site --skill dev -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dev, .gemini/skills/dev, .github/skills/dev and .opencode/skills/dev in your project.
What does Dev need to run?
Going by SKILL.md and its folder, Dev needs the command-line tools its instructions call (git). Our summary lists: Node.js.
Does Dev access the network?
SKILL.md names 7 domains. As links in the text: docs.convex.dev, react.dev, frontmatter.codes, workos.com, clerk.com, vercel.com and keepachangelog.com. This is read from the text; nothing was executed.
Is Dev safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Dev use?
Dev is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Dev use?
About 854 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Dev?
Skills that share tags, products or a category with Dev: Local Testing (lobehub/lobe-ui, 2.2k stars), Using Docs Kit (lobehub/lobe-ui, 2.2k stars), Redesign My Landingpage (instructa/agent-skills, 139 stars) and Vite Shadcn Tailwind4 (IgorWarzocha/Opencode-Workflows, 122 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Dev?
waynesutton (a GitHub user) maintains it in waynesutton/markdown-site, which has 628 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on May 20, 2026.
Source: waynesutton/markdown-site on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.