{"id":45185218,"url":"https://github.com/waynesutton/convexskills","last_synced_at":"2026-02-20T10:31:21.192Z","repository":{"id":332865447,"uuid":"1133906703","full_name":"waynesutton/convexskills","owner":"waynesutton","description":"AI agent skills and templates for building production ready apps with Convex. Patterns for queries, mutations, cron jobs, webhooks, migrations, and more.","archived":false,"fork":false,"pushed_at":"2026-02-04T02:40:49.000Z","size":270,"stargazers_count":276,"open_issues_count":3,"forks_count":23,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-04T14:04:33.795Z","etag":null,"topics":["ai","backend","claude","claude-skills","convex","database","skills"],"latest_commit_sha":null,"homepage":"https://docs.convex.dev/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waynesutton.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"agents.md","dco":null,"cla":null}},"created_at":"2026-01-14T01:27:15.000Z","updated_at":"2026-02-04T13:31:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/waynesutton/convexskills","commit_stats":null,"previous_names":["waynesutton/convexskills"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/waynesutton/convexskills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waynesutton%2Fconvexskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waynesutton%2Fconvexskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waynesutton%2Fconvexskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waynesutton%2Fconvexskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waynesutton","download_url":"https://codeload.github.com/waynesutton/convexskills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waynesutton%2Fconvexskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29647894,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T09:27:29.698Z","status":"ssl_error","status_checked_at":"2026-02-20T09:26:12.373Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","backend","claude","claude-skills","convex","database","skills"],"created_at":"2026-02-20T10:31:21.122Z","updated_at":"2026-02-20T10:31:21.185Z","avatar_url":"https://github.com/waynesutton.png","language":"JavaScript","funding_links":[],"categories":["Skills Catalog"],"sub_categories":["Backend (6)"],"readme":"# For official Convex Skills use Convex Agent Plugins\n\nOfficial Convex plugins for AI coding agents, providing development tools for building reactive backends with TypeScript.\n\nhttps://github.com/get-convex/convex-agent-plugins\n\n\n## Convex (unofficial) Skills \n\n[![npm version](https://img.shields.io/npm/v/@waynesutton/convex-skills.svg)](https://www.npmjs.com/package/@waynesutton/convex-skills)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)\n\nA collection of AI-consumable skills for building production-ready applications with [Convex](https://convex.dev), following the Agent Skills open format.\n\n## Overview\n\nThis repository contains skills that help AI assistants understand and implement Convex best practices. Each skill provides structured guidance for specific aspects of Convex development.\n\n## Code Quality\n\nAll skills are designed to produce code that passes @convex-dev/eslint-plugin by default. This creates a complementary workflow:\n\n- **Skills** prevent mistakes at generation time\n- **ESLint** catches anything that slips through at build time\n\nSee the Code Quality section in [convex-best-practices](/skills/convex-best-practices/SKILL.md) for setup instructions.\n\n## Installation\n\n### npm (recommended)\n\n```bash\n# Install globally for CLI access\nnpm install -g @waynesutton/convex-skills\n\n# List available skills\nconvex-skills list\n\n# Install a specific skill to your project\nconvex-skills install convex-best-practices\n\n# Install all skills\nconvex-skills install-all\n\n# Install all skills to .agents/skills\nconvex-skills install-all --target agents\n\n# Symlink SKILL.md files instead of copying\nconvex-skills install-all --target agents --link\n\n# Install templates (CLAUDE.md + skill templates)\nconvex-skills install-templates\n```\n\nOr use npx without installing:\n\n```bash\nnpx @waynesutton/convex-skills list\nnpx @waynesutton/convex-skills install-all\n```\n\n### Programmatic Usage\n\n```bash\nnpm install @waynesutton/convex-skills\n```\n\n```javascript\nimport { listSkills, getSkill, SKILLS } from \"@waynesutton/convex-skills\";\n\n// List all skills\nconsole.log(listSkills());\n\n// Get a specific skill's content\nconst content = getSkill(\"convex-best-practices\");\n```\n\n### Claude Code (from local clone)\n\n```bash\ngit clone https://github.com/waynesutton/convexskills.git\ncd convexskills\n# Point Claude Code to this directory\n```\n\n### Codex\n\nFollow the Codex skills guide and place the skill under `$CODEX_HOME/skills`:\n\n```bash\n# From the repo root\n# Defaults to ~/.codex if CODEX_HOME is unset\ncp -r skills/convex-best-practices \"$CODEX_HOME/skills/\"\n```\n\nCodex will auto-discover `SKILL.md` files in that directory on the next start.\n\nIf you are working from a repo clone, Codex also auto-discovers skills from `.codex/skills` at the repo root. You can symlink this repo’s `skills/*` into `.codex/skills` so updates flow through without copying.\n\n### Standard Agent Skills Path\n\nSome tools are standardizing on `.agents/skills` for discovery. This repo supports that layout via the CLI:\n\n```bash\nconvex-skills install-all --target agents\nconvex-skills install-all --target agents --link\n```\n\n### OpenCode\n\nOpenCode discovers skills from `~/.claude/skills/\u003cname\u003e/SKILL.md` automatically. See OpenCode Skills docs for more details.\n\n#### Slash Command\n\nThis repo includes a `/convex` slash command for OpenCode. Install the command by copying `command/convex.md` to your OpenCode commands directory:\n\n```bash\n# Copy the slash command\ncp command/convex.md ~/.opencode/command/\n\n# Usage in OpenCode\n/convex create a schema with users and posts\n/convex set up file uploads\n/convex add a Stripe webhook endpoint\n```\n\nThe slash command provides decision trees to route to the appropriate skill based on your task.\n\n### Manual Installation\n\nCopy the desired skill's `SKILL.md` file to your project's `.claude/skills/` directory.\n\n## Available Skills\n\n| Skill                                                                    | Description                                           |\n| ------------------------------------------------------------------------ | ----------------------------------------------------- |\n| [convex-best-practices](skills/convex-best-practices/SKILL.md)           | Guidelines for building production-ready Convex apps  |\n| [convex-functions](skills/convex-functions/SKILL.md)                     | Writing queries, mutations, actions, and HTTP actions |\n| [convex-realtime](skills/convex-realtime/SKILL.md)                       | Patterns for building reactive applications           |\n| [convex-schema-validator](skills/convex-schema-validator/SKILL.md)       | Database schema definition and validation             |\n| [convex-file-storage](skills/convex-file-storage/SKILL.md)               | File upload, storage, and serving                     |\n| [convex-agents](skills/convex-agents/SKILL.md)                           | Building AI agents with Convex                        |\n| [convex-cron-jobs](skills/convex-cron-jobs/SKILL.md)                     | Scheduled functions and background tasks              |\n| [convex-http-actions](skills/convex-http-actions/SKILL.md)               | HTTP endpoints and webhook handling                   |\n| [convex-migrations](skills/convex-migrations/SKILL.md)                   | Schema evolution and data migrations                  |\n| [convex-security-check](skills/convex-security-check/SKILL.md)           | Quick security audit checklist                        |\n| [convex-security-audit](skills/convex-security-audit/SKILL.md)           | Deep security review patterns                         |\n| [convex-component-authoring](skills/convex-component-authoring/SKILL.md) | Creating reusable Convex components                   |\n\n## Repository Structure\n\n```\nconvex-skills/\n├── skills/                   # Core Convex skills for AI agents\n│   ├── convex-best-practices/\n│   │   └── SKILL.md\n│   ├── convex-functions/\n│   │   └── SKILL.md\n│   ├── convex-cron-jobs/\n│   │   └── SKILL.md\n│   └── ...\n├── .codex/                   # Codex integration (symlink skills here)\n│   └── README.md             # Codex setup instructions\n├── .agents/                  # Standard agent skills path\n├── command/                  # Slash command definitions (OpenCode)\n│   └── convex.md             # /convex command entrypoint\n├── templates/                # Templates for forking developers\n│   ├── CLAUDE.md             # Project context template\n│   └── skills/               # Claude Code skill templates\n│       ├── dev.md            # Full-stack development practices\n│       ├── help.md           # Problem-solving methodology\n│       └── gitrules.md       # Git safety protocols\n├── .claude/skills/           # Active skills for this repo\n├── prds/                     # Planning documents\n├── AGENTS.md                 # Agent-facing documentation\n├── CLAUDE.md                 # Claude configuration\n├── GEMINI.md                 # Gemini CLI integration\n├── README.md                 # This file\n└── LICENSE                   # Apache-2.0\n```\n\n## Templates for Forking\n\nWhen you fork this repository, you can copy the templates to set up Claude Code skills for your project:\n\n```bash\n# Copy skill templates to your project\ncp -r templates/skills/* .claude/skills/\n\n# Or copy specific skills\ncp templates/skills/dev.md .claude/skills/\ncp templates/skills/help.md .claude/skills/\ncp templates/skills/gitrules.md .claude/skills/\n```\n\n| Template                                                     | Description                                  |\n| ------------------------------------------------------------ | -------------------------------------------- |\n| [templates/CLAUDE.md](templates/CLAUDE.md)                   | Project context template for Convex projects |\n| [templates/skills/dev.md](templates/skills/dev.md)           | Full-stack development practices             |\n| [templates/skills/help.md](templates/skills/help.md)         | Problem-solving methodology                  |\n| [templates/skills/gitrules.md](templates/skills/gitrules.md) | Git safety protocols                         |\n\nSee [templates/skills/README.md](templates/skills/README.md) for detailed installation instructions.\n\n## Skill Format\n\nEach skill follows the Agent Skills specification:\n\n```markdown\n---\nname: Skill Name\ndescription: Brief description\nversion: 1.0.0\nauthor: Convex\ntags: [convex, ...]\n---\n\n# Skill Name\n\n## Documentation Sources\n\n## Instructions\n\n## Examples\n\n## Best Practices\n\n## References\n```\n\n## Usage\n\nSkills are automatically available once installed. The agent will use them when relevant tasks are detected.\n\n**Examples:**\n\n```\nHelp me set up file uploads in Convex\n```\n\n```\nCreate a cron job to clean up expired sessions\n```\n\n```\nAdd a webhook endpoint for Stripe\n```\n\n## Creating New Skills\n\nSkills follow the Agent Skills specification. Each skill requires a `SKILL.md` file with YAML frontmatter.\n\n### Skill Template\n\nCreate a new directory under `skills/`:\n\n```\nskills/my-skill/\n└── SKILL.md\n```\n\n**SKILL.md format:**\n\n```markdown\n---\nname: my-skill\ndescription: A clear description of what this skill does\nversion: 1.0.0\nauthor: Convex\ntags: [convex, relevant-tags]\n---\n\n# My Skill Name\n\n## Documentation Sources\n\nLinks to official documentation\n\n## Instructions\n\nStep-by-step guidance for the agent\n\n## Examples\n\nConcrete examples showing expected code patterns\n\n## Best Practices\n\nSpecific rules to follow\n\n## References\n\nAdditional resources\n```\n\n## AI Integration Files\n\n- `AGENTS.md` - Agent-facing documentation\n- `CLAUDE.md` - Claude configuration for Convex projects\n- `GEMINI.md` - Gemini CLI integration for Convex projects\n\n## License\n\nApache-2.0 License - see [LICENSE](LICENSE) for details.\n\n## References\n\n- [npm Package](https://www.npmjs.com/package/@waynesutton/convex-skills)\n- [Convex Documentation](https://docs.convex.dev/)\n- [Convex LLMs.txt](https://docs.convex.dev/llms.txt)\n- [Agent Skills Specification](https://github.com/anthropics/skills)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaynesutton%2Fconvexskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaynesutton%2Fconvexskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaynesutton%2Fconvexskills/lists"}