Worker1245/code-rule-skill

A Claude Code skill with language-agnostic rules for writing, refactoring and reviewing code.
## What it covers
How to work with the user: numbered questions with options, no functions nobody asked for
Six questions for every change: OWASP, YAGNI, reuse, KISS, removability, executor subagent
Project knowledge: design folder, short task cards for agents, git from the start
Structure and architecture: inward-pointing dependencies, one reason to change, and a per-application check whether the four Clean Architecture layers are worth their cost
Tests, including runs in a container (Docker Desktop or a free alternative) and one check command, and simple design
Refactoring, readability and robustness
A security floor for every change, secure coding (OWASP, NIST SSDF) and how to judge security findings
WordPress plugins and themes
Slimming down, speed and data
Executor subagents: when one helps, how to brief it, and how to verify its work
SKILL.md holds what applies to every change. Everything else is in references/ and is read only when its condition applies, which keeps the text loaded per change short.
## Usage
Claude loads the skill on its own before code changes. You can also call it yourself:
Only the skill name, nothing else: If you type just /code-rule-skill in the chat and no task is under way, nothing gets checked or changed yet. You get a short help that says what the skill does and how to use it, and Claude asks what to work on. Your answer starts the work.
With a task, file or folder: /code-rule-skill add a contact form or /code-rule-skill review src/ starts right away.
The skill answers in the language you write in.
## Self-maintenance
The skill maintains itself: when the user corrects a coding mistake or states a lasting rule, Claude proposes the new wording and, after your yes, adds it to the skill, keeps the last three versions locally in versions/ and commits the change. Once a month it proposes a cleanup.
## Install
bash
git clone https://github.com/Worker1245/code-rule-skill.git
ln -s "$PWD/code-rule-skill" ~/.claude/skills/code-rule-skill
Or copy the folder to ~/.claude/skills/code-rule-skill.
## Optional technical safeguards
This skill is text. Claude normally follows it, but it can overlook or misjudge a rule, and nothing forces it to comply. A technical safeguard works like a lock instead of a sign: the software enforces it, whatever Claude decides. None is set up by default. Claude can set up either level on request and agrees on each safeguard with you first.
Basic
Blocked commands and files: Claude Code refuses dangerous commands, such as deleting a database, and does not open files containing passwords.
Secret scan: before each commit, a small program checks whether a password or key would end up in the code, and stops the commit if so.
Full: Basic plus
Sandbox: Claude works in a closed room, so it cannot reach the rest of your computer or send data out freely.