# Convex Components Guide

> Use Convex components for encapsulation, reuse, and feature isolation. Use when deciding between local code, helpers, and components.

- Skill: `majiayu000/convex-components-guide` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/convex-components-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/convex-components-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/convex-components-guide

---


# Convex Components Guide

Use this when the task involves reusable backend capabilities or when a feature is growing too monolithic.

## Prefer components for

- feature encapsulation,
- reusable infrastructure-like backend capabilities,
- isolated integrations,
- sibling services such as storage, billing, analytics, notifications, or AI-support utilities.

## Do not overuse components for

- trivial one-off helpers,
- tightly coupled core domain logic that is simpler as local app code.

## Decision rule

- If the capability should be reusable or independently maintained, consider a component.
- If the capability is just a few local helpers, keep it in app code or use `convex-helpers`.

## References

- Read [components-catalog.md](/Users/eduardojaviergarcialopez/AgenticEngineering/agentforge/.agents/skills/convex-components-guide/references/components-catalog.md) for examples and selection guidance.