busirocket/agents-skills/busirocket-core-conventions
Claude Code and agent skill by busirocket/agents-skills
- community
Checking that the SKILL.md file is still in the repository.
Applies general engineering conventions optimized for AI agents. Use when creating or refactoring codebases and you need strict file discipline, clear module boundaries, naming/layout rules, and anti-pattern avoidance.
Install
npx vskill@latest install busirocket/agents-skills/busirocket-core-conventionsSKILL.md
Core Conventions
Reusable, project-agnostic conventions designed to keep codebases scalable and easy for AI agents to navigate.
When to Use
Use this skill when:
- Starting a new feature and deciding where code should live
- Refactoring to improve maintainability
- Enforcing “one-thing-per-file” discipline
- Establishing naming/layout conventions and boundary rules
Non-Negotiables (MUST)
- Keep many small, focused files with explicit boundaries.
- One exported symbol per file for your own modules
(component/hook/function/type).
- No barrel/index files (e.g.
index.ts) that hide dependencies. - No inline types outside
types/. - No helper functions inside components or hooks; extract to
utils/. - Avoid adding new dependencies for trivial helpers unless explicitly approved.
Placement / Boundaries
- Route/pages:
app/** - Reusable UI:
components/<area>/... - Orchestration (state/effects):
hooks/<area>/useXxx.ts - Pure logic:
utils/<area>/xxx.ts - External boundaries (network/DB/auth/storage):
services/<area>/xxx.ts - Shared shapes:
types/<area>/Xxx.ts
Rules
Core Principles
core-agent-defaults- Agent behavior defaults (small changes, ask questions,
avoid dependencies)
core-code-style- Code style guidelines (English-only, pure functions, avoid
nesting)
core-repo-hygiene- Repository hygiene (no barrel files, one responsibility,
thin handlers)
Boundaries & Placement
core-boundaries-decision-tree- Decision tree for where code belongs (app,
components, hooks, utils, services, types)
core-boundaries-hard-rules- Hard rules for boundaries (one export, no
inline types, no helpers in components)
Naming & Layout
core-naming-folder-layout- Folder structure conventionscore-naming-file-naming- File naming conventions (PascalCase, camelCase,
kebab-case)
core-naming-exports- Export conventions (default vs named, Next.js
exceptions)
core-naming-imports- Import conventions (no barrel files, relative vs
aliases)
Services vs Utils
core-services-vs-utils-contract- When to use services/ vs utils/core-services-vs-utils-api- API guidance for services and utilscore-services-vs-utils-route-handlers- Route handler requirements
Anti-Patterns
core-anti-patterns-file-structure- File structure anti-patterns (multiple
exports, barrel files, misc modules)
core-anti-patterns-types- Type anti-patterns (inline types, huge type
files)
core-anti-patterns-react- React anti-patterns (fetching in components,
helpers in components)
core-anti-patterns-app-router- App Router anti-patterns (fat handlers,
unvalidated input)
core-anti-patterns-dependencies- Dependency anti-patterns (trivial helpers)core-anti-patterns-vite-browser- Vite/Browser runtime anti-patterns
(process.env, Node globals)
Related Skills
busirocket-typescript-standards- TypeScript-specific standardsbusirocket-react- React component, hook, and state (Zustand) patternsbusirocket-refactor-workflow- Refactoring workflow
How to Use
Read individual rule files for detailed explanations and code examples:
Each rule file contains:
- Brief explanation of why it matters
- Code examples (correct and incorrect patterns)
- Additional context and best practices
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/busirocket-core-conventions/SKILL.md
Popularity
- Repository stars
- 1
- Repository forks
- 1
- 7-day trend score
- 3
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 24 Mar 2026, 8 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/busirocket/agents-skills/busirocket-core-conventions)