apuya/react-basics-ui / .claude/skills/version-control
version-control
VerifiedManages branch naming, version tracking, and branch lifecycle. Use when user wants to create, list, rename, or clean up branches, or asks about versioning. Triggers on "branch", "version", "new branch", "create branch", "rename branch", "cleanup branches", "what version", "release".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.1 KB |
| branch-conventions.md | markdown | 3.2 KB |
branch-conventions.md
View on GitHub# Branch Naming Conventions
Full reference for react-basics-ui branch naming standards.
---
## Format
```
<type>/<lowercase-kebab-description>[-vN[.M]]
```
### Type Prefixes
| Prefix | Use when... |
|-------------|--------------------------------------------------|
| `feature/` | Adding new functionality or rebuilding a feature |
| `fix/` | Fixing a bug |
| `chore/` | Tooling, CI, dependencies, config |
| `refactor/` | Restructuring code without changing behavior |
| `release/` | Preparing a versioned release |
| `hotfix/` | Urgent fix for production |
### Description
- **Lowercase kebab-case**: `pricing-profiles`, not `PricingProfiles` or `pricing_profiles`
- **Descriptive**: Name the feature or fix, not the ticket — `feature/date-picker` not `feature/JIRA-123`
- **Concise**: 2-4 words is ideal — `fix/badge-truncation` not `fix/the-bug-where-badge-text-does-not-truncate`
### Version Suffix (feature branches only)
| Scenario | Suffix | Example |
|----------|--------|---------|
| First implementation of a feature | None (implicitly v1) | `feature/data-table` |
| Major rework / rebuild | `-v2`, `-v3`, etc. | `feature/data-table-v2` |
| Minor revision of a version | `-vN.M` | `feature/data-table-v2.1` |
**Rules:**
- Version suffixes only apply to `feature/` branches
- Increment the major version when substantially rebuilding the feature
- Use minor versions for targeted fixes or refinements to an active version branch
- Other types (`fix/`, `chore/`, etc.) never get version suffixes
---
## Base Branch Policy
| Acceptable bases | Notes |
|-----------------|-------|
| `main` | Default — always up to date |
| `dev` / `develop` | Acceptable for integration work |
| Any other branch | Warn — may be outdated or stale |
---
## Examples
### Features with version history
```
feature/table (v1 — implicitly) ✓ merged
feature/table-v2 ✓ merged
feature/table-v2.1 ✓ merged
feature/date-picker (v1 — implicitly) ✓ merged
feature/date-picker-v2 ✓ merged
```
### Features without iterations (single version)
```
feature/autocomplete ✓ merged
feature/file-input ✓ merged
feature/stepper ✓ merged
feature/timeline ✓ merged
feature/tree ✓ merged
```
### Legacy names that don't follow the convention
Some branches predate the convention (`set-up`, `feat-components`). They are
merged and left as-is — the convention applies going forward only.
---
## Quick Reference
```
✓ feature/date-picker
✓ feature/date-picker-v2
✓ feature/date-picker-v2.1
✓ fix/modal-focus-trap
✓ chore/upgrade-tailwind-4
✓ refactor/shared-form-styles
✓ release/v2.0.0
✓ hotfix/dropdown-keyboard-nav
✗ date-picker (missing type prefix)
✗ feature/My-Feature (uppercase)
✗ feature/date-picker_v2 (underscore instead of hyphen)
✗ v2 (bare version — use release/v2.0.0)
✗ fix/badge-v2 (version suffix on non-feature branch)
✗ chore-v3 (missing slash separator)
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |