Core Conventions

busirocket-core-conventions

Reusable, project-agnostic conventions designed to keep codebases scalable and easy for AI agents to navigate.

NeverSight/skills_feed·0installs215stars

SKILL.md

Full skill instructions

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 conventions
core-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 utils
core-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)

How to Use

Read individual rule files for detailed explanations and code examples:

rules/core-agent-defaults.md
rules/core-boundaries-decision-tree.md
rules/core-naming-folder-layout.md

Each rule file contains:

Brief explanation of why it matters
Code examples (correct and incorrect patterns)
Additional context and best practices

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/NeverSight/skills_feed --skill busirocket-core-conventions

View on GitHub

data/skills-md/busirocket/agents-skills/busirocket-core-conventions/SKILL.md

ui-ux-design
Create production-grade frontend interfaces with strong UX and visual craft. Use when building web components, pages, dashboards, forms, landing pages, or any UI. Use when user says 'build a form', 'create a dashboard', 'design a component', 'make a landing page', or asks for UI/UX work.
1 installs
presentation-design
Visual design guidance for bold, minimal presentations. Provides layout patterns, typography hierarchy, color specifications, and slide composition rules. Use when asking "how should this slide look?", "design guidance for...", "what layout for this slide?", or when translating content into visua...
1 installs
busirocket-rust-tauri-standards
Strict, reusable standards for Rust/Tauri desktop applications.
1 installs
codex-team
Use when you have 2+ tasks that Codex agents should execute. Runtime-native: Codex sub-agents when available, Codex CLI fallback otherwise. Handles file conflicts via merge/wave strategies. Triggers: "codex team", "spawn codex", "codex agents", "use codex for", "codex fix".
1 installs

More skills from NeverSight

NeverSight/skills_feed

devops-deployer

Comprehensive DevOps and deployment workflow that orchestrates infrastructure automation, CI/CD pipelines, container orchestration, and cloud deployment. Handles everything from infrastructure as code and pipeline setup to monitoring, scaling, and disaster recovery.

215 1

View

NeverSight/skills_feed

avnu

Integrate avnu SDK for Starknet DeFi: token swaps with best-price routing, DCA recurring buys, native staking, gasless transactions via paymaster, and market data. Use when building Starknet trading, DEX aggregation, or DeFi automation features.

215 0

View

NeverSight/skills_feed

post-to-x

发布内容和文章到 X (Twitter)。支持带图片的普通推文和 X Articles（长文）。使用真实的 Chrome 和 CDP 来绕过自动化检测。

215 0

View

NeverSight/skills_feed

ralph-prompt-builder

Master orchestrator for generating Ralph Wiggum-compatible prompts. Analyzes task requirements and routes to appropriate generator (single-task, multi-task, project, or research). Use when you need to create any Ralph loop prompt and want automatic selection of the right generator.

215 0

View

NeverSight/skills_feed

branch-comparison

Use when the user asks to compare branches, analyze git diffs, review changes between branches, update specifications based on code changes, or analyze what changed. Triggers on keywords like "compare branches", "git diff", "what changed", "branch comparison", "code changes", "spec update".

215 0

View

NeverSight/skills_feed

fastapi-development

Build high-performance FastAPI applications with async routes, validation, dependency injection, security, and automatic API documentation. Use when developing modern Python APIs with async support, automatic OpenAPI documentation, and high performance requirements.

215 0

View

NeverSight/skills_feed

zendesk-chat

Enables Claude to manage Zendesk Chat conversations, support tickets, and customer service operations

215 0

View

NeverSight/skills_feed

forge

Mine transcripts for knowledge - decisions, learnings, failures, patterns. Triggers: "forge insights", "mine transcripts", "extract knowledge".

215 0

View

NeverSight/skills_feed

mixpanel

Track product analytics and user behavior with Mixpanel's event-based platform.

215 0

View

NeverSight/skills_feed

ocpp

OCPP protocol reference for EV charging infrastructure development. Covers OCPP 2.0.1 and OCPP 1.6J. Use when working with OCPP messages, charging station code, CSMS/Central System backends, smart charging, transaction handling, or EV charging protocols. Activates on keywords: OCPP, charging stat...

215 0

View

NeverSight/skills_feed

bee-collect

Gather scattered ideas into organized GitHub issues. The bee collects pollen from every flower, checks if the hive already has it, and carefully deposits new work in the comb for later. Never edits code—only organizes the work ahead. Use when creating issues from TODOs or planning work.

215 0

View

NeverSight/skills_feed

vercel-react-native-skills

Comprehensive best practices for React Native and Expo applications. Contains rules across multiple categories covering performance, animations, UI patterns, and platform-specific optimizations.

215 0

View