claude-rules
Coding standards for AI coding assistants. Auto-detect tech stack, generate project rules. Works with Claude Code, Cursor, Antigravity, GitHub Copilot.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/lifedever--claude-rules)HTML
<a href="/listings/lifedever--claude-rules"><img src="/api/listings/lifedever--claude-rules/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
# Step 1: Add the marketplace claude plugin marketplace add lifedever/claude-rules # Step 2: Install the plugin claude plugin install init-claude-rules@claude-rules # Step 3: Restart Claude Code
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 23 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "claude-rules",
- "owner": {
- "name": "lifedever"
- },
- "metadata": {
- "description": "Coding standards template library for AI coding assistants. Auto-detect tech stack and generate project-specific rules.",
- "version": "1.0.0"
- },
- "plugins": [
- {
- "name": "init-claude-rules",
- "source": "./",
- "description": "Initialize or update CLAUDE.md coding standards for any project by auto-detecting tech stack and assembling rules from the claude-rules template library. Use when user says 'init rules', 'generate CLAUDE.md', or wants to set up coding standards.",
- "version": "1.0.0",
- "author": {
- "name": "lifedever"
- },
- "category": "development",
- "strict": false
- }
- ]
- }
README.md · README · 159 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Claude Rules
- [](LICENSE)
- [](https://github.com/lifedever/claude-rules/stargazers)
- [](https://github.com/lifedever/claude-rules/pulls)
- [](https://lifedever.github.io/claude-rules/)
- English | [中文](README_CN.md)
- Coding standards template library for AI coding assistants. Combine **base + language + framework** layers to generate a project-specific rules file that keeps AI-generated code clean and consistent.
- ## The Problem
- AI coding assistants tend to mimic existing code style in legacy projects — including bad habits. The core principle of this library:
- > **Don't imitate legacy code. Refactor according to the standards.**
- Every rule is a concrete, actionable directive (not vague "use proper XX"), with "Bad / Good" code comparison examples.
- ## Directory Structure
- ```
- claude-rules/
- ├── base/ # Universal (required)
- │ ├── core.md # Core principles: legacy code attitude, quality metrics, naming, architecture
- │ └── git.md # Git commit message conventions
- │
- ├── languages/ # Pick by language
- │ ├── typescript.md # No any/enum/barrel exports, as const, import type
- │ ├── javascript.md # ES2022+, JSDoc type annotations, ESM only
- │ ├── java.md # Java 17+ record/sealed/pattern matching, Optional
- │ ├── kotlin.md # Null safety, structured concurrency, sealed class
- │ ├── swift.md # guard let, async/await, actor, Protocol
- │ ├── python.md # ruff, type annotations, Protocol, uv/poetry
- │ ├── html.md # Semantic tags, accessibility, no div soup
- │ ├── css.md # Custom properties, Flexbox/Grid, BEM, modern features
- │ ├── go.md # Error wrapping, small interfaces, structured concurrency
- │ └── rust.md # Ownership/borrowing, thiserror/anyhow, iterators, Clippy
- │
- └── frameworks/ # Pick by framework
- ├── vue.md # script setup, ref vs reactive, composable patterns
- ├── react.md # Hooks rules, correct useEffect, state layering
- ├── swiftui.md # @Observable (not legacy ObservableObject), SwiftData
- ├── springboot.md # Layered architecture, DTO, global exception handling
- └── tauri.md # Command design, service encapsulation, security config
- ```
- ## Three-Layer Architecture
- ```
- ┌─────────────────────────────────────────────┐
- │ base (required) │ core.md + git.md
- │ Legacy code attitude / Quality metrics / │ Applies to all projects
- │ Naming / Architecture │
- ├─────────────────────────────────────────────┤
- │ language (pick) │ typescript.md / java.md / ...
- │ Type system / Naming conventions / │ Based on project language
- │ Language-specific features │
- ├─────────────────────────────────────────────┤
- │ framework (pick) │ vue.md / react.md / ...
- │ Component standards / State management / │ Based on project framework
- │ Architecture patterns │
- └─────────────────────────────────────────────┘
- ```
- **Rule priority**: framework > language > base (specific rules override general rules)
- ## Usage
- ### Claude Code Plugin (Recommended)
- #### Install
- ```bash
- # Step 1: Add the marketplace
- claude plugin marketplace add lifedever/claude-rules
- # Step 2: Install the plugin
- claude plugin install init-claude-rules@claude-rules
- # Step 3: Restart Claude Code
- ```
- #### Use
- Open any project in Claude Code and run:
- ```
- /init-rules
- ```
- The plugin will:
- 1. Auto-detect your project's tech stack (TypeScript, Vue, React, etc.)
- 2. Ask you to confirm the detected stack
- 3. Read the matching rule files from the plugin
- 4. Generate `CLAUDE.md` in your project root
- #### Update
- When new rules are added upstream, update the local cache:
- ```bash
- claude plugin marketplace update claude-rules
- ```
- Then restart Claude Code. To apply updated rules to a project that already has `CLAUDE.md`, run `/init-rules` again — the plugin will ask before overwriting.
- #### Uninstall
- ```bash
- claude plugin uninstall init-claude-rules@claude-rules
- claude plugin marketplace remove claude-rules
- ```
- ### Manual Usage
- Clone this repo and concatenate the rule files you need:
- ```bash
- git clone https://github.com/lifedever/claude-rules.git
- cd claude-rules
- # Example: Vue 3 + TypeScript project
- cat base/core.md base/git.md languages/typescript.md frameworks/vue.md > /path/to/project/CLAUDE.md
- ```
- The rules are plain Markdown and work with any AI coding tool. Just place the output where your tool expects:
- | Tool | Target File |
- |------|-------------|
- | Claude Code | `CLAUDE.md` |
- | Cursor | `.cursorrules` or `.cursor/rules/*.mdc` |
- | Antigravity | `.antigravity/rules.md` |
- | GitHub Copilot | `.github/copilot-instructions.md` |
- ## Design Principles
- 1. **Actionable** — Every rule is directly executable by AI, no vague wording
- 2. **Exemplified** — Key rules include "Bad" and "Good" code comparisons
- 3. **Quantified** — Functions ≤30 lines, files ≤300 lines, nesting ≤3 levels, parameters ≤4
- 4. **Up-to-date** — Uses modern APIs for each language/framework (@Observable, record, as const, etc.)
- 5. **Not hollow** — Instead of "handle errors properly", specifies exactly how to handle them
- ## Contributing
- PRs for new languages or frameworks are welcome. Please follow these guidelines:
- - Rules must be concrete and actionable — no "use appropriate/proper" phrasing
- - Key rules should include code examples (bad practice + good practice)
- - Recommend modern idioms — don't document outdated APIs
- - Write in English
- ## References
- - [flyeric0212/cursor-rules](https://github.com/flyeric0212/cursor-rules) — Cursor IDE rules template library
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.